@relipa/ai-flow-kit 0.2.0-beta.1 → 0.2.0

package/scripts/ticket-writer.js

@@ -24,7 +24,9 @@ const {
   fetchBacklogIssueTypes,
   fetchBacklogPriorities,
   createBacklogIssue,
+  getBacklogIssue,
   createJiraIssue,
+  getJiraIssue,
 } = linkResolver;
 
 // Only these keys can be written via `ak credentials set` — dedicated adapter credentials
@@ -104,13 +106,23 @@ async function pickBacklogDefaults(domain, apiKeyRead, projectId) {
  *   "target": "backlog" | "jira",
  *   "projectId": "12345",     // optional — Backlog only, overrides BACKLOG_DEFAULT_PROJECT_ID
  *   "projectKey": "PROJ",     // optional — Jira only, overrides JIRA_DEFAULT_PROJECT_KEY
+ *   "parentTicket": {         // optional — ingest-data SKILL.md § 5.6b "Ticket cha"
+ *     "mode": "create" | "existing" | "none",
+ *     "title": "...",         // required when mode === "create"
+ *     "description": "...",  // optional when mode === "create"
+ *     "existingId": "..."    // required when mode === "existing" (Backlog key/id or Jira key)
+ *   },
  *   "tasks": [
- *     { "type": "spec|coding|test|other", "title": "...", "description": "..." }
+ *     { "type": "spec|system-requirement|impact-analysis|coding|test|execute-test|other", "title": "...", "description": "..." }
  *   ]
  * }
  *
  * `description` is expected to already be fully composed by the AI per the ticket template in
  * PM Workflow_v1.0.md §6.1 (Nội dung task + Nguồn tham chiếu) — this command posts it as-is.
+ *
+ * When `parentTicket.mode` is "create" or "existing", every task in `tasks` is created as a
+ * child of that parent (Backlog `parentIssueId` / Jira `parent`) — see link-resolver.js for the
+ * caveat that this depends on the target project supporting issue hierarchy/subtasks.
  */
 async function createTicketsCommand(inputFile, options = {}) {
   const emit = (obj) => {
@@ -119,6 +131,7 @@ async function createTicketsCommand(inputFile, options = {}) {
       console.log(chalk.red(`✗ ${obj.message || obj.error}`));
     } else {
       console.log(chalk.green(`✓ ${obj.results.filter(r => r.ok).length}/${obj.results.length} ticket(s) created on ${obj.target}.`));
+      if (obj.parent) console.log(`  ${chalk.cyan('↳ parent:')} ${obj.parent.ticketId}  ${chalk.gray(obj.parent.url)}`);
       for (const r of obj.results) {
         console.log(r.ok ? `  ${chalk.green('✓')} ${r.ticketId}  ${chalk.gray(r.title)}` : `  ${chalk.red('✗')} ${chalk.gray(r.title)} — ${r.error}`);
       }
@@ -173,6 +186,34 @@ async function createTicketsCommand(inputFile, options = {}) {
       return;
     }
 
+    const parentTicket = input.parentTicket || { mode: 'none' };
+    let parentRef = null;
+    if (parentTicket.mode === 'create') {
+      try {
+        const createdParent = await createBacklogIssue(write.domain, write.apiKeyWrite, {
+          projectId,
+          summary: parentTicket.title,
+          description: parentTicket.description || '',
+          issueTypeId: defaults.defaultIssueTypeId,
+          priorityId: defaults.defaultPriorityId,
+        });
+        parentRef = { ticketId: createdParent.ticketId, internalId: createdParent.internalId, url: createdParent.url };
+      } catch (err) {
+        emit({ ok: false, error: 'parent-create-failed', message: `Không tạo được ticket cha trên Backlog: ${err.message}` });
+        process.exitCode = 1;
+        return;
+      }
+    } else if (parentTicket.mode === 'existing') {
+      try {
+        const existing = await getBacklogIssue(write.domain, write.apiKeyRead, parentTicket.existingId);
+        parentRef = { ticketId: existing.issueKey, internalId: existing.id, url: `https://${write.domain}/view/${existing.issueKey}` };
+      } catch (err) {
+        emit({ ok: false, error: 'parent-not-found', message: `Không tìm thấy ticket cha "${parentTicket.existingId}" trên Backlog: ${err.message}` });
+        process.exitCode = 1;
+        return;
+      }
+    }
+
     const results = [];
     for (const task of tasks) {
       try {
@@ -182,13 +223,14 @@ async function createTicketsCommand(inputFile, options = {}) {
           description: task.description,
           issueTypeId: task.issueTypeId || defaults.defaultIssueTypeId,
           priorityId: task.priorityId || defaults.defaultPriorityId,
+          parentIssueId: parentRef ? parentRef.internalId : undefined,
         });
         results.push({ type: task.type, title: task.title, ok: true, ticketId: created.ticketId, url: created.url });
       } catch (err) {
         results.push({ type: task.type, title: task.title, ok: false, error: err.message });
       }
     }
-    emit({ ok: true, target, projectId, results });
+    emit({ ok: true, target, projectId, parent: parentRef, results });
     return;
   }
 
@@ -206,6 +248,32 @@ async function createTicketsCommand(inputFile, options = {}) {
     return;
   }
 
+  const parentTicket = input.parentTicket || { mode: 'none' };
+  let parentRef = null;
+  if (parentTicket.mode === 'create') {
+    try {
+      const createdParent = await createJiraIssue(write.domain, write.emailWrite, write.apiTokenWrite, {
+        projectKey,
+        summary: parentTicket.title,
+        description: parentTicket.description || '',
+      });
+      parentRef = { ticketId: createdParent.ticketId, url: createdParent.url };
+    } catch (err) {
+      emit({ ok: false, error: 'parent-create-failed', message: `Không tạo được ticket cha trên Jira: ${err.message}` });
+      process.exitCode = 1;
+      return;
+    }
+  } else if (parentTicket.mode === 'existing') {
+    try {
+      const existing = await getJiraIssue(write.domain, write.emailWrite, write.apiTokenWrite, parentTicket.existingId);
+      parentRef = { ticketId: existing.key, url: `https://${write.domain}/browse/${existing.key}` };
+    } catch (err) {
+      emit({ ok: false, error: 'parent-not-found', message: `Không tìm thấy ticket cha "${parentTicket.existingId}" trên Jira: ${err.message}` });
+      process.exitCode = 1;
+      return;
+    }
+  }
+
   const results = [];
   for (const task of tasks) {
     try {
@@ -214,13 +282,14 @@ async function createTicketsCommand(inputFile, options = {}) {
         summary: task.title,
         description: task.description,
         issueTypeName: task.issueType || 'Task',
+        parentKey: parentRef ? parentRef.ticketId : undefined,
       });
       results.push({ type: task.type, title: task.title, ok: true, ticketId: created.ticketId, url: created.url });
     } catch (err) {
       results.push({ type: task.type, title: task.title, ok: false, error: err.message });
     }
   }
-  emit({ ok: true, target, projectKey, results });
+  emit({ ok: true, target, projectKey, parent: parentRef, results });
 }
 
 /**