@lusipad/pmspec 1.0.0

package/dist/core/importers.d.ts

@@ -0,0 +1,343 @@
+/**
+ * External Tool Importers Module
+ *
+ * Provides import functionality from external project management tools:
+ * - Jira: Epic → Category, Story/Task → Feature
+ * - Linear: Project → Epic, Issue → Feature
+ * - GitHub Issues: Milestone → Milestone, Issue → Feature, Labels → Skills/Tags
+ *
+ * Run `node setup-importers.js` from project root to extract this into
+ * separate files under src/importers/ directory.
+ */
+import { z } from 'zod';
+import type { SimpleFeature } from './simple-model.js';
+export type ImportSource = 'jira' | 'linear' | 'github';
+export declare const ImportOptionsSchema: z.ZodObject<{
+    file: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    merge: z.ZodDefault<z.ZodBoolean>;
+    outputFile: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ImportOptions = z.infer<typeof ImportOptionsSchema>;
+export interface ImportResult {
+    success: boolean;
+    source: ImportSource;
+    features: SimpleFeature[];
+    epics: ImportedEpic[];
+    milestones: ImportedMilestone[];
+    errors: ImportError[];
+    warnings: ImportWarning[];
+    stats: ImportStats;
+}
+export interface ImportedEpic {
+    id: string;
+    name: string;
+    description: string;
+    originalId?: string;
+    originalType?: string;
+}
+export interface ImportedMilestone {
+    id: string;
+    name: string;
+    description: string;
+    dueDate?: string;
+    originalId?: string;
+}
+export interface ImportError {
+    row?: number;
+    field?: string;
+    message: string;
+    originalItem?: unknown;
+}
+export interface ImportWarning {
+    row?: number;
+    field?: string;
+    message: string;
+}
+export interface ImportStats {
+    totalItems: number;
+    featuresImported: number;
+    epicsImported: number;
+    milestonesImported: number;
+    skipped: number;
+    errors: number;
+}
+export interface Importer {
+    name: string;
+    source: ImportSource;
+    description: string;
+    validate(content: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    import(options: ImportOptions): Promise<ImportResult>;
+    preview(options: ImportOptions): Promise<ImportResult>;
+}
+export declare const JiraIssueSchema: z.ZodObject<{
+    key: z.ZodString;
+    fields: z.ZodObject<{
+        summary: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        issuetype: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>;
+        priority: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            displayName: z.ZodString;
+        }, z.core.$strip>>>;
+        labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        timeoriginalestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        created: z.ZodOptional<z.ZodString>;
+        duedate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        parent: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            fields: z.ZodObject<{
+                summary: z.ZodString;
+                issuetype: z.ZodObject<{
+                    name: z.ZodString;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        customfield_10014: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type JiraIssue = z.infer<typeof JiraIssueSchema>;
+export declare const JiraExportSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        fields: z.ZodObject<{
+            summary: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            issuetype: z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>;
+            status: z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>;
+            priority: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>>;
+            assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                displayName: z.ZodString;
+            }, z.core.$strip>>>;
+            labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            timeoriginalestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            created: z.ZodOptional<z.ZodString>;
+            duedate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            parent: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                fields: z.ZodObject<{
+                    summary: z.ZodString;
+                    issuetype: z.ZodObject<{
+                        name: z.ZodString;
+                    }, z.core.$strip>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            customfield_10014: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type JiraExport = z.infer<typeof JiraExportSchema>;
+export declare const LinearIssueSchema: z.ZodObject<{
+    id: z.ZodString;
+    identifier: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    state: z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>;
+    priority: z.ZodNumber;
+    priorityLabel: z.ZodString;
+    estimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    project: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LinearIssue = z.infer<typeof LinearIssueSchema>;
+export declare const LinearExportSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        identifier: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        state: z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.core.$strip>;
+        priority: z.ZodNumber;
+        priorityLabel: z.ZodString;
+        estimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        labels: z.ZodOptional<z.ZodObject<{
+            nodes: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        project: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    projects: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LinearExport = z.infer<typeof LinearExportSchema>;
+export declare const GitHubIssueSchema: z.ZodObject<{
+    number: z.ZodNumber;
+    title: z.ZodString;
+    body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    state: z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>;
+    labels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$strip>>>;
+    assignees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$strip>>>;
+    milestone: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        number: z.ZodNumber;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        due_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    created_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GitHubIssue = z.infer<typeof GitHubIssueSchema>;
+export declare const GitHubExportSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        number: z.ZodNumber;
+        title: z.ZodString;
+        body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        state: z.ZodEnum<{
+            open: "open";
+            closed: "closed";
+        }>;
+        labels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            login: z.ZodString;
+        }, z.core.$strip>>>;
+        assignees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            login: z.ZodString;
+        }, z.core.$strip>>>;
+        milestone: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            number: z.ZodNumber;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            due_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        created_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    milestones: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        number: z.ZodNumber;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        due_on: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type GitHubExport = z.infer<typeof GitHubExportSchema>;
+declare abstract class BaseImporter implements Importer {
+    abstract name: string;
+    abstract source: ImportSource;
+    abstract description: string;
+    protected getContent(options: ImportOptions): Promise<string>;
+    protected parseJSON<T>(content: string): T;
+    protected createEmptyResult(): ImportResult;
+    protected generateFeatureId(prefix: string, index: number): string;
+    protected mapPriority(priority: string): 'low' | 'medium' | 'high' | 'critical';
+    protected mapStatus(status: string): 'todo' | 'in-progress' | 'done' | 'blocked';
+    protected formatDate(date: string | null | undefined): string | undefined;
+    protected convertToHours(seconds: number | null | undefined): number;
+    protected sanitizeId(name: string): string;
+    abstract validate(content: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    abstract import(options: ImportOptions): Promise<ImportResult>;
+    preview(options: ImportOptions): Promise<ImportResult>;
+    protected writeFeatures(features: SimpleFeature[], outputFile: string, merge: boolean): Promise<void>;
+}
+export declare class JiraImporter extends BaseImporter {
+    name: string;
+    source: ImportSource;
+    description: string;
+    validate(content: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    import(options: ImportOptions): Promise<ImportResult>;
+    private extractEpics;
+    private mapIssueToFeature;
+}
+export declare class LinearImporter extends BaseImporter {
+    name: string;
+    source: ImportSource;
+    description: string;
+    validate(content: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    import(options: ImportOptions): Promise<ImportResult>;
+    private extractProjects;
+    private mapLinearPriority;
+    private mapLinearState;
+    private mapIssueToFeature;
+}
+export declare class GitHubImporter extends BaseImporter {
+    name: string;
+    source: ImportSource;
+    description: string;
+    validate(content: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    import(options: ImportOptions): Promise<ImportResult>;
+    private extractMilestones;
+    private extractEpicsFromLabels;
+    private extractSkillsFromLabels;
+    private extractCategoryFromLabels;
+    private extractPriorityFromLabels;
+    private extractEstimateFromLabels;
+    private mapIssueToFeature;
+}
+export declare const jiraImporter: JiraImporter;
+export declare const linearImporter: LinearImporter;
+export declare const githubImporter: GitHubImporter;
+export declare function getImporter(source: ImportSource): Importer;
+export declare function getAllImporters(): Importer[];
+export declare function isValidSource(source: string): source is ImportSource;
+export {};
+//# sourceMappingURL=importers.d.ts.map