@sudocode-ai/local-server 0.1.0 → 0.1.1

package/dist/routes/executions-stream.js

@@ -0,0 +1,55 @@
+/**
+ * Execution Stream Routes
+ *
+ * SSE endpoint for streaming execution events to clients.
+ * Integrates with TransportManager to broadcast AG-UI events.
+ *
+ * @module routes/executions-stream
+ */
+import { Router } from "express";
+import { randomUUID } from "crypto";
+/**
+ * Create execution stream routes
+ *
+ * @param transportManager - Transport manager for SSE connections
+ * @returns Express router with SSE endpoints
+ *
+ * @example
+ * ```typescript
+ * const router = createExecutionStreamRoutes(transportManager);
+ * app.use('/api/executions', router);
+ * ```
+ */
+export function createExecutionStreamRoutes(transportManager) {
+    const router = Router();
+    /**
+     * SSE endpoint for execution event stream
+     *
+     * GET /api/executions/:executionId/stream
+     *
+     * Establishes SSE connection and streams execution events to client.
+     * Events are filtered to only include events for the specified execution.
+     *
+     * @param executionId - Execution ID to stream events for
+     */
+    router.get("/:executionId/stream", (req, res) => {
+        const { executionId } = req.params;
+        // TODO: Add authentication/authorization check
+        // Verify user has permission to access this execution
+        // Generate unique client ID
+        const clientId = randomUUID();
+        // Get buffered events for replay
+        const bufferedEvents = transportManager.getBufferedEvents(executionId);
+        const replayEvents = bufferedEvents.map((buffered) => ({
+            event: buffered.event.type,
+            data: buffered.event,
+        }));
+        // Establish SSE connection through transport manager
+        // This will set appropriate headers, send connection acknowledgment, and replay buffered events
+        transportManager
+            .getSseTransport()
+            .handleConnection(clientId, res, executionId, replayEvents);
+    });
+    return router;
+}
+//# sourceMappingURL=executions-stream.js.map

package/dist/routes/executions-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executions-stream.js","sourceRoot":"","sources":["../../src/routes/executions-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CACzC,gBAAkC;IAElC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACjE,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;QAEnC,+CAA+C;QAC/C,sDAAsD;QAEtD,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;QAE9B,iCAAiC;QACjC,MAAM,cAAc,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACvE,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrD,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI;YAC1B,IAAI,EAAE,QAAQ,CAAC,KAAK;SACrB,CAAC,CAAC,CAAC;QAEJ,qDAAqD;QACrD,gGAAgG;QAChG,gBAAgB;aACb,eAAe,EAAE;aACjB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/routes/executions.js

