fraim-framework 2.0.27 → 2.0.30

package/dist/registry/scripts/generic-issues-api.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * FRAIM Generic Issues API
+ *
+ * Generic issue filing endpoint that works for any project.
+ * Can be invoked through ChatGPT OpenAPI or MCP.
+ *
+ * Usage:
+ * 1. Import this file
+ * 2. Mount the router in your Express app
+ * 3. Configure GitHub repository in .fraim/config.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.issuesRouter = void 0;
+const express_1 = require("express");
+const issues_js_1 = require("../../src/fraim/issues.js");
+const config_loader_js_1 = require("../../src/fraim/config-loader.js");
+const issuesRouter = (0, express_1.Router)();
+exports.issuesRouter = issuesRouter;
+/**
+ * POST /issues/create - Create a GitHub issue
+ *
+ * Generic endpoint that works for any FRAIM project.
+ * Repository owner and name are read from .fraim/config.json
+ */
+issuesRouter.post('/create', async (req, res) => {
+    try {
+        // Load project configuration
+        const config = (0, config_loader_js_1.loadFraimConfig)();
+        const repoOwner = config.git?.repoOwner || process.env.GITHUB_OWNER || 'your-org';
+        const repoName = config.git?.repoName || process.env.GITHUB_REPO || 'your-repo';
+        // Get user context (if available - project-specific)
+        // Projects can customize this based on their auth system
+        const userId = req.userContext?.userId ||
+            req.executiveContext?.executiveId ||
+            req.headers['x-user-id'];
+        const userEmail = req.userContext?.email ||
+            req.executiveContext?.executiveEmail ||
+            req.headers['x-user-email'];
+        const userName = req.userContext?.name ||
+            req.executiveContext?.executiveName ||
+            req.headers['x-user-name'];
+        const { title, body, labels } = req.body;
+        if (!title || !body) {
+            return res.status(400).json({
+                success: false,
+                error: 'Missing required fields: title, body'
+            });
+        }
+        // Check if GitHub token is configured
+        if (!process.env.GITHUB_TOKEN && !process.env.GIT_TOKEN && !process.env.GITHUB_PAT) {
+            return res.status(500).json({
+                success: false,
+                error: 'GitHub integration not configured. Please set GITHUB_TOKEN environment variable.'
+            });
+        }
+        // Build issue body with user context (if available)
+        let issueBody = body;
+        if (userName || userEmail || userId) {
+            issueBody = `**Reported by:** ${userName || 'Unknown'}${userEmail ? ` (${userEmail})` : ''}${userId ? `\n**User ID:** ${userId}` : ''}\n\n**Issue Details:**\n${body}\n\n---\n*This issue was automatically created through the API.*`;
+        }
+        // Create the issue using shared function
+        const result = await (0, issues_js_1.fileFraimIssue)({
+            title: title,
+            body: issueBody,
+            labels: labels || ['user-reported']
+        });
+        if (!result.success) {
+            return res.status(500).json({
+                success: false,
+                error: result.message
+            });
+        }
+        return res.json({
+            success: true,
+            message: 'Issue created successfully',
+            issueNumber: result.issueNumber,
+            issueUrl: result.htmlUrl,
+            title: title
+        });
+    }
+    catch (error) {
+        console.error('❌ Unexpected error creating Git issue:', error);
+        return res.status(500).json({
+            success: false,
+            error: error.message || 'Failed to create Git issue'
+        });
+    }
+});
+/**
+ * GET /issues/list - List issues
+ *
+ * Not implemented in this generic version.
+ */
+issuesRouter.get('/list', async (req, res) => {
+    return res.status(501).json({
+        success: false,
+        error: 'Listing issues is not supported in this generic API version yet.'
+    });
+});