work-chronicler 0.1.0

package/dist/core/types/pr.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+/**
+ * PR impact levels for filtering and summarization
+ * - flagship: Large initiatives, platform changes, multi-PR efforts (500+ lines or 15+ files)
+ * - major: Significant features, larger refactors (200-499 lines or 8-14 files)
+ * - standard: Regular feature work, bug fixes, moderate changes (20-199 lines)
+ * - minor: Small fixes, typos, dependency bumps, docs (<20 lines)
+ */
+export const PRImpactSchema = z.enum([
+    'flagship',
+    'major',
+    'standard',
+    'minor',
+]);
+/**
+ * Schema for a Pull Request stored in the work-log
+ */
+export const PullRequestSchema = z.object({
+    title: z.string(),
+    prNumber: z.number(),
+    repository: z.string(),
+    org: z.string(),
+    author: z.string(),
+    state: z.enum(['open', 'closed', 'merged']),
+    createdAt: z.string().datetime(),
+    mergedAt: z.string().datetime().nullable(),
+    closedAt: z.string().datetime().nullable(),
+    url: z.string().url(),
+    additions: z.number(),
+    deletions: z.number(),
+    changedFiles: z.number(),
+    jiraTickets: z.array(z.string()).default([]),
+    labels: z.array(z.string()).default([]),
+    impact: PRImpactSchema.optional(),
+});

package/dist/core/types/project.d.ts

