@ameshkin/ticket-mate 0.1.20

package/public/shared/ticketMateHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketMateHelpers.d.ts","sourceRoot":"","sources":["../../src/shared/ticketMateHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAO3B;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAyBlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAgBzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAO5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,mBAAmB,GACjC,IAAI,CAyBN;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,IAAI,CAyB1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAmBN;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,IAAI,CA6CzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,GACrB,IAAI,CA6BN;AAGD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/public/shared/ticketMateHelpers.js

@@ -0,0 +1,197 @@
+/**
+ * Shared Jira Mate Helpers
+ *
+ * Common helper functions used by CLI, Next.js, and Replit Extension.
+ * All file system operations for .ticket-mate should go through these helpers.
+ *
+ * INVARIANTS:
+ * - Single source of truth: Jira for issues, .ticket-mate for local projection
+ * - All consumers use the same path builders and readers
+ * - Project mappings are centralized
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { getProjectConfig as getProjectConfigFromTypes } from './ticketMateTypes';
+// ============================================================================
+// Config Helpers
+// ============================================================================
+/**
+ * Load .ticket-mate/config.json (checks .orchestrator/config.json first)
+ */
+export function loadJmMateConfig(root) {
+    // Check new location first
+    const orchestratorConfigPath = join(root, '.orchestrator', 'config.json');
+    const legacyConfigPath = join(root, '.ticket-mate', 'config.json');
+    const configPath = existsSync(orchestratorConfigPath) ? orchestratorConfigPath : legacyConfigPath;
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Validate required fields
+        if (!parsed.jiraBaseUrl) {
+            throw new Error('config.json is missing required field: jiraBaseUrl');
+        }
+        return parsed;
+    }
+    catch (error) {
+        console.error('[loadJmMateConfig] Failed to load config:', error);
+        return null;
+    }
+}
+/**
+ * Save .ticket-mate/config.json
+ */
+export function saveJmMateConfig(root, config) {
+    // Prefer .orchestrator if it exists or if .ticket-mate doesn't exist
+    const orchestratorDir = join(root, '.orchestrator');
+    const legacyDir = join(root, '.ticket-mate');
+    const targetDir = existsSync(legacyDir) && !existsSync(orchestratorDir) ? legacyDir : orchestratorDir;
+    const configPath = join(targetDir, 'config.json');
+    // Create directory if it doesn't exist
+    if (!existsSync(targetDir)) {
+        mkdirSync(targetDir, { recursive: true });
+    }
+    // Write config with pretty-printed JSON
+    const content = JSON.stringify(config, null, 2);
+    writeFileSync(configPath, content, 'utf-8');
+}
+/**
+ * Get project config for a specific project key
+ */
+export function getProjectConfigForKey(root, projectKey) {
+    const config = loadJmMateConfig(root);
+    if (!config) {
+        return null;
+    }
+    return getProjectConfigFromTypes(config, projectKey);
+}
+/**
+ * Add or update project config
+ */
+export function upsertProjectConfig(root, projectConfig) {
+    const config = loadJmMateConfig(root) || {
+        jiraBaseUrl: projectConfig.jiraBaseUrl,
+        projects: [],
+    };
+    // Initialize projects array if needed
+    if (!config.projects) {
+        config.projects = [];
+    }
+    // Find existing project
+    const existingIndex = config.projects.findIndex(p => p.projectKey === projectConfig.projectKey);
+    if (existingIndex >= 0) {
+        // Update existing
+        config.projects[existingIndex] = projectConfig;
+    }
+    else {
+        // Add new
+        config.projects.push(projectConfig);
+    }
+    saveJmMateConfig(root, config);
+}
+// ============================================================================
+// Project Meta Helpers
+// ============================================================================
+/**
+ * Load project metadata from .ticket-mate/projects/<projectKey>/project.meta.json
+ */
+export function loadProjectMeta(root, projectKey) {
+    // Check .orchestrator first
+    const orchestratorMetaPath = join(root, '.orchestrator', 'projects', projectKey, 'project.meta.json');
+    const legacyMetaPath = join(root, '.ticket-mate', 'projects', projectKey, 'project.meta.json');
+    const metaPath = existsSync(orchestratorMetaPath) ? orchestratorMetaPath : legacyMetaPath;
+    if (!existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(metaPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Ensure projectKey matches
+        if (parsed.key !== projectKey) {
+            parsed.key = projectKey;
+        }
+        return parsed;
+    }
+    catch (error) {
+        console.error(`[loadProjectMeta] Failed to load meta for ${projectKey}:`, error);
+        return null;
+    }
+}
+/**
+ * Save project metadata
+ */
+export function saveProjectMeta(root, meta) {
+    // Prefer .orchestrator
+    const orchestratorDir = join(root, '.orchestrator');
+    const legacyDir = join(root, '.ticket-mate');
+    const baseDir = existsSync(legacyDir) && !existsSync(orchestratorDir) ? legacyDir : orchestratorDir;
+    const projectDir = join(baseDir, 'projects', meta.key);
+    const metaPath = join(projectDir, 'project.meta.json');
+    // Create project directory if it doesn't exist
+    if (!existsSync(projectDir)) {
+        mkdirSync(projectDir, { recursive: true });
+    }
+    // Ensure key matches
+    const metaToSave = { ...meta, key: meta.key };
+    const content = JSON.stringify(metaToSave, null, 2);
+    writeFileSync(metaPath, content, 'utf-8');
+}
+// ============================================================================
+// Ticket Meta Helpers
+// ============================================================================
+/**
+ * Load ticket metadata from .ticket-mate/projects/<projectKey>/tickets/<ticketKey>/ticket.meta.json
+ */
+export function loadTicketMeta(root, projectKey, ticketKey) {
+    // Check .orchestrator first
+    const orchestratorMetaPath = join(root, '.orchestrator', 'projects', projectKey, 'tickets', ticketKey, 'ticket.meta.json');
+    const legacyMetaPath = join(root, '.ticket-mate', 'projects', projectKey, 'tickets', ticketKey, 'ticket.meta.json');
+    const metaPath = existsSync(orchestratorMetaPath) ? orchestratorMetaPath : legacyMetaPath;
+    if (!existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(metaPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Ensure keys match
+        if (parsed.projectKey !== projectKey) {
+            parsed.projectKey = projectKey;
+        }
+        if (parsed.key !== ticketKey) {
+            parsed.key = ticketKey;
+        }
+        return parsed;
+    }
+    catch (error) {
+        console.error(`[loadTicketMeta] Failed to load meta for ${ticketKey}:`, error);
+        return null;
+    }
+}
+/**
+ * Save ticket metadata
+ */
+export function saveTicketMeta(root, meta) {
+    // Prefer .orchestrator
+    const orchestratorDir = join(root, '.orchestrator');
+    const legacyDir = join(root, '.ticket-mate');
+    const baseDir = existsSync(legacyDir) && !existsSync(orchestratorDir) ? legacyDir : orchestratorDir;
+    const ticketDir = join(baseDir, 'projects', meta.projectKey, 'tickets', meta.key);
+    const metaPath = join(ticketDir, 'ticket.meta.json');
+    // Create ticket directory if it doesn't exist
+    if (!existsSync(ticketDir)) {
+        mkdirSync(ticketDir, { recursive: true });
+    }
+    // Ensure keys match
+    const metaToSave = {
+        ...meta,
+        key: meta.key,
+        projectKey: meta.projectKey,
+    };
+    const content = JSON.stringify(metaToSave, null, 2);
+    writeFileSync(metaPath, content, 'utf-8');
+}
+// Re-export link helpers from dedicated module
+export { getGitHubFileUrl, getReplitFileUrl, getJiraProjectUrl, getProjectLinks, } from './ticketMateProjectLinks';
+//# sourceMappingURL=ticketMateHelpers.js.map

package/public/shared/ticketMateHelpers.js.map

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

package/public/shared/ticketMateProjectLinks.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Project Link Helpers
+ *
+ * Utilities for generating GitHub, Replit, and Jira links for projects.
+ * Used by Next.js admin UI and Replit Extension to show consistent links.
+ */
+/**
+ * Get GitHub file URL for a project
+ */
+export declare function getGitHubFileUrl(root: string, projectKey: string, filePath: string, branch?: string): string | null;
+/**
+ * Get Replit file URL for a project
+ */
+export declare function getReplitFileUrl(root: string, projectKey: string, filePath: string): string | null;
+/**
+ * Get Jira project URL
+ */
+export declare function getJiraProjectUrl(root: string, projectKey: string): string | null;
+/**
+ * Get all links for a project
+ */
+export declare function getProjectLinks(root: string, projectKey: string): {
+    jira?: string;
+    github?: string;
+    replit?: string;
+};
+//# sourceMappingURL=ticketMateProjectLinks.d.ts.map

package/public/shared/ticketMateProjectLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketMateProjectLinks.d.ts","sourceRoot":"","sources":["../../src/shared/ticketMateProjectLinks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAwBf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAQf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAOf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAQA"}

package/public/shared/ticketMateProjectLinks.js

@@ -0,0 +1,64 @@
+/**
+ * Project Link Helpers
+ *
+ * Utilities for generating GitHub, Replit, and Jira links for projects.
+ * Used by Next.js admin UI and Replit Extension to show consistent links.
+ */
+import { getProjectConfigForKey } from './ticketMateHelpers';
+/**
+ * Get GitHub file URL for a project
+ */
+export function getGitHubFileUrl(root, projectKey, filePath, branch) {
+    const projectConfig = getProjectConfigForKey(root, projectKey);
+    if (!projectConfig?.repoUrl) {
+        return null;
+    }
+    // Extract repo name from URL if needed
+    let repoName = projectConfig.repoName;
+    if (!repoName && projectConfig.repoUrl) {
+        // Extract from URL: https://github.com/owner/repo -> owner/repo
+        const match = projectConfig.repoUrl.match(/github\.com\/([^\/]+\/[^\/]+)/);
+        if (match) {
+            repoName = match[1];
+        }
+    }
+    if (!repoName) {
+        return null;
+    }
+    const targetBranch = branch || projectConfig.defaultBranch || 'main';
+    const cleanPath = filePath.startsWith('/') ? filePath.substring(1) : filePath;
+    return `https://github.com/${repoName}/blob/${targetBranch}/${cleanPath}`;
+}
+/**
+ * Get Replit file URL for a project
+ */
+export function getReplitFileUrl(root, projectKey, filePath) {
+    const projectConfig = getProjectConfigForKey(root, projectKey);
+    if (!projectConfig?.replitUrl) {
+        return null;
+    }
+    const cleanPath = filePath.startsWith('/') ? filePath.substring(1) : filePath;
+    return `${projectConfig.replitUrl}/files/${cleanPath}`;
+}
+/**
+ * Get Jira project URL
+ */
+export function getJiraProjectUrl(root, projectKey) {
+    const projectConfig = getProjectConfigForKey(root, projectKey);
+    if (!projectConfig?.jiraBaseUrl) {
+        return null;
+    }
+    return `${projectConfig.jiraBaseUrl}/browse/${projectKey}`;
+}
+/**
+ * Get all links for a project
+ */
+export function getProjectLinks(root, projectKey) {
+    const projectConfig = getProjectConfigForKey(root, projectKey);
+    return {
+        jira: projectConfig ? `${projectConfig.jiraBaseUrl}/browse/${projectKey}` : undefined,
+        github: projectConfig?.repoUrl || undefined,
+        replit: projectConfig?.replitUrl || undefined,
+    };
+}
+//# sourceMappingURL=ticketMateProjectLinks.js.map

package/public/shared/ticketMateProjectLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketMateProjectLinks.js","sourceRoot":"","sources":["../../src/shared/ticketMateProjectLinks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,UAAkB,EAClB,QAAgB,EAChB,MAAe;IAEf,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,IAAI,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IACtC,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;QACvC,gEAAgE;QAChE,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC3E,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,IAAI,aAAa,CAAC,aAAa,IAAI,MAAM,CAAC;IACrE,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE9E,OAAO,sBAAsB,QAAQ,SAAS,YAAY,IAAI,SAAS,EAAE,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,UAAkB,EAClB,QAAgB;IAEhB,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9E,OAAO,GAAG,aAAa,CAAC,SAAS,UAAU,SAAS,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,UAAkB;IAElB,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,aAAa,CAAC,WAAW,WAAW,UAAU,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB;IAK9D,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE/D,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,WAAW,WAAW,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;QACrF,MAAM,EAAE,aAAa,EAAE,OAAO,IAAI,SAAS;QAC3C,MAAM,EAAE,aAAa,EAAE,SAAS,IAAI,SAAS;KAC9C,CAAC;AACJ,CAAC"}

package/public/shared/ticketMateTypes.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Shared Jira Mate Types
+ *
+ * **CANONICAL TYPES** - Single source of truth for all Jira Mate consumers:
+ * - CLI
+ * - Next.js admin/webhook app
+ * - Replit Extension
+ *
+ * All consumers MUST import from this module (or mirror exactly).
+ *
+ * INVARIANTS:
+ * - Jira → truth for issues (tickets/bugs)
+ * - .ticket-mate/ → truth for local projection of Jira tickets & project metadata
+ * - .orchestrator/bugs.json → truth for local bugs, mirrored into Jira when promoted
+ */
+/**
+ * Project configuration with explicit links to GitHub and Replit
+ *
+ * Each Jira project key (e.g. "CART") knows its:
+ * - Jira instance
+ * - GitHub repository
+ * - Replit project
+ */
+export interface JmMateProjectConfig {
+    projectKey: string;
+    jiraBaseUrl: string;
+    jiraCloudId?: string;
+    repoUrl?: string;
+    repoName?: string;
+    defaultBranch?: string;
+    replitUrl?: string;
+    replitSlug?: string;
+}
+/**
+ * Root .ticket-mate/config.json structure
+ *
+ * Supports multiple projects (multi-project mode) or single project (legacy mode)
+ */
+export interface JmMateConfig {
+    jiraBaseUrl: string;
+    jiraCloudId?: string;
+    jiraProjectKey?: string;
+    projects?: JmMateProjectConfig[];
+    defaultBranch?: string;
+    integrations?: {
+        cursor?: {
+            enabled: boolean;
+        };
+        replit?: {
+            targets: JmMateReplitTarget[];
+            defaultTargetName?: string;
+        };
+    };
+}
+/**
+ * Replit webhook target configuration
+ */
+export interface JmMateReplitTarget {
+    name: string;
+    webhookUrl: string;
+    secret?: string;
+    enabled?: boolean;
+}
+/**
+ * Project metadata stored in .ticket-mate/projects/<projectKey>/project.meta.json
+ */
+export interface JmMateProjectMeta {
+    key: string;
+    name?: string;
+    description?: string;
+    url?: string;
+    lastSyncedAt?: string;
+}
+/**
+ * Ticket metadata stored in .ticket-mate/projects/<projectKey>/tickets/<ticketKey>/ticket.meta.json
+ *
+ * This is the local projection of a Jira issue.
+ */
+export interface JmMateTicketMeta {
+    key: string;
+    projectKey: string;
+    summary: string;
+    status: string;
+    type: string;
+    assignee?: string;
+    storyPoints?: number;
+    labels?: string[];
+    url: string;
+    updatedAt: string;
+}
+export type BugStatus = 'open' | 'in-progress' | 'fixed' | 'ignored';
+export type BugSeverity = 'low' | 'medium' | 'high' | 'critical';
+export type BugSource = 'orchestrator' | 'manual' | 'ai' | 'test';
+/**
+ * Unified bug record matching Orchestrator schema
+ *
+ * Source of truth: .orchestrator/config/orchestrator.json (bugs array)
+ * Mirror: .ticket-mate/bugs.json (optional, for contexts without Orchestrator)
+ */
+export interface JmBugRecord {
+    id: string;
+    projectKey: string;
+    title: string;
+    description?: string;
+    severity?: BugSeverity;
+    status: BugStatus;
+    errorMessage?: string;
+    affectedFiles?: string[];
+    files?: string[];
+    reproducible?: boolean;
+    reproSteps?: string[];
+    relatedInstructions?: string[];
+    labels?: string[];
+    source?: BugSource;
+    jiraKey?: string;
+    githubIssueUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+    fixedAt?: string;
+}
+/**
+ * Bugs file structure
+ * Can be .orchestrator/config/orchestrator.json (bugs array) or .ticket-mate/bugs.json
+ */
+export interface JmBugsFile {
+    bugs: JmBugRecord[];
+    lastUpdated?: string;
+}
+export interface JiraMateReplitWebhookTicket {
+    key: string;
+    projectKey: string;
+    summary: string;
+    status: string;
+    url: string;
+    updatedAt: string;
+}
+export interface JiraMateReplitWebhookBody {
+    event: 'tickets_synced';
+    source: 'ticket-mate';
+    repoName?: string;
+    repoUrl?: string;
+    defaultBranch?: string;
+    projectKey?: string;
+    tickets: JiraMateReplitWebhookTicket[];
+    syncedAt: string;
+}
+/**
+ * Get project config for a specific project key
+ */
+export declare function getProjectConfig(config: JmMateConfig, projectKey: string): JmMateProjectConfig | null;
+/**
+ * Get all project keys from config
+ */
+export declare function getAllProjectKeys(config: JmMateConfig): string[];
+//# sourceMappingURL=ticketMateTypes.d.ts.map

package/public/shared/ticketMateTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketMateTypes.d.ts","sourceRoot":"","sources":["../../src/shared/ticketMateTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEjC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE;YACP,OAAO,EAAE,OAAO,CAAC;SAClB,CAAC;QACF,MAAM,CAAC,EAAE;YACP,OAAO,EAAE,kBAAkB,EAAE,CAAC;YAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjE,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IAGnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAGlB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAGtB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAGlB,MAAM,CAAC,EAAE,SAAS,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAoB5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAchE"}

package/public/shared/ticketMateTypes.js

@@ -0,0 +1,56 @@
+/**
+ * Shared Jira Mate Types
+ *
+ * **CANONICAL TYPES** - Single source of truth for all Jira Mate consumers:
+ * - CLI
+ * - Next.js admin/webhook app
+ * - Replit Extension
+ *
+ * All consumers MUST import from this module (or mirror exactly).
+ *
+ * INVARIANTS:
+ * - Jira → truth for issues (tickets/bugs)
+ * - .ticket-mate/ → truth for local projection of Jira tickets & project metadata
+ * - .orchestrator/bugs.json → truth for local bugs, mirrored into Jira when promoted
+ */
+// ============================================================================
+// Helper Types
+// ============================================================================
+/**
+ * Get project config for a specific project key
+ */
+export function getProjectConfig(config, projectKey) {
+    // Check multi-project mode first
+    if (config.projects && Array.isArray(config.projects)) {
+        const project = config.projects.find(p => p.projectKey === projectKey);
+        if (project) {
+            return project;
+        }
+    }
+    // Fall back to legacy single-project mode
+    if (config.jiraProjectKey === projectKey) {
+        return {
+            projectKey,
+            jiraBaseUrl: config.jiraBaseUrl,
+            jiraCloudId: config.jiraCloudId,
+            defaultBranch: config.defaultBranch,
+        };
+    }
+    return null;
+}
+/**
+ * Get all project keys from config
+ */
+export function getAllProjectKeys(config) {
+    const keys = [];
+    // Multi-project mode
+    if (config.projects && Array.isArray(config.projects)) {
+        keys.push(...config.projects.map(p => p.projectKey));
+    }
+    // Legacy single-project mode
+    if (config.jiraProjectKey && !keys.includes(config.jiraProjectKey)) {
+        keys.push(config.jiraProjectKey);
+    }
+    return keys;
+}
+//# sourceMappingURL=ticketMateTypes.js.map

package/public/shared/ticketMateTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketMateTypes.js","sourceRoot":"","sources":["../../src/shared/ticketMateTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6LH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAoB,EACpB,UAAkB;IAElB,iCAAiC;IACjC,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACvE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IAAI,MAAM,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,OAAO;YACL,UAAU;YACV,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,qBAAqB;IACrB,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,111 @@
+/**
+ * Authoritative Ticket Sync Engine
+ *
+ * Governance Rules:
+ * 1. Jira is the source of truth for ticket existence
+ * 2. Markdown is never allowed to "invent" a Jira issue key
+ * 3. If an .md exists but the Jira issue does not exist (404), create a brand-new Jira issue
+ * 4. Before any MD is created, the Jira issue must already exist
+ * 5. MD → Jira validation: treat MD keys as hints only, validate existence
+ */
+import type { JiraConfig, JiraIssue } from "@/types";
+/**
+ * Sync direction
+ */
+export type SyncDirection = "jira-to-md" | "md-to-jira" | "bidirectional";
+/**
+ * Local ticket from markdown file
+ */
+export interface LocalTicket {
+    path: string;
+    title: string;
+    description: string;
+    markdownContent: string;
+    projectKey: string;
+    maybeIssueKey?: string;
+    canonicalId?: string;
+    frontmatter?: Record<string, unknown>;
+    lastModified?: Date;
+}
+/**
+ * Sync result for a single ticket
+ */
+export interface TicketSyncResult {
+    ticketKey: string;
+    action: "created" | "linked" | "updated" | "skipped" | "failed";
+    jiraCreated: boolean;
+    mdCreated: boolean;
+    mdUpdated: boolean;
+    error?: string;
+    oldKey?: string;
+}
+/**
+ * Overall sync operation result
+ */
+export interface AuthoritativeSyncResult {
+    success: boolean;
+    direction: SyncDirection;
+    scanned: number;
+    created: number;
+    linked: number;
+    updated: number;
+    skipped: number;
+    failed: number;
+    events: SyncEvent[];
+    results: TicketSyncResult[];
+}
+/**
+ * Audit event for sync operations
+ */
+export interface SyncEvent {
+    type: "MD_KEY_INVALID_CREATED_NEW_JIRA" | "ATLASSIAN_CREATED" | "MD_CREATED" | "MD_UPDATED" | "SYNC_ERROR";
+    timestamp: string;
+    ticketKey?: string;
+    oldKey?: string;
+    filePath?: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Options for authoritative sync
+ */
+export interface AuthoritativeSyncOptions {
+    direction?: SyncDirection;
+    projectKey?: string;
+    workspaceId?: string;
+    baseDir?: string;
+    dryRun?: boolean;
+    epicKey?: string;
+    issueType?: string;
+    labels?: string[];
+    /** Jira client to use */
+    client?: import("@/server/jira/jiraClient").JiraClient;
+}
+/**
+ * Ensure Jira issue exists (create if needed)
+ *
+ * This is the canonical function for ensuring a Jira issue exists before
+ * creating any markdown file. All code paths that create MD files should
+ * call this first.
+ */
+export declare function ensureJiraIssueExists(localTicket: LocalTicket, config: JiraConfig, options: AuthoritativeSyncOptions): Promise<{
+    issueKey: string;
+    created: boolean;
+    issue: JiraIssue;
+}>;
+/**
+ * Write markdown ticket file (only after Jira issue exists)
+ *
+ * This function enforces the governance rule: MD files are only created
+ * AFTER the Jira issue exists. It will throw an error if issue.key is missing.
+ */
+export declare function writeMarkdownTicket(issue: JiraIssue, localTicket: LocalTicket, baseDir: string, epicKey?: string): Promise<{
+    created: boolean;
+    updated: boolean;
+    path: string;
+}>;
+/**
+ * Canonical sync function - single source of truth
+ */
+export declare function syncTickets(config: JiraConfig, options?: AuthoritativeSyncOptions): Promise<AuthoritativeSyncResult>;
+//# sourceMappingURL=authoritative-sync.d.ts.map

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

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