@ameshkin/ticket-mate 0.1.20

package/public/sync/ticket-sync.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Ticket Sync Logic
+ */
+import type { JiraConfig } from "@/types";
+/**
+ * Sync a single ticket to progress file
+ */
+export declare function syncTicket(issueKey: string, baseDir: string, _config: JiraConfig, epicKey?: string, options?: {
+    client?: import("@/server/jira/jiraClient").JiraClient;
+}): Promise<{
+    created: boolean;
+    updated: boolean;
+    path: string;
+}>;
+/**
+ * Sync all tickets in an epic
+ */
+export declare function syncEpic(epicKey: string, baseDir: string, config: JiraConfig, options?: {
+    client?: import("@/server/jira/jiraClient").JiraClient;
+}): Promise<{
+    ticketsSynced: number;
+    filesCreated: number;
+    filesUpdated: number;
+}>;
+//# sourceMappingURL=ticket-sync.d.ts.map

package/public/sync/ticket-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-sync.d.ts","sourceRoot":"","sources":["../../src/sync/ticket-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,0BAA0B,EAAE,UAAU,CAAA;CAAO,GACvE,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkH/D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,0BAA0B,EAAE,UAAU,CAAA;CAAO,GACvE,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAgChF"}

package/public/sync/ticket-sync.js

