@autocode-cli/autocode 0.1.14 → 0.1.17

package/dist/server/api.js

@@ -3,19 +3,20 @@
  */
 import { join } from 'node:path';
 import { URL } from 'node:url';
-import { listTickets, getTicket, createTicket, updateTicket, addComment, findTicketDir, } from '../core/ticket.js';
+import { listIssues, getIssue, createIssue, updateIssue, addComment, findIssueDir, } from '../core/issue.js';
+import { getChildren, getSubtree, setParent, } from '../core/hierarchy.js';
 import { getColumns, getColumnBySlug } from '../core/column.js';
-import { moveAndProcessTicket, buildPrompt, getActionContent, executeClaudePrompt } from '../services/claude.js';
+import { moveAndProcessIssue, buildPrompt, getActionContent, executeClaudePrompt } from '../services/claude.js';
 import { getStats } from '../services/stats.js';
 import { getWorkflowSummary } from '../core/workflow.js';
-import { getProcessingTickets } from './websocket.js';
+import { getProcessingIssues } from './websocket.js';
 import { getConfig, getTemplatesDir } from '../utils/config.js';
 import { readFileSafe, writeFileSafe, pathExists, getFileMtime, ensureDir } from '../utils/fs.js';
-import { readAttachments } from '../services/ticket-io.js';
+import { readAttachments } from '../services/issue-io.js';
 import { writeFileSync, unlinkSync, readdirSync } from 'node:fs';
 import { loadCatalog, getPromptContent } from '../core/catalog.js';
 import { pipelineExists, loadPipelinesConfig, getActivePipeline, setActivePipeline, createPipeline, deletePipeline, listPipelines, } from '../core/pipeline.js';
-import { previewSync, applySync, hasTransitionTickets, getTransitionTickets, resolveTransitionTickets, } from '../core/sync.js';
+import { previewSync, applySync, hasTransitionIssues, getTransitionIssues, resolveTransitionIssues, } from '../core/sync.js';
 import { executeAutocreate, isClaudeAvailable } from '../services/autocreate.js';
 /**
  * Parse URL parameters from pattern
@@ -146,7 +147,7 @@ async function buildAnalysisPrompt(pipeline, catalog, lang) {
  * Define API routes
  */
 const routes = [
-    // GET /api/status - Get server status including processing tickets
+    // GET /api/status - Get server status including processing issues
     {
         method: 'GET',
         pattern: /^\/api\/status$/,
@@ -154,7 +155,7 @@ const routes = [
             sendJson(res, {
                 success: true,
                 data: {
-                    processingTickets: getProcessingTickets()
+                    processingIssues: getProcessingIssues()
                 }
             });
         },
@@ -173,40 +174,140 @@ const routes = [
                     totals: stats.totals,
                     session: stats.session,
                     history: stats.history.slice(0, 20), // Limit to last 20 calls in API
-                    processingTickets: getProcessingTickets()
+                    processingIssues: getProcessingIssues()
                 }
             });
         },
     },
-    // GET /api/tickets
+    // GET /api/issues
     {
         method: 'GET',
-        pattern: /^\/api\/tickets$/,
+        pattern: /^\/api\/issues$/,
         handler: async (_req, res) => {
             const config = getConfig();
-            const tickets = listTickets(config.root);
+            const issues = listIssues(config.root);
             const columns = getColumns();
-            sendJson(res, { success: true, data: { tickets, columns } });
+            sendJson(res, { success: true, data: { issues, columns } });
         },
     },
-    // GET /api/tickets/:key
+    // GET /api/issues/:key
     {
         method: 'GET',
-        pattern: /^\/api\/tickets\/(AC-\d{6})$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})$/,
         handler: async (_req, res, params) => {
             const config = getConfig();
-            const ticket = getTicket(config.root, params.p0);
-            if (!ticket) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issue = getIssue(config.root, params.p0);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            sendJson(res, { success: true, data: ticket });
+            sendJson(res, { success: true, data: issue });
         },
     },