@@ -0,0 +1,450 @@
+import { z } from 'zod';
+/**
+ * Confidence level for project grouping detection
+ */
+export declare const ProjectConfidenceSchema: z.ZodEnum<["high", "medium", "low"]>;
+export type ProjectConfidence = z.infer<typeof ProjectConfidenceSchema>;
+/**
+ * Signal type that led to project grouping
+ */
+export declare const ProjectSignalSchema: z.ZodEnum<["tickets", "jiraProject", "time", "labels"]>;
+export type ProjectSignal = z.infer<typeof ProjectSignalSchema>;
+/**
+ * Signals that contributed to a project grouping
+ */
+export declare const ProjectSignalsSchema: z.ZodObject<{
+    sharedTickets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    jiraProject: z.ZodOptional<z.ZodString>;
+    timeRange: z.ZodOptional<z.ZodObject<{
+        earliest: z.ZodString;
+        latest: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        earliest: string;
+        latest: string;
+    }, {
+        earliest: string;
+        latest: string;
+    }>>;
+    sharedLabels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    commonKeywords: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    sharedTickets: string[];
+    sharedLabels: string[];
+    commonKeywords: string[];
+    jiraProject?: string | undefined;
+    timeRange?: {
+        earliest: string;
+        latest: string;
+    } | undefined;
+}, {
+    jiraProject?: string | undefined;
+    sharedTickets?: string[] | undefined;
+    timeRange?: {
+        earliest: string;
+        latest: string;
+    } | undefined;
+    sharedLabels?: string[] | undefined;
+    commonKeywords?: string[] | undefined;
+}>;
+export type ProjectSignals = z.infer<typeof ProjectSignalsSchema>;
+/**
+ * A detected project grouping of related PRs and tickets
+ */
+export declare const ProjectGroupingSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    prUrls: z.ZodArray<z.ZodString, "many">;
+    ticketKeys: z.ZodArray<z.ZodString, "many">;
+    signals: z.ZodObject<{
+        sharedTickets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        jiraProject: z.ZodOptional<z.ZodString>;
+        timeRange: z.ZodOptional<z.ZodObject<{
+            earliest: z.ZodString;
+            latest: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            earliest: string;
+            latest: string;
+        }, {
+            earliest: string;
+            latest: string;
+        }>>;
+        sharedLabels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        commonKeywords: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        sharedTickets: string[];
+        sharedLabels: string[];
+        commonKeywords: string[];
+        jiraProject?: string | undefined;
+        timeRange?: {
+            earliest: string;
+            latest: string;
+        } | undefined;
+    }, {
+        jiraProject?: string | undefined;
+        sharedTickets?: string[] | undefined;
+        timeRange?: {
+            earliest: string;
+            latest: string;
+        } | undefined;
+        sharedLabels?: string[] | undefined;
+        commonKeywords?: string[] | undefined;
+    }>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    dominantSignal: z.ZodEnum<["tickets", "jiraProject", "time", "labels"]>;
+    stats: z.ZodObject<{
+        prCount: z.ZodNumber;
+        ticketCount: z.ZodNumber;
+        totalAdditions: z.ZodNumber;
+        totalDeletions: z.ZodNumber;
+        repos: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        repos: string[];
+        prCount: number;
+        ticketCount: number;
+        totalAdditions: number;
+        totalDeletions: number;
+    }, {
+        repos: string[];
+        prCount: number;
+        ticketCount: number;
+        totalAdditions: number;
+        totalDeletions: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    projectId: string;
+    prUrls: string[];
+    ticketKeys: string[];
+    signals: {
+        sharedTickets: string[];
+        sharedLabels: string[];
+        commonKeywords: string[];
+        jiraProject?: string | undefined;
+        timeRange?: {
+            earliest: string;
+            latest: string;
+        } | undefined;
+    };
+    confidence: "high" | "medium" | "low";
+    dominantSignal: "labels" | "tickets" | "jiraProject" | "time";
+    stats: {
+        repos: string[];
+        prCount: number;
+        ticketCount: number;
+        totalAdditions: number;
+        totalDeletions: number;
+    };
+    description?: string | undefined;
+}, {
+    name: string;
+    projectId: string;
+    prUrls: string[];
+    ticketKeys: string[];
+    signals: {
+        jiraProject?: string | undefined;
+        sharedTickets?: string[] | undefined;
+        timeRange?: {
+            earliest: string;
+            latest: string;
+        } | undefined;
+        sharedLabels?: string[] | undefined;
+        commonKeywords?: string[] | undefined;
+    };
+    confidence: "high" | "medium" | "low";
+    dominantSignal: "labels" | "tickets" | "jiraProject" | "time";
+    stats: {
+        repos: string[];
+        prCount: number;
+        ticketCount: number;
+        totalAdditions: number;
+        totalDeletions: number;
+    };
+    description?: string | undefined;
+}>;
+export type ProjectGrouping = z.infer<typeof ProjectGroupingSchema>;
+/**
+ * Output of project detection analysis
+ */
+export declare const ProjectsAnalysisSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    dateRange: z.ZodObject<{
+        since: z.ZodString;
+        until: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        since: string;
+        until: string;
+    }, {
+        since: string;
+        until: string;
+    }>;
+    projects: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        prUrls: z.ZodArray<z.ZodString, "many">;
+        ticketKeys: z.ZodArray<z.ZodString, "many">;
+        signals: z.ZodObject<{
+            sharedTickets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            jiraProject: z.ZodOptional<z.ZodString>;
+            timeRange: z.ZodOptional<z.ZodObject<{
+                earliest: z.ZodString;
+                latest: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                earliest: string;
+                latest: string;
+            }, {
+                earliest: string;
+                latest: string;
+            }>>;
+            sharedLabels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            commonKeywords: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sharedTickets: string[];
+            sharedLabels: string[];
+            commonKeywords: string[];
+            jiraProject?: string | undefined;
+            timeRange?: {
+                earliest: string;
+                latest: string;
+            } | undefined;
+        }, {
+            jiraProject?: string | undefined;
+            sharedTickets?: string[] | undefined;
+            timeRange?: {
+                earliest: string;
+                latest: string;
+            } | undefined;
+            sharedLabels?: string[] | undefined;
+            commonKeywords?: string[] | undefined;
+        }>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        dominantSignal: z.ZodEnum<["tickets", "jiraProject", "time", "labels"]>;
+        stats: z.ZodObject<{
+            prCount: z.ZodNumber;
+            ticketCount: z.ZodNumber;
+            totalAdditions: z.ZodNumber;
+            totalDeletions: z.ZodNumber;
+            repos: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            repos: string[];
+            prCount: number;
+            ticketCount: number;
+            totalAdditions: number;
+            totalDeletions: number;
+        }, {
+            repos: string[];
+            prCount: number;
+            ticketCount: number;
+            totalAdditions: number;
+            totalDeletions: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        projectId: string;
+        prUrls: string[];
+        ticketKeys: string[];
+        signals: {
+            sharedTickets: string[];
+            sharedLabels: string[];
+            commonKeywords: string[];
+            jiraProject?: string | undefined;
+            timeRange?: {
+                earliest: string;
+                latest: string;
+            } | undefined;
+        };
+        confidence: "high" | "medium" | "low";
+        dominantSignal: "labels" | "tickets" | "jiraProject" | "time";
+        stats: {
+            repos: string[];
+            prCount: number;
+            ticketCount: number;
+            totalAdditions: number;
+            totalDeletions: number;
+        };
+        description?: string | undefined;
+    }, {
+        name: string;
+        projectId: string;
+        prUrls: string[];
+        ticketKeys: string[];
+        signals: {
+            jiraProject?: string | undefined;
+            sharedTickets?: string[] | undefined;
+            timeRange?: {
+                earliest: string;
+                latest: string;
+            } | undefined;
+            sharedLabels?: string[] | undefined;
+            commonKeywords?: string[] | undefined;
+        };
+        confidence: "high" | "medium" | "low";
+        dominantSignal: "labels" | "tickets" | "jiraProject" | "time";
+        stats: {
+            repos: string[];
+            prCount: number;
+            ticketCount: number;
+            totalAdditions: number;
+            totalDeletions: number;
+        };
+        description?: string | undefined;
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalProjects: z.ZodNumber;
+        byConfidence: z.ZodObject<{
+            high: z.ZodNumber;
+            medium: z.ZodNumber;
+            low: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            high: number;
+            medium: number;
+            low: number;
+        }, {
+            high: number;
+            medium: number;
+            low: number;
+        }>;
+        bySignal: z.ZodObject<{
+            tickets: z.ZodNumber;
+            jiraProject: z.ZodNumber;
+            time: z.ZodNumber;
+            labels: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            labels: number;
+            tickets: number;
+            jiraProject: number;
+            time: number;
+        }, {
+            labels: number;
+            tickets: number;
+            jiraProject: number;
+            time: number;
+        }>;
+        unassignedPRs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalProjects: number;
+        byConfidence: {
+            high: number;
+            medium: number;
+            low: number;
+        };
+        bySignal: {
+            labels: number;
+            tickets: number;
+            jiraProject: number;
+            time: number;
+        };
+        unassignedPRs: number;
+    }, {
+        totalProjects: number;
+        byConfidence: {
+            high: number;
+            medium: number;
+            low: number;
+        };
+        bySignal: {
+            labels: number;
+            tickets: number;
+            jiraProject: number;
+            time: number;
+        };
+        unassignedPRs: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    projects: {
+        name: string;
+        projectId: string;
+        prUrls: string[];
+        ticketKeys: string[];
+        signals: {
+            sharedTickets: string[];
+            sharedLabels: string[];
+            commonKeywords: string[];
+            jiraProject?: string | undefined;
+            timeRange?: {
+                earliest: string;
+                latest: string;
+            } | undefined;
+        };
+        confidence: "high" | "medium" | "low";
+        dominantSignal: "labels" | "tickets" | "jiraProject" | "time";
+        stats: {
+            repos: string[];
+            prCount: number;
+            ticketCount: number;
+            totalAdditions: number;
+            totalDeletions: number;
+        };
+        description?: string | undefined;
+    }[];
+    summary: {
+        totalProjects: number;
+        byConfidence: {
+            high: number;
+            medium: number;
+            low: number;
+        };
+        bySignal: {
+            labels: number;
+            tickets: number;
+            jiraProject: number;
+            time: number;
+        };
+        unassignedPRs: number;
+    };
+    generatedAt: string;
+    dateRange: {
+        since: string;
+        until: string;
+    };
+}, {
+    projects: {
+        name: string;
+        projectId: string;
+        prUrls: string[];
+        ticketKeys: string[];
+        signals: {
+            jiraProject?: string | undefined;
+            sharedTickets?: string[] | undefined;
+            timeRange?: {
+                earliest: string;
+                latest: string;
+            } | undefined;
+            sharedLabels?: string[] | undefined;
+            commonKeywords?: string[] | undefined;
+        };
+        confidence: "high" | "medium" | "low";
+        dominantSignal: "labels" | "tickets" | "jiraProject" | "time";
+        stats: {
+            repos: string[];
+            prCount: number;
+            ticketCount: number;
+            totalAdditions: number;
+            totalDeletions: number;
+        };
+        description?: string | undefined;
+    }[];
+    summary: {
+        totalProjects: number;
+        byConfidence: {
+            high: number;
+            medium: number;
+            low: number;
+        };
+        bySignal: {
+            labels: number;
+            tickets: number;
+            jiraProject: number;
+            time: number;
+        };
+        unassignedPRs: number;
+    };
+    generatedAt: string;
+    dateRange: {
+        since: string;
+        until: string;
+    };
+}>;
+export type ProjectsAnalysis = z.infer<typeof ProjectsAnalysisSchema>;
+//# sourceMappingURL=project.d.ts.map

