@guidemode/session-processing 0.1.43

package/dist/cjs/ui/utils/todos/todoUtils.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Shared utilities for processing todos
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simpleHash = simpleHash;
+exports.getTodoListId = getTodoListId;
+exports.enrichTodosWithTiming = enrichTodosWithTiming;
+exports.groupTodoLists = groupTodoLists;
+exports.formatDuration = formatDuration;
+/**
+ * Simple hash function for creating unique IDs
+ */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return Math.abs(hash).toString(36);
+}
+/**
+ * Create a unique ID for a todo list based on its first item only
+ * This allows lists to grow/shrink while still being recognized as the same list
+ * The first item never changes, but subsequent items often do
+ */
+function getTodoListId(todos) {
+    if (todos.length === 0)
+        return 'empty';
+    // Use only the first item to identify the list
+    // This way, lists that differ in any other items are still grouped together
+    return simpleHash(todos[0].content);
+}
+/**
+ * Enrich todos with timing info by searching through ALL session updates
+ */
+function enrichTodosWithTiming(latestUpdate, allUpdates) {
+    const enrichedTodos = [];
+    // For each todo in the latest version, track its timing across ALL updates in the entire session
+    for (const latestTodo of latestUpdate.todos) {
+        let startTime;
+        let endTime;
+        // Search through ALL updates chronologically to find status changes for THIS specific todo
+        for (const update of allUpdates) {
+            // Find this todo in the current update by matching content
+            const todoInUpdate = update.todos.find(t => t.content === latestTodo.content);
+            if (!todoInUpdate)
+                continue;
+            // Record when it first became in_progress
+            if (todoInUpdate.status === 'in_progress' && !startTime) {
+                startTime = update.timestamp;
+            }
+            // Record when it completed
+            if (todoInUpdate.status === 'completed' && !endTime) {
+                endTime = update.timestamp;
+            }
+        }
+        // Calculate duration if both times exist
+        const durationMs = startTime && endTime ? new Date(endTime).getTime() - new Date(startTime).getTime() : undefined;
+        enrichedTodos.push({
+            ...latestTodo,
+            startTime,
+            endTime,
+            durationMs,
+        });
+    }
+    return enrichedTodos;
+}
+/**
+ * Find unique todo lists, keeping only the LATEST occurrence of each
+ */
+function groupTodoLists(allUpdates) {
+    // Map of list ID -> latest update with that ID
+    const latestByListId = new Map();
+    // Process chronologically - later updates overwrite earlier ones
+    for (const update of allUpdates) {
+        const listId = getTodoListId(update.todos);
+        if (!latestByListId.has(listId)) {
+            latestByListId.set(listId, { update, allMatches: [update] });
+        }
+        else {
+            const existing = latestByListId.get(listId);
+            if (existing) {
+                existing.allMatches.push(update);
+                existing.update = update; // Keep the latest one
+            }
+        }
+    }
+    // Convert to TodoListGroup array
+    const groups = [];
+    for (const [id, { update: latestUpdate, allMatches }] of latestByListId.entries()) {
+        // Enrich todos with timing info from ALL updates (not just this list's updates)
+        const enrichedTodos = enrichTodosWithTiming(latestUpdate, allUpdates);
+        groups.push({
+            id,
+            updates: allMatches, // All updates for this specific list
+            latestUpdate,
+            enrichedTodos,
+            firstSeen: allMatches[0].timestamp,
+            lastSeen: latestUpdate.timestamp,
+        });
+    }
+    // Sort by last seen (most recent first when showing all)
+    return groups.sort((a, b) => new Date(b.lastSeen).getTime() - new Date(a.lastSeen).getTime());
+}
+/**
+ * Format milliseconds as human-readable duration
+ */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        const remainingMinutes = minutes % 60;
+        return `${hours}h ${remainingMinutes}m`;
+    }
+    if (minutes > 0) {
+        const remainingSeconds = seconds % 60;
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    return `${seconds}s`;
+}
+//# sourceMappingURL=todoUtils.js.map