@@ -0,0 +1,148 @@
+/**
+ * Ticket Sync Logic
+ */
+// Use path aliases since this file is imported by Next.js API routes (bundled context)
+import { getIssue } from "@/client/jira-client";
+import { generateTicketBrief } from "@/progress/template";
+import { readProgressFile, writeProgressFile, getProgressFilePath } from "@/utils/filesystem";
+import { logger } from "@/utils/logger";
+import { getErrorMessage } from "@/types/common";
+/**
+ * Sync a single ticket to progress file
+ */
+export async function syncTicket(issueKey, baseDir, _config, epicKey, options = {}) {
+    logger.info("Syncing ticket", { issueKey, epicKey });
+    // Helper to find existing ticket file anywhere in baseDir
+    const findExistingFile = async (key, dir) => {
+        const { readdir, readFile, stat } = await import("fs/promises");
+        const { join, extname } = await import("path");
+        const scan = async (currentDir) => {
+            const entries = await readdir(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    const found = await scan(fullPath);
+                    if (found)
+                        return found;
+                }
+                else if (extname(entry.name) === ".md") {
+                    // Check if filename matches or content has the key in header
+                    if (entry.name === `${key}.md` || entry.name.startsWith(`${key}-`)) {
+                        return fullPath;
+                    }
+                    try {
+                        const content = await readFile(fullPath, "utf-8");
+                        if (content.match(new RegExp(`^#\\s*\\[${key}\\]`, 'm'))) {
+                            return fullPath;
+                        }
+                        if (content.includes(`jiraIssueKey: ${key}`)) {
+                            return fullPath;
+                        }
+                    }
+                    catch {
+                        // Ignore read errors
+                    }
+                }
+            }
+            return null;
+        };
+        return scan(dir);
+    };
+    // Fetch ticket from Jira
+    const ticket = await getIssue(issueKey, { client: options.client });
+    // Get status for folder organization
+    const status = ticket.fields?.status?.name || null;
+    if (!ticket.fields) {
+        throw new Error(`Ticket ${issueKey} returned by Jira has no fields. This may be a permission issue.`);
+    }
+    // Determine file path (will use finished/ folder if status is Done)
+    let filePath = getProgressFilePath(issueKey, baseDir, {
+        status,
+        type: ticket.fields?.issuetype?.name,
+        title: ticket.fields?.summary,
+        epicKey
+    });
+    // SEARCH for existing file first to avoid duplicates
+    const actualExistingPath = await findExistingFile(issueKey, baseDir);
+    if (actualExistingPath) {
+        filePath = actualExistingPath;
+        logger.debug("Found existing ticket file at custom location", { issueKey, filePath });
+    }
+    // Check if file exists in old location and needs to be moved
+    const oldFilePath = getProgressFilePath(issueKey, baseDir, {
+        epicKey,
+        // No status/type/title to get the flat or project-based path if that's what we were using
+        // But since getProgressFilePath changed completely, we rely on findExistingFile more now.
+    });
+    const existingOldFile = actualExistingPath ? null : await readProgressFile(oldFilePath);
+    // If status is Done and file exists in old location, we'll write to new location and delete old one
+    const needsMove = !actualExistingPath && existingOldFile && filePath !== oldFilePath;
+    // Read existing content if it exists (check both old and new locations)
+    const existingContent = actualExistingPath
+        ? await readProgressFile(actualExistingPath)
+        : (await readProgressFile(filePath) || (needsMove ? existingOldFile : null));
+    // Generate new brief (merges with existing to preserve human sections)
+    const newContent = generateTicketBrief(ticket, existingContent || undefined);
+    // Write file to new location
+    const wasCreated = !existingContent;
+    await writeProgressFile(filePath, newContent);
+    // Move file from old location to new location if needed
+    if (needsMove && filePath !== oldFilePath) {
+        try {
+            const { unlink } = await import("fs/promises");
+            await unlink(oldFilePath);
+            logger.info("Moved ticket file to finished folder", {
+                issueKey,
+                from: oldFilePath,
+                to: filePath
+            });
+        }
+        catch (error) {
+            logger.warn("Failed to delete old file location", {
+                issueKey,
+                oldPath: oldFilePath,
+                error: getErrorMessage(error)
+            });
+            // Continue even if deletion fails - file is now in correct location
+        }
+    }
+    logger.info("Ticket synced", { issueKey, path: filePath, created: wasCreated });
+    return {
+        created: wasCreated,
+        updated: !wasCreated,
+        path: filePath,
+    };
+}
+/**
+ * Sync all tickets in an epic
+ */
+export async function syncEpic(epicKey, baseDir, config, options = {}) {
+    logger.info("Syncing epic", { epicKey });
+    // Get all issues in epic
+    const { getEpicIssuesForEpic } = await import("@/sync/epic-sync");
+    const issues = await getEpicIssuesForEpic(epicKey, { client: options.client });
+    let filesCreated = 0;
+    let filesUpdated = 0;
+    // Sync each ticket
+    for (const issue of issues) {
+        const result = await syncTicket(issue.key, baseDir, config, epicKey, { client: options.client });
+        if (result.created) {
+            filesCreated++;
+        }
+        else {
+            filesUpdated++;
+        }
+    }
+    logger.info("Epic synced", {
+        epicKey,
+        ticketsSynced: issues.length,
+        filesCreated,
+        filesUpdated,
+    });
+    return {
+        ticketsSynced: issues.length,
+        filesCreated,
+        filesUpdated,
+    };
+}
+//# sourceMappingURL=ticket-sync.js.map