-    // POST /api/tickets
+    // GET /api/issues/:key/children - Get direct children
+    {
+        method: 'GET',
+        pattern: /^\/api\/issues\/(AC-\d{6})\/children$/,
+        handler: async (_req, res, params) => {
+            const config = getConfig();
+            const issue = getIssue(config.root, params.p0);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
+                return;
+            }
+            const children = getChildren(config.root, params.p0);
+            sendJson(res, { success: true, data: children });
+        },
+    },
+    // GET /api/issues/:key/subtree - Get all descendants
+    {
+        method: 'GET',
+        pattern: /^\/api\/issues\/(AC-\d{6})\/subtree$/,
+        handler: async (_req, res, params) => {
+            const config = getConfig();
+            const issue = getIssue(config.root, params.p0);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
+                return;
+            }
+            const subtree = getSubtree(config.root, params.p0);
+            sendJson(res, { success: true, data: subtree });
+        },
+    },
+    // PATCH /api/issues/:key/parent - Set parent
+    {
+        method: 'PATCH',
+        pattern: /^\/api\/issues\/(AC-\d{6})\/parent$/,
+        handler: async (req, res, params) => {
+            const body = await parseBody(req);
+            const config = getConfig();
+            const issue = getIssue(config.root, params.p0);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
+                return;
+            }
+            const result = setParent(config.root, params.p0, body?.parent_key ?? null);
+            if (!result.success) {
+                sendJson(res, { success: false, error: result.error }, 400);
+                return;
+            }
+            const updated = getIssue(config.root, params.p0);
+            sendJson(res, { success: true, data: updated });
+        },
+    },
+    // POST /api/issues/autocomplete - Generate issue fields using Claude
     {
         method: 'POST',
-        pattern: /^\/api\/tickets$/,
+        pattern: /^\/api\/issues\/autocomplete$/,
+        handler: async (req, res) => {
+            const body = await parseBody(req);
+            if (!body || !body.title || !body.title.trim()) {
+                sendJson(res, { success: false, error: 'Title is required' }, 400);
+                return;
+            }
+            const lang = body.lang || 'fr';
+            const title = body.title.trim();
+            try {
+                const prompt = `Tu es un assistant qui aide à créer des tickets de développement.
+À partir du titre suivant, génère les champs du ticket en JSON.
+
+Titre: "${title}"
+
+Génère un JSON avec:
+- description: Une description détaillée (2-4 phrases) en ${lang === 'fr' ? 'français' : 'anglais'}
+- priority: P0, P1, P2, ou P3 (P2 par défaut pour la plupart des tâches)
+- labels: Un tableau de labels parmi [bug, feature, enhancement, documentation, urgent, refactoring, security, performance, ui, api] (1-3 labels pertinents)
+- acceptance_criteria: Un tableau de 2-5 critères d'acceptation en ${lang === 'fr' ? 'français' : 'anglais'}
+- semver: "patch", "minor", ou "major" selon l'impact
+
+Réponds UNIQUEMENT avec le JSON, sans formatage markdown ni explication.`;
+                const result = executeClaudePrompt(prompt, 60000);
+                if (!result.success) {
+                    sendJson(res, { success: false, error: result.error || 'Claude failed' }, 500);
+                    return;
+                }
+                // Parse the JSON response
+                const output = result.output?.trim() || '';
+                // Remove potential markdown code blocks
+                const jsonStr = output.replace(/^```json?\n?/, '').replace(/\n?```$/, '').trim();
+                try {
+                    const data = JSON.parse(jsonStr);
+                    sendJson(res, { success: true, data });
+                }
+                catch {
+                    sendJson(res, { success: false, error: 'Failed to parse Claude response' }, 500);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Autocomplete failed';
+                sendJson(res, { success: false, error: message }, 500);
+            }
+        },
+    },
+    // POST /api/issues (accepts parent_key for hierarchy)
+    {
+        method: 'POST',
+        pattern: /^\/api\/issues$/,
         handler: async (req, res) => {
             const body = await parseBody(req);
             if (!body || !body.title) {
@@ -214,14 +315,23 @@ const routes = [
                 return;
             }
             const config = getConfig();
-            const ticket = createTicket(config.root, body);
-            sendJson(res, { success: true, data: ticket }, 201);
+            try {
+                const issue = createIssue(config.root, {
+                    ...body,
+                    parent_key: body.parent_key,
+                });
+                sendJson(res, { success: true, data: issue }, 201);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Failed to create issue';
+                sendJson(res, { success: false, error: message }, 400);
+            }
         },
     },
-    // PATCH /api/tickets/:key
+    // PATCH /api/issues/:key
     {
         method: 'PATCH',
-        pattern: /^\/api\/tickets\/(AC-\d{6})$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})$/,
         handler: async (req, res, params) => {
             const body = await parseBody(req);
             if (!body) {
@@ -229,18 +339,18 @@ const routes = [
                 return;
             }
             const config = getConfig();
-            const ticket = updateTicket(config.root, params.p0, body);
-            if (!ticket) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issue = updateIssue(config.root, params.p0, body);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            sendJson(res, { success: true, data: ticket });
+            sendJson(res, { success: true, data: issue });
         },
     },
-    // POST /api/tickets/:key/comments
+    // POST /api/issues/:key/comments
     {
         method: 'POST',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/comments$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/comments$/,
         handler: async (req, res, params) => {
             const body = await parseBody(req);
             if (!body || !body.text) {
@@ -249,25 +359,25 @@ const routes = [
             }
             const config = getConfig();
             const source = body.source === 'claude' ? 'claude' : 'user';
-            const ticket = addComment(config.root, params.p0, body.text, undefined, source);
-            if (!ticket) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issue = addComment(config.root, params.p0, body.text, undefined, source);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            sendJson(res, { success: true, data: ticket });
+            sendJson(res, { success: true, data: issue });
         },
     },
-    // POST /api/tickets/:key/move
+    // POST /api/issues/:key/move
     {
         method: 'POST',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/move$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/move$/,
         handler: async (req, res, params) => {
             const body = await parseBody(req);
             if (!body || !body.column) {
                 sendJson(res, { success: false, error: 'Column is required' }, 400);
                 return;
             }
-            const ticketKey = params.p0;
+            const issueKey = params.p0;
             // Get target column slug
             const targetColumn = getColumnBySlug(body.column);
             if (!targetColumn) {
@@ -275,7 +385,7 @@ const routes = [
                 return;
             }
             // Use new unified flow: move first, then execute action
-            const result = await moveAndProcessTicket(ticketKey, targetColumn.slug, {
+            const result = await moveAndProcessIssue(issueKey, targetColumn.slug, {
                 force: body.force,
                 lang: body.lang,
             });
@@ -285,26 +395,26 @@ const routes = [
             }
             sendJson(res, {
                 success: true,
-                data: result.ticket,
+                data: result.issue,
                 actionExecuted: result.actionExecuted,
             });
         },
     },
-    // POST /api/tickets/:key/next
+    // POST /api/issues/:key/next
     {
         method: 'POST',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/next$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/next$/,
         handler: async (req, res, params) => {
             const config = getConfig();
-            const ticketKey = params.p0;
+            const issueKey = params.p0;
             const body = await parseBody(req);
-            // Get current ticket to find next column
-            const ticket = getTicket(config.root, ticketKey);
-            if (!ticket) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            // Get current issue to find next column
+            const issue = getIssue(config.root, issueKey);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            const currentColumn = getColumnBySlug(ticket.column_slug);
+            const currentColumn = getColumnBySlug(issue.column_slug);
             if (!currentColumn) {
                 sendJson(res, { success: false, error: 'Current column not found' }, 400);
                 return;
@@ -316,28 +426,28 @@ const routes = [
                 return;
             }
             // Use new unified flow: move first, then execute action
-            const result = await moveAndProcessTicket(ticketKey, nextColumn.slug, { lang: body?.lang });
+            const result = await moveAndProcessIssue(issueKey, nextColumn.slug, { lang: body?.lang });
             if (!result.success) {
                 sendJson(res, { success: false, error: result.error }, 400);
                 return;
             }
             sendJson(res, {
                 success: true,
-                data: result.ticket,
+                data: result.issue,
                 actionExecuted: result.actionExecuted,
             });
         },
     },
-    // POST /api/tickets/:key/archive
+    // POST /api/issues/:key/archive
     {
         method: 'POST',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/archive$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/archive$/,
         handler: async (req, res, params) => {
-            const ticketKey = params.p0;
+            const issueKey = params.p0;
             const body = await parseBody(req);
             const columns = getColumns();
             const lastColumn = columns[columns.length - 1];
-            const result = await moveAndProcessTicket(ticketKey, lastColumn.slug, {
+            const result = await moveAndProcessIssue(issueKey, lastColumn.slug, {
                 force: true,
                 lang: body?.lang,
             });
@@ -347,30 +457,30 @@ const routes = [
             }
             sendJson(res, {
                 success: true,
-                data: result.ticket,
+                data: result.issue,
             });
         },
     },
-    // GET /api/tickets/:key/log
+    // GET /api/issues/:key/log
     // Returns all column logs concatenated (since logs are per-column: claude-{columnSlug}.log)
     {
         method: 'GET',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/log$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/log$/,
         handler: async (_req, res, params) => {
             const config = getConfig();
-            const ticketDir = findTicketDir(config.root, params.p0);
-            if (!ticketDir) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issueDir = findIssueDir(config.root, params.p0);
+            if (!issueDir) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
             // Find all claude-*.log files and sort by modification time
             let logFiles = [];
             try {
-                const files = readdirSync(ticketDir);
+                const files = readdirSync(issueDir);
                 logFiles = files
                     .filter(f => f.startsWith('claude-') && f.endsWith('.log'))
                     .map(f => {
-                    const filePath = join(ticketDir, f);
+                    const filePath = join(issueDir, f);
                     const mtime = getFileMtime(filePath);
                     return { path: filePath, mtime: mtime || new Date(0) };
                 })
@@ -408,20 +518,20 @@ const routes = [
             });
         },
     },
-    // GET /api/tickets/:key/log/:columnSlug
+    // GET /api/issues/:key/log/:columnSlug
     {
         method: 'GET',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/log\/([^/]+)$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/log\/([^/]+)$/,
         handler: async (_req, res, params) => {
             const config = getConfig();
-            const ticketKey = params.p0;
+            const issueKey = params.p0;
             const columnSlug = params.p1;
-            const ticketDir = findTicketDir(config.root, ticketKey);
-            if (!ticketDir) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issueDir = findIssueDir(config.root, issueKey);
+            if (!issueDir) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            const logFile = join(ticketDir, `claude-${columnSlug}.log`);
+            const logFile = join(issueDir, `claude-${columnSlug}.log`);
             if (!pathExists(logFile)) {
                 sendJson(res, {
                     success: true,
@@ -436,17 +546,17 @@ const routes = [
             });
         },
     },
-    // GET /api/tickets/:key/prompt/:columnSlug
+    // GET /api/issues/:key/prompt/:columnSlug
     {
         method: 'GET',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/prompt\/([^/]+)$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/prompt\/([^/]+)$/,
         handler: async (_req, res, params) => {
             const config = getConfig();
-            const ticketKey = params.p0;
+            const issueKey = params.p0;
             const columnSlug = params.p1;
-            const ticket = getTicket(config.root, ticketKey);
-            if (!ticket) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issue = getIssue(config.root, issueKey);
+            if (!issue) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
             const column = getColumnBySlug(columnSlug);
@@ -459,8 +569,8 @@ const routes = [
                 sendJson(res, { success: false, error: 'No ACTION file for this column' }, 404);
                 return;
             }
-            const ticketDir = findTicketDir(config.root, ticketKey);
-            const prompt = buildPrompt(ticket, actionContent, ticketDir || undefined, config.lang);
+            const issueDir = findIssueDir(config.root, issueKey);
+            const prompt = buildPrompt(issue, actionContent, issueDir || undefined, config.lang);
             sendJson(res, {
                 success: true,
                 data: {
@@ -471,33 +581,33 @@ const routes = [
             });
         },
     },
-    // GET /api/tickets/:key/attachments
+    // GET /api/issues/:key/attachments
     {
         method: 'GET',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/attachments$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/attachments$/,
         handler: async (_req, res, params) => {
             const config = getConfig();
-            const ticketDir = findTicketDir(config.root, params.p0);
-            if (!ticketDir) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issueDir = findIssueDir(config.root, params.p0);
+            if (!issueDir) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            const attachments = readAttachments(ticketDir);
+            const attachments = readAttachments(issueDir);
             sendJson(res, { success: true, data: attachments });
         },
     },
-    // POST /api/tickets/:key/attachments
+    // POST /api/issues/:key/attachments
     {
         method: 'POST',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/attachments$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/attachments$/,
         handler: async (req, res, params) => {
             const config = getConfig();
-            const ticketDir = findTicketDir(config.root, params.p0);
-            if (!ticketDir) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issueDir = findIssueDir(config.root, params.p0);
+            if (!issueDir) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
-            const attachmentsDir = join(ticketDir, 'attachments');
+            const attachmentsDir = join(issueDir, 'attachments');
             ensureDir(attachmentsDir);
             try {
                 const files = await parseMultipartBody(req);
@@ -521,19 +631,19 @@ const routes = [
             }
         },
     },
-    // DELETE /api/tickets/:key/attachments/:filename
+    // DELETE /api/issues/:key/attachments/:filename
     {
         method: 'DELETE',
-        pattern: /^\/api\/tickets\/(AC-\d{6})\/attachments\/([^/]+)$/,
+        pattern: /^\/api\/issues\/(AC-\d{6})\/attachments\/([^/]+)$/,
         handler: async (_req, res, params) => {
             const config = getConfig();
-            const ticketDir = findTicketDir(config.root, params.p0);
-            if (!ticketDir) {
-                sendJson(res, { success: false, error: 'Ticket not found' }, 404);
+            const issueDir = findIssueDir(config.root, params.p0);
+            if (!issueDir) {
+                sendJson(res, { success: false, error: 'Issue not found' }, 404);
                 return;
             }
             const filename = decodeURIComponent(params.p1);
-            const filePath = join(ticketDir, 'attachments', filename);
+            const filePath = join(issueDir, 'attachments', filename);
             if (!pathExists(filePath)) {
                 sendJson(res, { success: false, error: 'File not found' }, 404);
                 return;
@@ -637,8 +747,8 @@ const routes = [
         pattern: /^\/api\/summary$/,
         handler: async (_req, res) => {
             const config = getConfig();
-            const tickets = listTickets(config.root);
-            const summary = getWorkflowSummary(tickets);
+            const issues = listIssues(config.root);
+            const summary = getWorkflowSummary(issues);
             sendJson(res, { success: true, data: summary });
         },
     },
@@ -722,10 +832,10 @@ Generate EXACTLY this format for EACH language, nothing else:
 2. [action 2]
 ...
 8. If out of scope work detected: \`autocode new "<title>" "<description>" --priority P2 --labels "<labels>" --acceptance "<criteria>" --semver patch --column backlog\`
-9. Document: \`autocode comment <ticket-key> "[summary]"\`
-10. Advance: \`autocode next <ticket-key>\`
+9. Document: \`autocode comment <issue-key> "[summary]"\`
+10. Advance: \`autocode next <issue-key>\`
 
-> Or return: \`autocode move <ticket-key> <target-column-slug>\`
+> Or return: \`autocode move <issue-key> <target-column-slug>\`
 
 ## Validation Criteria
 
@@ -1037,26 +1147,26 @@ IMPORTANT: Output ONLY the two prompts separated by ===EN=== and ===FR===, nothi
             sendJson(res, { success: true, data: result });
         },
     },
-    // GET /api/transition - Get tickets in transition
+    // GET /api/transition - Get issues in transition
     {
         method: 'GET',
         pattern: /^\/api\/transition$/,
         handler: async (_req, res) => {
             const config = getConfig();
-            const tickets = getTransitionTickets(config.root);
-            sendJson(res, { success: true, data: tickets });
+            const issues = getTransitionIssues(config.root);
+            sendJson(res, { success: true, data: issues });
         },
     },
-    // GET /api/transition/has - Check if there are transition tickets
+    // GET /api/transition/has - Check if there are transition issues
     {
         method: 'GET',
         pattern: /^\/api\/transition\/has$/,
         handler: async (_req, res) => {
             const config = getConfig();
-            sendJson(res, { success: true, data: { hasTransition: hasTransitionTickets(config.root) } });
+            sendJson(res, { success: true, data: { hasTransition: hasTransitionIssues(config.root) } });
         },
     },
-    // POST /api/transition/resolve - Resolve transition tickets
+    // POST /api/transition/resolve - Resolve transition issues
     {
         method: 'POST',
         pattern: /^\/api\/transition\/resolve$/,
@@ -1067,7 +1177,7 @@ IMPORTANT: Output ONLY the two prompts separated by ===EN=== and ===FR===, nothi
                 return;
             }
             const config = getConfig();
-            const result = resolveTransitionTickets(config.root, body.actions);
+            const result = resolveTransitionIssues(config.root, body.actions);
             sendJson(res, { success: true, data: result });
         },
     },