package/dist/core/types/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/core/types/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,uBAAuB,sCAAoC,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,mBAAmB,yDAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/core/types/project.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+/**
+ * Confidence level for project grouping detection
+ */
+export const ProjectConfidenceSchema = z.enum(['high', 'medium', 'low']);
+/**
+ * Signal type that led to project grouping
+ */
+export const ProjectSignalSchema = z.enum([
+    'tickets', // PRs share JIRA tickets
+    'jiraProject', // PRs in same JIRA project
+    'time', // PRs within time proximity
+    'labels', // PRs share labels/patterns
+]);
+/**
+ * Signals that contributed to a project grouping
+ */
+export const ProjectSignalsSchema = z.object({
+    sharedTickets: z.array(z.string()).default([]),
+    jiraProject: z.string().optional(),
+    timeRange: z
+        .object({
+        earliest: z.string(),
+        latest: z.string(),
+    })
+        .optional(),
+    sharedLabels: z.array(z.string()).default([]),
+    commonKeywords: z.array(z.string()).default([]),
+});
+/**
+ * A detected project grouping of related PRs and tickets
+ */
+export const ProjectGroupingSchema = z.object({
+    projectId: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    prUrls: z.array(z.string()),
+    ticketKeys: z.array(z.string()),
+    signals: ProjectSignalsSchema,
+    confidence: ProjectConfidenceSchema,
+    dominantSignal: ProjectSignalSchema,
+    stats: z.object({
+        prCount: z.number(),
+        ticketCount: z.number(),
+        totalAdditions: z.number(),
+        totalDeletions: z.number(),
+        repos: z.array(z.string()),
+    }),
+});
+/**
+ * Output of project detection analysis
+ */
+export const ProjectsAnalysisSchema = z.object({
+    generatedAt: z.string(),
+    dateRange: z.object({
+        since: z.string(),
+        until: z.string(),
+    }),
+    projects: z.array(ProjectGroupingSchema),
+    summary: z.object({
+        totalProjects: z.number(),
+        byConfidence: z.object({
+            high: z.number(),
+            medium: z.number(),
+            low: z.number(),
+        }),
+        bySignal: z.object({
+            tickets: z.number(),
+            jiraProject: z.number(),
+            time: z.number(),
+            labels: z.number(),
+        }),
+        unassignedPRs: z.number(),
+    }),
+});