package/public/sync/ticket-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-sync.js","sourceRoot":"","sources":["../../src/sync/ticket-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uFAAuF;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,OAAe,EACf,OAAmB,EACnB,OAAgB,EAChB,UAAsE,EAAE;IAExE,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAErD,0DAA0D;IAC1D,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAAE,GAAW,EAA0B,EAAE;QAClF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAG,KAAK,EAAE,UAAkB,EAA0B,EAAE;YAChE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,KAAK;wBAAE,OAAO,KAAK,CAAC;gBAC1B,CAAC;qBAAM,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;oBACzC,6DAA6D;oBAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;wBACnE,OAAO,QAAQ,CAAC;oBAClB,CAAC;oBACD,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;wBAClD,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;4BACzD,OAAO,QAAQ,CAAC;wBAClB,CAAC;wBACD,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,GAAG,EAAE,CAAC,EAAE,CAAC;4BAC7C,OAAO,QAAQ,CAAC;wBAClB,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,qBAAqB;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,yBAAyB;IACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpE,qCAAqC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;IAEnD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,kEAAkE,CAAC,CAAC;IACxG,CAAC;IAED,oEAAoE;IACpE,IAAI,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE;QACpD,MAAM;QACN,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI;QACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO;QAC7B,OAAO;KACR,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,kBAAkB,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,kBAAkB,EAAE,CAAC;QACvB,QAAQ,GAAG,kBAAkB,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,6DAA6D;IAC7D,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE;QACzD,OAAO;QACP,0FAA0F;QAC1F,0FAA0F;KAC3F,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAExF,oGAAoG;IACpG,MAAM,SAAS,GAAG,CAAC,kBAAkB,IAAI,eAAe,IAAI,QAAQ,KAAK,WAAW,CAAC;IAErF,wEAAwE;IACxE,MAAM,eAAe,GAAG,kBAAkB;QACxC,CAAC,CAAC,MAAM,gBAAgB,CAAC,kBAAkB,CAAC;QAC5C,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/E,uEAAuE;IACvE,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,EAAE,eAAe,IAAI,SAAS,CAAC,CAAC;IAE7E,6BAA6B;IAC7B,MAAM,UAAU,GAAG,CAAC,eAAe,CAAC;IACpC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE9C,wDAAwD;IACxD,IAAI,SAAS,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC/C,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;gBAClD,QAAQ;gBACR,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,QAAQ;aACb,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;gBAChD,QAAQ;gBACR,OAAO,EAAE,WAAW;gBACpB,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;aAC9B,CAAC,CAAC;YACH,oEAAoE;QACtE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAEhF,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,CAAC,UAAU;QACpB,IAAI,EAAE,QAAQ;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAe,EACf,OAAe,EACf,MAAkB,EAClB,UAAsE,EAAE;IAExE,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzC,yBAAyB;IACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/E,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,mBAAmB;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,YAAY,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,YAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE;QACzB,OAAO;QACP,aAAa,EAAE,MAAM,CAAC,MAAM;QAC5B,YAAY;QACZ,YAAY;KACb,CAAC,CAAC;IAEH,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,MAAM;QAC5B,YAAY;QACZ,YAAY;KACb,CAAC;AACJ,CAAC"}

package/public/templates/template-engine.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Template Engine
+
+ *
+ * Customizable markdown templates for ticket briefs with variable substitution.
+ */
+/**
+ * Template variables
+ */
+export interface TemplateVariables {
+    [key: string]: string | number | boolean | string[] | undefined;
+}
+/**
+ * Template context
+ */
+export interface TemplateContext {
+    ticketKey: string;
+    summary: string;
+    description?: string;
+    acceptanceCriteria?: string[];
+    assignee?: string;
+    labels?: string[];
+    status?: string;
+    [key: string]: any;
+}
+/**
+ * Template options
+ */
+export interface TemplateOptions {
+    /**
+     * Template file path
+     */
+    templatePath?: string;
+    /**
+     * Template content (if not using file)
+     */
+    templateContent?: string;
+    /**
+     * Variables to substitute
+     */
+    variables?: TemplateVariables;
+    /**
+     * Context for template rendering
+     */
+    context?: TemplateContext;
+    /**
+     * Strict mode (throw on missing variables)
+     */
+    strict?: boolean;
+}
+/**
+ * Default ticket brief template
+ */
+export declare const DEFAULT_TEMPLATE = "# {{summary}}\n\n## Summary\n{{description}}\n\n## Acceptance Criteria\n{{#each acceptanceCriteria}}\n- {{this}}\n{{/each}}\n\n## Context\n{{context}}\n\n## Technical Details\n{{technicalDetails}}\n\n## Testing\n{{testing}}\n\n## Notes\n{{notes}}\n";
+/**
+ * Render template
+ */
+export declare function renderTemplate(options: TemplateOptions): Promise<string>;
+/**
+ * Render template to file
+ */
+export declare function renderTemplateToFile(outputPath: string, options: TemplateOptions): Promise<void>;
+/**
+ * Load template from file
+ */
+export declare function loadTemplate(templatePath: string): Promise<string>;
+/**
+ * Save template to file
+ */
+export declare function saveTemplate(templatePath: string, content: string): Promise<void>;
+/**
+ * Validate template syntax
+ */
+export declare function validateTemplate(template: string): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get default template
+ */
+export declare function getDefaultTemplate(): string;
+/**
+ * Create template from ticket
+ */
+export declare function createTemplateFromTicket(context: TemplateContext): string;
+//# sourceMappingURL=template-engine.d.ts.map