package/dist/cjs/ui/utils/todos/todoUtils.js.map

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

package/dist/cjs/ui/utils/todos/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared types for todo extraction across providers
+ */
+export interface TodoItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm: string;
+}
+export interface TodoUpdate {
+    id: string;
+    timestamp: string;
+    todos: TodoItem[];
+    messageIndex: number;
+}
+export interface EnrichedTodoItem extends TodoItem {
+    startTime?: string;
+    endTime?: string;
+    durationMs?: number;
+}
+export interface TodoListGroup {
+    id: string;
+    updates: TodoUpdate[];
+    latestUpdate: TodoUpdate;
+    enrichedTodos: EnrichedTodoItem[];
+    firstSeen: string;
+    lastSeen: string;
+}
+/**
+ * Interface for provider-specific todo extractors
+ */
+export interface TodoExtractor {
+    /**
+     * Extract todo updates from session file content
+     */
+    extractTodos(fileContent: string): TodoUpdate[];
+    /**
+     * Provider name
+     */
+    readonly providerName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/ui/utils/todos/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/todos/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAA;IAC/C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,YAAY,EAAE,UAAU,CAAA;IACxB,aAAa,EAAE,gBAAgB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE,CAAA;IAE/C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B"}

package/dist/cjs/ui/utils/todos/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared types for todo extraction across providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/ui/utils/todos/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/ui/utils/todos/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/utils/git-url.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Git URL utilities for building GitHub links
+ */
+/**
+ * Extracts owner and repo from various GitHub URL formats
+ * Handles both SSH and HTTPS formats:
+ * - SSH: git@github.com:owner/repo.git
+ * - HTTPS: https://github.com/owner/repo.git
+ * - HTTPS (no .git): https://github.com/owner/repo
+ */
+export declare function parseGitHubUrl(url: string | null | undefined): {
+    owner: string;
+    repo: string;
+} | null;
+/**
+ * Builds a GitHub compare/diff URL for two commits
+ * Returns null if unable to build URL (invalid git URL, missing commits, or commits are identical)
+ *
+ * @param gitRemoteUrl - The Git remote URL (SSH or HTTPS format)
+ * @param firstCommit - The first commit hash
+ * @param latestCommit - The latest commit hash
+ * @returns GitHub compare URL or null
+ */
+export declare function buildGitHubDiffUrl(gitRemoteUrl: string | null | undefined, firstCommit: string | null | undefined, latestCommit: string | null | undefined): string | null;
+//# sourceMappingURL=git-url.d.ts.map

package/dist/cjs/utils/git-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-url.d.ts","sourceRoot":"","sources":["../../../src/utils/git-url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsBxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,MAAM,GAAG,IAAI,CAcf"}

package/dist/cjs/utils/git-url.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Git URL utilities for building GitHub links
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseGitHubUrl = parseGitHubUrl;
+exports.buildGitHubDiffUrl = buildGitHubDiffUrl;
+/**
+ * Extracts owner and repo from various GitHub URL formats
+ * Handles both SSH and HTTPS formats:
+ * - SSH: git@github.com:owner/repo.git
+ * - HTTPS: https://github.com/owner/repo.git
+ * - HTTPS (no .git): https://github.com/owner/repo
+ */
+function parseGitHubUrl(url) {
+    if (!url)
+        return null;
+    // Try SSH format first: git@github.com:owner/repo.git
+    const sshMatch = url.match(/git@github\.com:([^/]+)\/([^/.]+)(\.git)?/);
+    if (sshMatch) {
+        return {
+            owner: sshMatch[1],
+            repo: sshMatch[2],
+        };
+    }
+    // Try HTTPS format: https://github.com/owner/repo(.git)?
+    const httpsMatch = url.match(/https?:\/\/github\.com\/([^/]+)\/([^/.]+)(\.git)?/);
+    if (httpsMatch) {
+        return {
+            owner: httpsMatch[1],
+            repo: httpsMatch[2],
+        };
+    }
+    return null;
+}
+/**
+ * Builds a GitHub compare/diff URL for two commits
+ * Returns null if unable to build URL (invalid git URL, missing commits, or commits are identical)
+ *
+ * @param gitRemoteUrl - The Git remote URL (SSH or HTTPS format)
+ * @param firstCommit - The first commit hash
+ * @param latestCommit - The latest commit hash
+ * @returns GitHub compare URL or null
+ */
+function buildGitHubDiffUrl(gitRemoteUrl, firstCommit, latestCommit) {
+    // Validate inputs
+    if (!gitRemoteUrl || !firstCommit || !latestCommit)
+        return null;
+    // If commits are the same, no diff to show
+    if (firstCommit === latestCommit)
+        return null;
+    // Parse the GitHub URL to extract owner and repo
+    const repoInfo = parseGitHubUrl(gitRemoteUrl);
+    if (!repoInfo)
+        return null;
+    // Build the compare URL
+    // GitHub compare syntax: https://github.com/{owner}/{repo}/compare/{base}...{head}
+    return `https://github.com/${repoInfo.owner}/${repoInfo.repo}/compare/${firstCommit}...${latestCommit}`;
+}
+//# sourceMappingURL=git-url.js.map

package/dist/cjs/utils/git-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-url.js","sourceRoot":"","sources":["../../../src/utils/git-url.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,wCAwBC;AAWD,gDAkBC;AA5DD;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,GAA8B;IAE9B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IAErB,sDAAsD;IACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;IACvE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;YAClB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;SAClB,CAAA;IACH,CAAC;IAED,yDAAyD;IACzD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACjF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;YACpB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;SACpB,CAAA;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAChC,YAAuC,EACvC,WAAsC,EACtC,YAAuC;IAEvC,kBAAkB;IAClB,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAE/D,2CAA2C;IAC3C,IAAI,WAAW,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IAE7C,iDAAiD;IACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE1B,wBAAwB;IACxB,mFAAmF;IACnF,OAAO,sBAAsB,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,YAAY,WAAW,MAAM,YAAY,EAAE,CAAA;AACzG,CAAC"}

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility Functions - Shared utilities for session processing
+ */
+export * from './rating.js';
+export * from './user.js';
+export * from './git-url.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Utility Functions - Shared utilities for session processing
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./rating.js"), exports);
+__exportStar(require("./user.js"), exports);
+__exportStar(require("./git-url.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,8CAA2B;AAC3B,4CAAyB;AACzB,+CAA4B"}

package/dist/cjs/utils/rating.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Rating Utility - Calculate session rating from assessment responses
+ */
+export type SessionRating = 'thumbs_up' | 'meh' | 'thumbs_down';
+export interface AssessmentAnswer {
+    type: 'likert' | 'text' | 'choice' | 'skipped';
+    value?: number | string;
+}
+export interface AssessmentResponse {
+    questionId: string;
+    answer: AssessmentAnswer;
+    timestamp: string;
+}
+export interface AssessmentQuestionConfig {
+    id: string;
+    text: string;
+    type: string;
+    category: string;
+    importance: string;
+    version: string[];
+    required: boolean;
+    labels?: [string, string];
+    choices?: string[];
+    placeholder?: string;
+    helpText?: string;
+}
+/**
+ * Calculate session rating from assessment responses
+ *
+ * Logic: Uses the NPS question (nps_score)
+ * - 0-6 = thumbs_down (Detractors)
+ * - 7-8 = meh (Passives)
+ * - 9-10 = thumbs_up (Promoters)
+ *
+ * @param responses - Array of assessment responses
+ * @param questions - Array of question configurations (optional, for validation)
+ * @returns Session rating or null if cannot be determined
+ */
+export declare function calculateRating(responses: AssessmentResponse[], _questions?: AssessmentQuestionConfig[]): SessionRating | null;
+/**
+ * Convert rating to NPS score
+ *
+ * Reverse mapping of calculateRating()
+ * - thumbs_down → 5 (Detractors: 0-6)
+ * - meh → 7 (Passives: 7-8)
+ * - thumbs_up → 9 (Promoters: 9-10)
+ *
+ * @param rating - Session rating
+ * @returns NPS score (0-10) or null if no rating
+ */
+export declare function ratingToNpsScore(rating: SessionRating | null): number | null;
+/**
+ * Get rating display information
+ */
+export interface RatingDisplayInfo {
+    label: string;
+    color: 'success' | 'warning' | 'error' | 'neutral';
+    icon: 'thumb-up' | 'meh' | 'thumb-down' | 'neutral';
+}
+export declare function getRatingDisplayInfo(rating: SessionRating | null): RatingDisplayInfo;
+//# sourceMappingURL=rating.d.ts.map

package/dist/cjs/utils/rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../../src/utils/rating.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,KAAK,GAAG,aAAa,CAAA;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,kBAAkB,EAAE,EAC/B,UAAU,CAAC,EAAE,wBAAwB,EAAE,GACtC,aAAa,GAAG,IAAI,CA6BtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAW5E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAClD,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CAAA;CACpD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,iBAAiB,CA2BpF"}

package/dist/cjs/utils/rating.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Rating Utility - Calculate session rating from assessment responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateRating = calculateRating;
+exports.ratingToNpsScore = ratingToNpsScore;
+exports.getRatingDisplayInfo = getRatingDisplayInfo;
+/**
+ * Calculate session rating from assessment responses
+ *
+ * Logic: Uses the NPS question (nps_score)
+ * - 0-6 = thumbs_down (Detractors)
+ * - 7-8 = meh (Passives)
+ * - 9-10 = thumbs_up (Promoters)
+ *
+ * @param responses - Array of assessment responses
+ * @param questions - Array of question configurations (optional, for validation)
+ * @returns Session rating or null if cannot be determined
+ */
+function calculateRating(responses, _questions) {
+    // Find the NPS question response (nps_score)
+    const npsResponse = responses.find(r => r.questionId === 'nps_score');
+    if (!npsResponse) {
+        return null;
+    }
+    const answer = npsResponse.answer;
+    // Only process likert-type answers
+    if (answer.type !== 'likert' || typeof answer.value !== 'number') {
+        return null;
+    }
+    const score = answer.value;
+    // Map NPS score to rating
+    if (score >= 0 && score <= 6) {
+        return 'thumbs_down'; // Detractors
+    }
+    if (score >= 7 && score <= 8) {
+        return 'meh'; // Passives
+    }
+    if (score >= 9 && score <= 10) {
+        return 'thumbs_up'; // Promoters
+    }
+    return null;
+}
+/**
+ * Convert rating to NPS score
+ *
+ * Reverse mapping of calculateRating()
+ * - thumbs_down → 5 (Detractors: 0-6)
+ * - meh → 7 (Passives: 7-8)
+ * - thumbs_up → 9 (Promoters: 9-10)
+ *
+ * @param rating - Session rating
+ * @returns NPS score (0-10) or null if no rating
+ */
+function ratingToNpsScore(rating) {
+    switch (rating) {
+        case 'thumbs_down':
+            return 5; // Mid-point of detractors (0-6)
+        case 'meh':
+            return 7; // Lower end of passives (7-8)
+        case 'thumbs_up':
+            return 9; // Lower end of promoters (9-10)
+        default:
+            return null;
+    }
+}
+function getRatingDisplayInfo(rating) {
+    switch (rating) {
+        case 'thumbs_up':
+            return {
+                label: 'Thumbs Up',
+                color: 'success',
+                icon: 'thumb-up',
+            };
+        case 'meh':
+            return {
+                label: 'Meh / So-So',
+                color: 'warning',
+                icon: 'meh',
+            };
+        case 'thumbs_down':
+            return {
+                label: 'Thumbs Down',
+                color: 'error',
+                icon: 'thumb-down',
+            };
+        default:
+            return {
+                label: 'Not Rated',
+                color: 'neutral',
+                icon: 'neutral',
+            };
+    }
+}
+//# sourceMappingURL=rating.js.map

package/dist/cjs/utils/rating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.js","sourceRoot":"","sources":["../../../src/utils/rating.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAyCH,0CAgCC;AAaD,4CAWC;AAWD,oDA2BC;AA1GD;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAC7B,SAA+B,EAC/B,UAAuC;IAEvC,6CAA6C;IAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,WAAW,CAAC,CAAA;IAErE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAA;IAEjC,mCAAmC;IACnC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAE1B,0BAA0B;IAC1B,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,aAAa,CAAA,CAAC,aAAa;IACpC,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAA,CAAC,WAAW;IAC1B,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAA,CAAC,YAAY;IACjC,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,MAA4B;IAC3D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa;YAChB,OAAO,CAAC,CAAA,CAAC,gCAAgC;QAC3C,KAAK,KAAK;YACR,OAAO,CAAC,CAAA,CAAC,8BAA8B;QACzC,KAAK,WAAW;YACd,OAAO,CAAC,CAAA,CAAC,gCAAgC;QAC3C;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAWD,SAAgB,oBAAoB,CAAC,MAA4B;IAC/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW;YACd,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,UAAU;aACjB,CAAA;QACH,KAAK,KAAK;YACR,OAAO;gBACL,KAAK,EAAE,aAAa;gBACpB,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,KAAK;aACZ,CAAA;QACH,KAAK,aAAa;YAChB,OAAO;gBACL,KAAK,EAAE,aAAa;gBACpB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,YAAY;aACnB,CAAA;QACH;YACE,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,SAAS;aAChB,CAAA;IACL,CAAC;AACH,CAAC"}

package/dist/cjs/utils/safe-access.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Safe property access utilities for unknown objects
+ * Provides type-safe ways to access properties on loosely-typed objects
+ */
+/**
+ * Check if value is a non-null object
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if object has a specific property
+ */
+export declare function hasProperty<K extends string>(obj: unknown, key: K): obj is Record<K, unknown>;
+/**
+ * Safely get a string property from an object
+ */
+export declare function getString(obj: unknown, key: string): string | undefined;
+/**
+ * Safely get a number property from an object
+ */
+export declare function getNumber(obj: unknown, key: string): number | undefined;
+/**
+ * Safely get a boolean property from an object
+ */
+export declare function getBoolean(obj: unknown, key: string): boolean | undefined;
+/**
+ * Safely get an object property from an object
+ */
+export declare function getObject(obj: unknown, key: string): Record<string, unknown> | undefined;
+/**
+ * Safely get an array property from an object
+ */
+export declare function getArray(obj: unknown, key: string): unknown[] | undefined;
+/**
+ * Safely get any property from an object
+ */
+export declare function get(obj: unknown, key: string): unknown;
+/**
+ * Type guard for checking if array contains objects with specific type field
+ */
+export declare function isArrayOfType<T extends string>(arr: unknown, typeValue: T): arr is Array<{
+    type: T;
+}>;
+//# sourceMappingURL=safe-access.d.ts.map

package/dist/cjs/utils/safe-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-access.d.ts","sourceRoot":"","sources":["../../../src/utils/safe-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAKxF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,SAAS,CAKzE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,CAAC,GACX,GAAG,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAK3B"}

package/dist/cjs/utils/safe-access.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Safe property access utilities for unknown objects
+ * Provides type-safe ways to access properties on loosely-typed objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isObject = isObject;
+exports.hasProperty = hasProperty;
+exports.getString = getString;
+exports.getNumber = getNumber;
+exports.getBoolean = getBoolean;
+exports.getObject = getObject;
+exports.getArray = getArray;
+exports.get = get;
+exports.isArrayOfType = isArrayOfType;
+/**
+ * Check if value is a non-null object
+ */
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Check if object has a specific property
+ */
+function hasProperty(obj, key) {
+    return isObject(obj) && key in obj;
+}
+/**
+ * Safely get a string property from an object
+ */
+function getString(obj, key) {
+    if (hasProperty(obj, key) && typeof obj[key] === 'string') {
+        return obj[key];
+    }
+    return undefined;
+}
+/**
+ * Safely get a number property from an object
+ */
+function getNumber(obj, key) {
+    if (hasProperty(obj, key) && typeof obj[key] === 'number') {
+        return obj[key];
+    }
+    return undefined;
+}
+/**
+ * Safely get a boolean property from an object
+ */
+function getBoolean(obj, key) {
+    if (hasProperty(obj, key) && typeof obj[key] === 'boolean') {
+        return obj[key];
+    }
+    return undefined;
+}
+/**
+ * Safely get an object property from an object
+ */
+function getObject(obj, key) {
+    if (hasProperty(obj, key) && isObject(obj[key])) {
+        return obj[key];
+    }
+    return undefined;
+}
+/**
+ * Safely get an array property from an object
+ */
+function getArray(obj, key) {
+    if (hasProperty(obj, key) && Array.isArray(obj[key])) {
+        return obj[key];
+    }
+    return undefined;
+}
+/**
+ * Safely get any property from an object
+ */
+function get(obj, key) {
+    if (hasProperty(obj, key)) {
+        return obj[key];
+    }
+    return undefined;
+}
+/**
+ * Type guard for checking if array contains objects with specific type field
+ */
+function isArrayOfType(arr, typeValue) {
+    return (Array.isArray(arr) &&
+        arr.some(item => isObject(item) && hasProperty(item, 'type') && item.type === typeValue));
+}
+//# sourceMappingURL=safe-access.js.map

package/dist/cjs/utils/safe-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-access.js","sourceRoot":"","sources":["../../../src/utils/safe-access.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAKH,4BAEC;AAKD,kCAEC;AAKD,8BAKC;AAKD,8BAKC;AAKD,gCAKC;AAKD,8BAKC;AAKD,4BAKC;AAKD,kBAKC;AAKD,sCAQC;AArFD;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAmB,GAAY,EAAE,GAAM;IAChE,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,GAAY,EAAE,GAAW;IACjD,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,GAAY,EAAE,GAAW;IACjD,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,GAAY,EAAE,GAAW;IAClD,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,GAAY,EAAE,GAAW;IACjD,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,GAAG,CAAC,GAAG,CAA4B,CAAA;IAC5C,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,GAAY,EAAE,GAAW;IAChD,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,GAAG,CAAC,GAAG,CAAc,CAAA;IAC9B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,GAAG,CAAC,GAAY,EAAE,GAAW;IAC3C,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,GAAY,EACZ,SAAY;IAEZ,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CACzF,CAAA;AACH,CAAC"}

package/dist/cjs/utils/user.d.ts

@@ -0,0 +1,22 @@
+/**
+ * User utility functions
+ */
+export interface UserInfo {
+    name?: string | null;
+    username?: string | null;
+    email?: string | null;
+}
+/**
+ * Extract a friendly display name from user information
+ * Tries to extract first name from full name, falls back to @username
+ *
+ * @param user - User information with optional name, username, email
+ * @returns Display name suitable for AI prompts (e.g., "John" or "@johndoe")
+ *
+ * @example
+ * getUserDisplayName({ name: "John Doe", username: "johndoe" }) // Returns "John"
+ * getUserDisplayName({ username: "johndoe" }) // Returns "@johndoe"
+ * getUserDisplayName({ email: "john@example.com" }) // Returns "@john"
+ */
+export declare function getUserDisplayName(user: UserInfo): string;
+//# sourceMappingURL=user.d.ts.map