package/dist/core/types/ticket.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Schema for a JIRA ticket stored in the work-log
+ */
+export declare const JiraTicketSchema: z.ZodObject<{
+    key: z.ZodString;
+    summary: z.ZodString;
+    project: z.ZodString;
+    org: z.ZodString;
+    issueType: z.ZodString;
+    status: z.ZodString;
+    storyPoints: z.ZodNullable<z.ZodNumber>;
+    url: z.ZodString;
+    createdAt: z.ZodString;
+    resolvedAt: z.ZodNullable<z.ZodString>;
+    linkedPRs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    url: string;
+    org: string;
+    createdAt: string;
+    key: string;
+    summary: string;
+    project: string;
+    issueType: string;
+    storyPoints: number | null;
+    resolvedAt: string | null;
+    linkedPRs: string[];
+}, {
+    status: string;
+    url: string;
+    org: string;
+    createdAt: string;
+    key: string;
+    summary: string;
+    project: string;
+    issueType: string;
+    storyPoints: number | null;
+    resolvedAt: string | null;
+    linkedPRs?: string[] | undefined;
+}>;
+export type JiraTicket = z.infer<typeof JiraTicketSchema>;
+/**
+ * Ticket file with frontmatter and body content
+ */
+export interface JiraTicketFile {
+    frontmatter: JiraTicket;
+    body: string;
+    filePath: string;
+}
+//# sourceMappingURL=ticket.d.ts.map

package/dist/core/types/ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../../src/core/types/ticket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,UAAU,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/core/types/ticket.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+/**
+ * Schema for a JIRA ticket stored in the work-log
+ */
+export const JiraTicketSchema = z.object({
+    key: z.string(),
+    summary: z.string(),
+    project: z.string(),
+    org: z.string(),
+    issueType: z.string(),
+    status: z.string(),
+    storyPoints: z.number().nullable(),
+    url: z.string(), // Not validated as URL since config may have typos
+    createdAt: z.string(), // Not strict datetime since JIRA uses various formats
+    resolvedAt: z.string().nullable(),
+    linkedPRs: z.array(z.string()).default([]),
+});