package/public/templates/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/templates/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,6PAqB5B,CAAC;AAwFF;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC9E;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMxE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA4BA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAGzE"}

package/public/templates/template-engine.js

@@ -0,0 +1,214 @@
+/**
+ * Template Engine
+
+ *
+ * Customizable markdown templates for ticket briefs with variable substitution.
+ */
+import { readFile, writeFile } from "fs/promises";
+import { dirname } from "path";
+import { logger } from "../utils/logger";
+import { getErrorMessage } from "../types/common";
+/**
+ * Default ticket brief template
+ */
+export const DEFAULT_TEMPLATE = `# {{summary}}
+
+## Summary
+{{description}}
+
+## Acceptance Criteria
+{{#each acceptanceCriteria}}
+- {{this}}
+{{/each}}
+
+## Context
+{{context}}
+
+## Technical Details
+{{technicalDetails}}
+
+## Testing
+{{testing}}
+
+## Notes
+{{notes}}
+`;
+/**
+ * Simple template variable substitution
+ */
+function substituteVariables(template, variables, strict = false) {
+    let result = template;
+    // Replace {{variable}} patterns
+    const variablePattern = /\{\{(\w+)\}\}/g;
+    result = result.replace(variablePattern, (match, varName) => {
+        const value = variables[varName];
+        if (value === undefined || value === null) {
+            if (strict) {
+                throw new Error(`Missing template variable: ${varName}`);
+            }
+            return match; // Keep original if not found
+        }
+        return String(value);
+    });
+    // Replace {{#each array}}...{{/each}} patterns (simple implementation)
+    const eachPattern = /\{\{#each\s+(\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g;
+    result = result.replace(eachPattern, (_match, arrayName, content) => {
+        const array = variables[arrayName];
+        if (!Array.isArray(array)) {
+            if (strict) {
+                throw new Error(`Template variable ${arrayName} is not an array`);
+            }
+            return "";
+        }
+        return array
+            .map((item) => {
+            let itemContent = content;
+            // Replace {{this}} with array item
+            itemContent = itemContent.replace(/\{\{this\}\}/g, String(item));
+            // Replace {{@index}} with index
+            itemContent = itemContent.replace(/\{\{@index\}\}/g, (_match, _offset) => {
+                const index = array.indexOf(item);
+                return String(index);
+            });
+            return itemContent;
+        })
+            .join("");
+    });
+    // Replace {{#if condition}}...{{/if}} patterns
+    const ifPattern = /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g;
+    result = result.replace(ifPattern, (_match, conditionName, content) => {
+        const condition = variables[conditionName];
+        if (condition && condition !== "false" && condition !== "0") {
+            return content;
+        }
+        return "";
+    });
+    return result;
+}
+/**
+ * Build template variables from context
+ */
+function buildVariables(context, additionalVars) {
+    const variables = {
+        ticketKey: context.ticketKey,
+        summary: context.summary,
+        description: context.description || "",
+        context: context.context || "",
+        technicalDetails: context.technicalDetails || "",
+        testing: context.testing || "",
+        notes: context.notes || "",
+        assignee: context.assignee || "Unassigned",
+        status: context.status || "To Do",
+        labels: context.labels ? context.labels.join(", ") : "",
+        acceptanceCriteria: (context.acceptanceCriteria || []),
+        date: new Date().toISOString().split("T")[0],
+        timestamp: new Date().toISOString(),
+        ...additionalVars,
+    };
+    return variables;
+}
+/**
+ * Render template
+ */
+export async function renderTemplate(options) {
+    const { templatePath, templateContent, variables = {}, context, strict = false, } = options;
+    let template;
+    // Load template
+    if (templateContent) {
+        template = templateContent;
+    }
+    else if (templatePath) {
+        try {
+            template = await readFile(templatePath, "utf-8");
+        }
+        catch (error) {
+            throw new Error(`Failed to load template from ${templatePath}: ${getErrorMessage(error)}`);
+        }
+    }
+    else {
+        template = DEFAULT_TEMPLATE;
+    }
+    // Build variables from context
+    const allVariables = context
+        ? { ...buildVariables(context), ...variables }
+        : variables;
+    // Substitute variables
+    try {
+        return substituteVariables(template, allVariables, strict);
+    }
+    catch (error) {
+        throw new Error(`Template rendering failed: ${getErrorMessage(error)}`);
+    }
+}
+/**
+ * Render template to file
+ */
+export async function renderTemplateToFile(outputPath, options) {
+    const content = await renderTemplate(options);
+    // Ensure directory exists (dirname is used implicitly by writeFile)
+    dirname(outputPath);
+    await writeFile(outputPath, content, "utf-8");
+    logger.info("Template rendered to file", { outputPath });
+}
+/**
+ * Load template from file
+ */
+export async function loadTemplate(templatePath) {
+    try {
+        return await readFile(templatePath, "utf-8");
+    }
+    catch (error) {
+        throw new Error(`Failed to load template: ${getErrorMessage(error)}`);
+    }
+}
+/**
+ * Save template to file
+ */
+export async function saveTemplate(templatePath, content) {
+    // Ensure directory exists (dirname is used implicitly by writeFile)
+    dirname(templatePath);
+    await writeFile(templatePath, content, "utf-8");
+    logger.info("Template saved", { templatePath });
+}
+/**
+ * Validate template syntax
+ */
+export function validateTemplate(template) {
+    const errors = [];
+    // Check for unmatched braces
+    const openBraces = (template.match(/\{\{/g) || []).length;
+    const closeBraces = (template.match(/\}\}/g) || []).length;
+    if (openBraces !== closeBraces) {
+        errors.push("Unmatched template braces");
+    }
+    // Check for unmatched {{#each}} blocks
+    const eachOpen = (template.match(/\{\{#each\s+\w+\}\}/g) || []).length;
+    const eachClose = (template.match(/\{\{\/each\}\}/g) || []).length;
+    if (eachOpen !== eachClose) {
+        errors.push("Unmatched {{#each}} blocks");
+    }
+    // Check for unmatched {{#if}} blocks
+    const ifOpen = (template.match(/\{\{#if\s+\w+\}\}/g) || []).length;
+    const ifClose = (template.match(/\{\{\/if\}\}/g) || []).length;
+    if (ifOpen !== ifClose) {
+        errors.push("Unmatched {{#if}} blocks");
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Get default template
+ */
+export function getDefaultTemplate() {
+    return DEFAULT_TEMPLATE;
+}
+/**
+ * Create template from ticket
+ */
+export function createTemplateFromTicket(context) {
+    const variables = buildVariables(context);
+    return substituteVariables(DEFAULT_TEMPLATE, variables, false);
+}
+//# sourceMappingURL=template-engine.js.map

package/public/templates/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/templates/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAqDlD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqB/B,CAAC;AAEF;;GAEG;AACH,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,SAA4B,EAC5B,SAAkB,KAAK;IAEvB,IAAI,MAAM,GAAG,QAAQ,CAAC;IAEtB,gCAAgC;IAChC,MAAM,eAAe,GAAG,gBAAgB,CAAC;IACzC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC1D,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,KAAK,CAAC,CAAC,6BAA6B;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,MAAM,WAAW,GAAG,gDAAgD,CAAC;IACrE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QAClE,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,kBAAkB,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,KAAK;aACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,WAAW,GAAG,OAAO,CAAC;YAC1B,mCAAmC;YACnC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACjE,gCAAgC;YAChC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,MAAc,EAAE,OAAe,EAAE,EAAE;gBACvF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,OAAO,WAAW,CAAC;QACrB,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,MAAM,SAAS,GAAG,4CAA4C,CAAC;IAC/D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE;QACpE,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,SAAS,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC5D,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAwB,EAAE,cAAkC;IAClF,MAAM,SAAS,GAAsB;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,YAAY;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QACvD,kBAAkB,EAAE,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAa;QAClE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,cAAc;KAClB,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAwB;IAC3D,MAAM,EACJ,YAAY,EACZ,eAAe,EACf,SAAS,GAAG,EAAE,EACd,OAAO,EACP,MAAM,GAAG,KAAK,GACf,GAAG,OAAO,CAAC;IAEZ,IAAI,QAAgB,CAAC;IAErB,gBAAgB;IAChB,IAAI,eAAe,EAAE,CAAC;QACpB,QAAQ,GAAG,eAAe,CAAC;IAC7B,CAAC;SAAM,IAAI,YAAY,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,gBAAgB,CAAC;IAC9B,CAAC;IAED,+BAA+B;IAC/B,MAAM,YAAY,GAAG,OAAO;QAC1B,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,EAAE;QAC9C,CAAC,CAAC,SAAS,CAAC;IAEd,uBAAuB;IACvB,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,OAAwB;IAExB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAC,CAAC;IACpB,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4BAA4B,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB,EAAE,OAAe;IACtE,oEAAoE;IACpE,OAAO,CAAC,YAAY,CAAC,CAAC;IACtB,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAI/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,WAAW,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC3D,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED,uCAAuC;IACvC,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACnE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;IAED,qCAAqC;IACrC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/D,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAwB;IAC/D,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,mBAAmB,CAAC,gBAAgB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC"}

package/public/ticket-mate/bugs/loader.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Bugs Loader & Sync Utility
+ *
+ * Loads bugs from .orchestrator/config/orchestrator.json (canonical) or .jm-mate/bugs.json (mirror)
+ * Normalizes to JmBugRecord format
+ */
+import type { JmBugRecord } from '@/ticket-mate/bugs/types';
+import type { BugStatus, BugSeverity, BugSource } from '@/shared/ticketMateTypes';
+export type { BugStatus, BugSeverity, BugSource };
+/**
+ * Load bugs from Orchestrator file (.orchestrator/config/orchestrator.json)
+ */
+export declare function loadBugsFromOrchestrator(root: string, projectKey?: string): JmBugRecord[];
+/**
+ * Load bugs from Ticket Mate mirror file (.jm-mate/bugs.json)
+ */
+export declare function loadBugsFromJmMate(root: string, projectKey?: string): JmBugRecord[];
+/**
+ * Load bugs (prefer Orchestrator, fallback to Jira Mate mirror)
+ */
+export declare function loadBugs(root: string, projectKey?: string): JmBugRecord[];
+/**
+ * Write bugs to Jira Mate mirror file
+ */
+export declare function writeBugsToJmMate(root: string, bugs: JmBugRecord[]): void;
+/**
+ * Update a bug record (updates both Orchestrator and mirror if possible)
+ */
+export declare function updateBug(root: string, bugId: string, updates: Partial<JmBugRecord>, projectKey?: string): JmBugRecord | null;
+//# sourceMappingURL=loader.d.ts.map

package/public/ticket-mate/bugs/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/ticket-mate/bugs/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAoC,MAAM,0BAA0B,CAAC;AAE9F,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAMlD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAiEzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAiDnF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CASzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAyBzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,GAAG,IAAI,CA4BpB"}