@@ -0,0 +1,267 @@
+/**
+ * Executions API routes (mapped to /api)
+ *
+ * Provides REST API for managing issue executions.
+ */
+import { Router } from "express";
+import { ExecutionService } from "../services/execution-service.js";
+/**
+ * Create executions router
+ *
+ * @param db - Database instance
+ * @param repoPath - Path to git repository
+ * @param transportManager - Optional transport manager for SSE streaming
+ * @returns Express router with execution endpoints
+ */
+export function createExecutionsRouter(db, repoPath, transportManager, executionService) {
+    const router = Router();
+    const service = executionService ||
+        new ExecutionService(db, repoPath, undefined, transportManager);
+    /**
+     * POST /api/issues/:issueId/executions/prepare
+     *
+     * Prepare an execution - render template and show preview
+     */
+    router.post("/issues/:issueId/executions/prepare", async (req, res) => {
+        try {
+            const { issueId } = req.params;
+            const options = req.body || {};
+            const result = await service.prepareExecution(issueId, options);
+            res.json({
+                success: true,
+                data: result,
+            });
+        }
+        catch (error) {
+            console.error("[API Route] ERROR: Failed to prepare execution:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to prepare execution",
+            });
+        }
+    });
+    /**
+     * POST /api/issues/:issueId/executions
+     *
+     * Create and start a new execution
+     */
+    router.post("/issues/:issueId/executions", async (req, res) => {
+        try {
+            const { issueId } = req.params;
+            const { config, prompt } = req.body;
+            // Validate required fields
+            if (!prompt) {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "Prompt is required",
+                });
+                return;
+            }
+            const execution = await service.createExecution(issueId, config || {}, prompt);
+            res.status(201).json({
+                success: true,
+                data: execution,
+            });
+        }
+        catch (error) {
+            console.error("[API Route] ERROR: Failed to create execution:", error);
+            // Handle specific error cases
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const statusCode = errorMessage.includes("not found") ? 404 : 500;
+            res.status(statusCode).json({
+                success: false,
+                data: null,
+                error_data: errorMessage,
+                message: "Failed to create execution",
+            });
+        }
+    });
+    /**
+     * GET /api/executions/:executionId
+     *
+     * Get a specific execution by ID
+     */
+    router.get("/executions/:executionId", (req, res) => {
+        try {
+            const { executionId } = req.params;
+            const execution = service.getExecution(executionId);
+            if (!execution) {
+                res.status(404).json({
+                    success: false,
+                    data: null,
+                    message: `Execution not found: ${executionId}`,
+                });
+                return;
+            }
+            res.json({
+                success: true,
+                data: execution,
+            });
+        }
+        catch (error) {
+            console.error("Error getting execution:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to get execution",
+            });
+        }
+    });
+    /**
+     * GET /api/issues/:issueId/executions
+     *
+     * List all executions for an issue
+     */
+    router.get("/issues/:issueId/executions", (req, res) => {
+        try {
+            const { issueId } = req.params;
+            const executions = service.listExecutions(issueId);
+            res.json({
+                success: true,
+                data: executions,
+            });
+        }
+        catch (error) {
+            console.error("Error listing executions:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to list executions",
+            });
+        }
+    });
+    /**
+     * POST /api/executions/:executionId/follow-up
+     *
+     * Create a follow-up execution that reuses the parent's worktree
+     */
+    router.post("/executions/:executionId/follow-up", async (req, res) => {
+        try {
+            const { executionId } = req.params;
+            const { feedback } = req.body;
+            // Validate required fields
+            if (!feedback) {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "Feedback is required",
+                });
+                return;
+            }
+            const followUpExecution = await service.createFollowUp(executionId, feedback);
+            res.status(201).json({
+                success: true,
+                data: followUpExecution,
+            });
+        }
+        catch (error) {
+            console.error("Error creating follow-up execution:", error);
+            // Handle specific error cases
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const statusCode = errorMessage.includes("not found") ||
+                errorMessage.includes("no worktree")
+                ? 404
+                : 500;
+            res.status(statusCode).json({
+                success: false,
+                data: null,
+                error_data: errorMessage,
+                message: "Failed to create follow-up execution",
+            });
+        }
+    });
+    /**
+     * DELETE /api/executions/:executionId
+     *
+     * Cancel a running execution
+     */
+    router.delete("/executions/:executionId", async (req, res) => {
+        try {
+            const { executionId } = req.params;
+            await service.cancelExecution(executionId);
+            res.json({
+                success: true,
+                data: { executionId },
+                message: "Execution cancelled successfully",
+            });
+        }
+        catch (error) {
+            console.error("Error cancelling execution:", error);
+            // Handle specific error cases
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const statusCode = errorMessage.includes("not found") ? 404 : 500;
+            res.status(statusCode).json({
+                success: false,
+                data: null,
+                error_data: errorMessage,
+                message: "Failed to cancel execution",
+            });
+        }
+    });
+    /**
+     * GET /api/executions/:executionId/worktree
+     *
+     * Check if worktree exists for an execution
+     */
+    router.get("/executions/:executionId/worktree", async (req, res) => {
+        try {
+            const { executionId } = req.params;
+            const exists = await service.worktreeExists(executionId);
+            res.json({
+                success: true,
+                data: { exists },
+            });
+        }
+        catch (error) {
+            console.error("Error checking worktree:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to check worktree status",
+            });
+        }
+    });
+    /**
+     * DELETE /api/executions/:executionId/worktree
+     *
+     * Delete the worktree for an execution
+     */
+    router.delete("/executions/:executionId/worktree", async (req, res) => {
+        try {
+            const { executionId } = req.params;
+            await service.deleteWorktree(executionId);
+            res.json({
+                success: true,
+                data: { executionId },
+                message: "Worktree deleted successfully",
+            });
+        }
+        catch (error) {
+            console.error("Error deleting worktree:", error);
+            // Handle specific error cases
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            let statusCode = 500;
+            if (errorMessage.includes("not found")) {
+                statusCode = 404;
+            }
+            else if (errorMessage.includes("has no worktree") ||
+                errorMessage.includes("Cannot delete worktree")) {
+                statusCode = 400;
+            }
+            res.status(statusCode).json({
+                success: false,
+                data: null,
+                error_data: errorMessage,
+                message: "Failed to delete worktree",
+            });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=executions.js.map

package/dist/routes/executions.js.map

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

package/dist/routes/feedback.js

@@ -0,0 +1,329 @@
+/**
+ * Feedback API routes (mapped to /api/feedback)
+ */
+import { Router } from "express";
+import { createNewFeedback, getFeedbackById, updateExistingFeedback, deleteExistingFeedback, getAllFeedback, } from "../services/feedback.js";
+import { broadcastFeedbackUpdate } from "../services/websocket.js";
+export function createFeedbackRouter(db) {
+    const router = Router();
+    /**
+     * GET /api/feedback - List all feedback with optional filters
+     * Query params: spec_id, issue_id, feedback_type, dismissed, limit, offset
+     */
+    router.get("/", (req, res) => {
+        try {
+            const options = {};
+            if (req.query.spec_id) {
+                options.spec_id = req.query.spec_id;
+            }
+            if (req.query.issue_id) {
+                options.issue_id = req.query.issue_id;
+            }
+            if (req.query.feedback_type) {
+                options.feedback_type = req.query.feedback_type;
+            }
+            if (req.query.dismissed !== undefined) {
+                options.dismissed = req.query.dismissed === "true";
+            }
+            if (req.query.limit) {
+                options.limit = parseInt(req.query.limit, 10);
+            }
+            if (req.query.offset) {
+                options.offset = parseInt(req.query.offset, 10);
+            }
+            const feedback = getAllFeedback(db, options);
+            res.json({
+                success: true,
+                data: feedback,
+            });
+        }
+        catch (error) {
+            console.error("Error listing feedback:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to list feedback",
+            });
+        }
+    });
+    /**
+     * GET /api/feedback/:id - Get a specific feedback entry
+     */
+    router.get("/:id", (req, res) => {
+        try {
+            const { id } = req.params;
+            const feedback = getFeedbackById(db, id);
+            if (!feedback) {
+                res.status(404).json({
+                    success: false,
+                    data: null,
+                    message: `Feedback not found: ${id}`,
+                });
+                return;
+            }
+            res.json({
+                success: true,
+                data: feedback,
+            });
+        }
+        catch (error) {
+            console.error("Error getting feedback:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to get feedback",
+            });
+        }
+    });
+    /**
+     * POST /api/feedback - Create a new feedback entry
+     */
+    router.post("/", (req, res) => {
+        try {
+            const { issue_id, spec_id, feedback_type, content, agent, anchor, dismissed, } = req.body;
+            // Validate required fields
+            if (!issue_id || typeof issue_id !== "string") {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "issue_id is required and must be a string",
+                });
+                return;
+            }
+            if (!spec_id || typeof spec_id !== "string") {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "spec_id is required and must be a string",
+                });
+                return;
+            }
+            if (!feedback_type || typeof feedback_type !== "string") {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "feedback_type is required and must be a string",
+                });
+                return;
+            }
+            // Validate feedback_type
+            const validTypes = ["comment", "suggestion", "request"];
+            if (!validTypes.includes(feedback_type)) {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: `Invalid feedback_type. Must be one of: ${validTypes.join(", ")}`,
+                });
+                return;
+            }
+            if (!content || typeof content !== "string") {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "content is required and must be a string",
+                });
+                return;
+            }
+            // Validate anchor if provided
+            if (anchor !== undefined && anchor !== null) {
+                if (typeof anchor !== "object") {
+                    res.status(400).json({
+                        success: false,
+                        data: null,
+                        message: "anchor must be an object if provided",
+                    });
+                    return;
+                }
+                // Validate anchor structure if provided
+                if (anchor.anchor_status) {
+                    const validAnchorStatuses = ["valid", "relocated", "stale"];
+                    if (!validAnchorStatuses.includes(anchor.anchor_status)) {
+                        res.status(400).json({
+                            success: false,
+                            data: null,
+                            message: `Invalid anchor.anchor_status. Must be one of: ${validAnchorStatuses.join(", ")}`,
+                        });
+                        return;
+                    }
+                }
+            }
+            // Create feedback using CLI operation
+            const feedback = createNewFeedback(db, {
+                issue_id,
+                spec_id,
+                feedback_type: feedback_type,
+                content,
+                agent: agent || undefined,
+                anchor: anchor,
+                dismissed: dismissed || false,
+            });
+            // Broadcast feedback creation to WebSocket clients
+            broadcastFeedbackUpdate("created", feedback);
+            res.status(201).json({
+                success: true,
+                data: feedback,
+            });
+        }
+        catch (error) {
+            console.error("Error creating feedback:", error);
+            // Handle specific errors
+            if (error instanceof Error) {
+                if (error.message.includes("not found")) {
+                    res.status(404).json({
+                        success: false,
+                        data: null,
+                        message: error.message,
+                    });
+                    return;
+                }
+                if (error.message.includes("Constraint violation")) {
+                    res.status(409).json({
+                        success: false,
+                        data: null,
+                        message: error.message,
+                    });
+                    return;
+                }
+            }
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to create feedback",
+            });
+        }
+    });
+    /**
+     * PUT /api/feedback/:id - Update an existing feedback entry
+     */
+    router.put("/:id", (req, res) => {
+        try {
+            const { id } = req.params;
+            const { content, dismissed, anchor } = req.body;
+            // Validate that at least one field is provided
+            if (content === undefined &&
+                dismissed === undefined &&
+                anchor === undefined) {
+                res.status(400).json({
+                    success: false,
+                    data: null,
+                    message: "At least one field must be provided for update",
+                });
+                return;
+            }
+            // Validate anchor if provided
+            if (anchor !== undefined) {
+                if (typeof anchor !== "object") {
+                    res.status(400).json({
+                        success: false,
+                        data: null,
+                        message: "anchor must be an object",
+                    });
+                    return;
+                }
+                if (!anchor.anchor_status || typeof anchor.anchor_status !== "string") {
+                    res.status(400).json({
+                        success: false,
+                        data: null,
+                        message: "anchor.anchor_status is required and must be a string",
+                    });
+                    return;
+                }
+                const validAnchorStatuses = ["valid", "relocated", "stale"];
+                if (!validAnchorStatuses.includes(anchor.anchor_status)) {
+                    res.status(400).json({
+                        success: false,
+                        data: null,
+                        message: `Invalid anchor.anchor_status. Must be one of: ${validAnchorStatuses.join(", ")}`,
+                    });
+                    return;
+                }
+            }
+            // Build update input
+            const updateInput = {};
+            if (content !== undefined)
+                updateInput.content = content;
+            if (dismissed !== undefined)
+                updateInput.dismissed = dismissed;
+            if (anchor !== undefined)
+                updateInput.anchor = anchor;
+            // Update feedback using CLI operation
+            const feedback = updateExistingFeedback(db, id, updateInput);
+            // Broadcast feedback update to WebSocket clients
+            broadcastFeedbackUpdate("updated", feedback);
+            res.json({
+                success: true,
+                data: feedback,
+            });
+        }
+        catch (error) {
+            console.error("Error updating feedback:", error);
+            // Handle "not found" errors
+            if (error instanceof Error && error.message.includes("not found")) {
+                res.status(404).json({
+                    success: false,
+                    data: null,
+                    message: error.message,
+                });
+                return;
+            }
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to update feedback",
+            });
+        }
+    });
+    /**
+     * DELETE /api/feedback/:id - Delete a feedback entry
+     */
+    router.delete("/:id", (req, res) => {
+        try {
+            const { id } = req.params;
+            // Check if feedback exists first
+            const existingFeedback = getFeedbackById(db, id);
+            if (!existingFeedback) {
+                res.status(404).json({
+                    success: false,
+                    data: null,
+                    message: `Feedback not found: ${id}`,
+                });
+                return;
+            }
+            // Delete feedback using CLI operation
+            const deleted = deleteExistingFeedback(db, id);
+            if (deleted) {
+                // Broadcast feedback deletion to WebSocket clients
+                broadcastFeedbackUpdate("deleted", { id });
+                res.json({
+                    success: true,
+                    data: {
+                        id,
+                        deleted: true,
+                    },
+                });
+            }
+            else {
+                res.status(500).json({
+                    success: false,
+                    data: null,
+                    message: "Failed to delete feedback",
+                });
+            }
+        }
+        catch (error) {
+            console.error("Error deleting feedback:", error);
+            res.status(500).json({
+                success: false,
+                data: null,
+                error_data: error instanceof Error ? error.message : String(error),
+                message: "Failed to delete feedback",
+            });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=feedback.js.map