@ginkoai/cli 2.0.0-beta.4 → 2.0.0-beta.5

package/dist/lib/staleness-detector.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [staleness, detection, team, sync, EPIC-008]
+ * @related: [../commands/sync/team-sync.ts, ../commands/start/start-reflection.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+export interface StalenessConfig {
+    /** Days before showing warning (default: 1) */
+    warningThresholdDays: number;
+    /** Days before showing critical warning (default: 7) */
+    criticalThresholdDays: number;
+}
+export interface ChangedSinceSync {
+    adrs: number;
+    patterns: number;
+    sprints: number;
+    total: number;
+}
+export interface StalenessResult {
+    /** Whether context is stale (exceeds warning threshold) */
+    isStale: boolean;
+    /** Severity level based on days since sync */
+    severity: 'none' | 'warning' | 'critical';
+    /** Number of days since last sync (Infinity if never synced) */
+    daysSinceSync: number;
+    /** ISO timestamp of last sync, null if never synced */
+    lastSyncAt: string | null;
+    /** Count of changes by category since last sync */
+    changedSinceSync: ChangedSinceSync;
+    /** Human-readable message describing staleness state */
+    message: string;
+}
+/**
+ * Check staleness of team context for current user
+ *
+ * @param graphId - The graph ID to check
+ * @param token - Bearer token for authentication
+ * @param config - Optional staleness configuration
+ * @returns StalenessResult with severity, days since sync, and changes
+ *
+ * @example
+ * ```typescript
+ * const result = await checkStaleness(graphId, token, {
+ *   warningThresholdDays: 1,
+ *   criticalThresholdDays: 7,
+ * });
+ *
+ * if (result.severity === 'critical') {
+ *   console.log(chalk.red(result.message));
+ * }
+ * ```
+ */
+export declare function checkStaleness(graphId: string, token: string, config?: Partial<StalenessConfig>): Promise<StalenessResult>;
+/**
+ * Display staleness warning in CLI with appropriate styling
+ *
+ * @param result - The staleness check result
+ */
+export declare function displayStalenessWarning(result: StalenessResult): void;
+/**
+ * Calculate number of days since last sync
+ */
+declare function calculateDaysSinceSync(lastSyncAt: string | null): number;
+/**
+ * Determine severity based on days since sync and config thresholds
+ */
+declare function determineSeverity(daysSinceSync: number, config: StalenessConfig): 'none' | 'warning' | 'critical';
+/**
+ * Format human-readable message based on staleness state
+ */
+declare function formatMessage(severity: 'none' | 'warning' | 'critical', daysSinceSync: number, lastSyncAt: string | null, changes: ChangedSinceSync): string;
+/**
+ * Format relative time for display
+ */
+declare function formatRelativeTime(dateStr: string): string;
+export declare const _internal: {
+    calculateDaysSinceSync: typeof calculateDaysSinceSync;
+    determineSeverity: typeof determineSeverity;
+    formatMessage: typeof formatMessage;
+    formatRelativeTime: typeof formatRelativeTime;
+    DEFAULT_CONFIG: StalenessConfig;
+};
+export {};
+//# sourceMappingURL=staleness-detector.d.ts.map

package/dist/lib/staleness-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness-detector.d.ts","sourceRoot":"","sources":["../../src/lib/staleness-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mDAAmD;IACnD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,eAAe,CAAC,CAwF1B;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAiCrE;AAMD;;GAEG;AACH,iBAAS,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAWjE;AAED;;GAEG;AACH,iBAAS,iBAAiB,CACxB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,eAAe,GACtB,MAAM,GAAG,SAAS,GAAG,UAAU,CAQjC;AA8CD;;GAEG;AACH,iBAAS,aAAa,CACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EACzC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAqBR;AAED;;GAEG;AACH,iBAAS,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAanD;AAaD,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}

package/dist/lib/staleness-detector.js

@@ -0,0 +1,290 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [staleness, detection, team, sync, EPIC-008]
+ * @related: [../commands/sync/team-sync.ts, ../commands/start/start-reflection.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+/**
+ * Staleness Detection System (EPIC-008 Sprint 2)
+ *
+ * Provides comprehensive staleness detection for team context synchronization.
+ * Used by both CLI (ginko start) and Dashboard (StalenessWarning component).
+ *
+ * Key features:
+ * - Configurable warning/critical thresholds
+ * - Tracks changes since last sync (ADRs, Patterns, Sprints)
+ * - Human-readable messages for different severity levels
+ */
+import chalk from 'chalk';
+// =============================================================================
+// Constants
+// =============================================================================
+const API_BASE = process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+const DEFAULT_CONFIG = {
+    warningThresholdDays: 1,
+    criticalThresholdDays: 7,
+};
+// =============================================================================
+// Main API
+// =============================================================================
+/**
+ * Check staleness of team context for current user
+ *
+ * @param graphId - The graph ID to check
+ * @param token - Bearer token for authentication
+ * @param config - Optional staleness configuration
+ * @returns StalenessResult with severity, days since sync, and changes
+ *
+ * @example
+ * ```typescript
+ * const result = await checkStaleness(graphId, token, {
+ *   warningThresholdDays: 1,
+ *   criticalThresholdDays: 7,
+ * });
+ *
+ * if (result.severity === 'critical') {
+ *   console.log(chalk.red(result.message));
+ * }
+ * ```
+ */
+export async function checkStaleness(graphId, token, config) {
+    const mergedConfig = {
+        ...DEFAULT_CONFIG,
+        ...config,
+    };
+    try {
+        // Fetch membership status (includes last_sync_at)
+        const membershipUrl = new URL(`${API_BASE}/api/v1/graph/membership`);
+        membershipUrl.searchParams.set('graphId', graphId);
+        const membershipResponse = await fetch(membershipUrl.toString(), {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (membershipResponse.status === 404) {
+            // User is not a team member - return non-stale (no team context to sync)
+            return createResult({
+                isStale: false,
+                severity: 'none',
+                daysSinceSync: 0,
+                lastSyncAt: null,
+                changedSinceSync: { adrs: 0, patterns: 0, sprints: 0, total: 0 },
+                message: 'Not a team member',
+            });
+        }
+        if (!membershipResponse.ok) {
+            // API error - return safe default (non-stale to avoid blocking)
+            return createResult({
+                isStale: false,
+                severity: 'none',
+                daysSinceSync: 0,
+                lastSyncAt: null,
+                changedSinceSync: { adrs: 0, patterns: 0, sprints: 0, total: 0 },
+                message: 'Could not verify membership status',
+            });
+        }
+        const membershipData = await membershipResponse.json();
+        const lastSyncAt = membershipData.membership?.last_sync_at || null;
+        // Calculate days since sync
+        const daysSinceSync = calculateDaysSinceSync(lastSyncAt);
+        // Determine severity based on thresholds
+        const severity = determineSeverity(daysSinceSync, mergedConfig);
+        // If not stale, return early (skip expensive changes query)
+        if (severity === 'none') {
+            return createResult({
+                isStale: false,
+                severity: 'none',
+                daysSinceSync,
+                lastSyncAt,
+                changedSinceSync: { adrs: 0, patterns: 0, sprints: 0, total: 0 },
+                message: formatMessage(severity, daysSinceSync, lastSyncAt, { adrs: 0, patterns: 0, sprints: 0, total: 0 }),
+            });
+        }
+        // Fetch changes since last sync
+        const changedSinceSync = await fetchChangesSinceSync(graphId, token, lastSyncAt);
+        // Generate human-readable message
+        const message = formatMessage(severity, daysSinceSync, lastSyncAt, changedSinceSync);
+        return createResult({
+            isStale: true,
+            severity,
+            daysSinceSync,
+            lastSyncAt,
+            changedSinceSync,
+            message,
+        });
+    }
+    catch (error) {
+        // Network error - return safe default
+        return createResult({
+            isStale: false,
+            severity: 'none',
+            daysSinceSync: 0,
+            lastSyncAt: null,
+            changedSinceSync: { adrs: 0, patterns: 0, sprints: 0, total: 0 },
+            message: 'Could not check staleness (offline?)',
+        });
+    }
+}
+// =============================================================================
+// CLI Display Helper
+// =============================================================================
+/**
+ * Display staleness warning in CLI with appropriate styling
+ *
+ * @param result - The staleness check result
+ */
+export function displayStalenessWarning(result) {
+    if (!result.isStale) {
+        return;
+    }
+    console.log('');
+    if (result.severity === 'critical') {
+        console.log(chalk.red.bold('🚨 Team context is critically stale'));
+        console.log(chalk.red(`   ${result.message}`));
+    }
+    else {
+        console.log(chalk.yellow('⚠️  Team context may be stale'));
+        console.log(chalk.yellow(`   ${result.message}`));
+    }
+    // Show changes breakdown if any
+    if (result.changedSinceSync.total > 0) {
+        console.log('');
+        console.log(chalk.dim('   Changes since last sync:'));
+        if (result.changedSinceSync.adrs > 0) {
+            console.log(chalk.dim(`     - ${result.changedSinceSync.adrs} ADR${result.changedSinceSync.adrs === 1 ? '' : 's'}`));
+        }
+        if (result.changedSinceSync.patterns > 0) {
+            console.log(chalk.dim(`     - ${result.changedSinceSync.patterns} Pattern${result.changedSinceSync.patterns === 1 ? '' : 's'}`));
+        }
+        if (result.changedSinceSync.sprints > 0) {
+            console.log(chalk.dim(`     - ${result.changedSinceSync.sprints} Sprint${result.changedSinceSync.sprints === 1 ? '' : 's'}`));
+        }
+    }
+    console.log('');
+    console.log(chalk.dim('   Run `ginko sync` to pull team updates.'));
+    console.log('');
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Calculate number of days since last sync
+ */
+function calculateDaysSinceSync(lastSyncAt) {
+    if (!lastSyncAt) {
+        return Infinity;
+    }
+    const lastSync = new Date(lastSyncAt);
+    const now = new Date();
+    const diffMs = now.getTime() - lastSync.getTime();
+    const daysSinceSync = diffMs / (1000 * 60 * 60 * 24);
+    return Math.floor(daysSinceSync);
+}
+/**
+ * Determine severity based on days since sync and config thresholds
+ */
+function determineSeverity(daysSinceSync, config) {
+    if (daysSinceSync >= config.criticalThresholdDays) {
+        return 'critical';
+    }
+    if (daysSinceSync >= config.warningThresholdDays) {
+        return 'warning';
+    }
+    return 'none';
+}
+/**
+ * Fetch count of changes since last sync from API
+ */
+async function fetchChangesSinceSync(graphId, token, lastSyncAt) {
+    try {
+        const url = new URL(`${API_BASE}/api/v1/graph/changes`);
+        url.searchParams.set('graphId', graphId);
+        if (lastSyncAt) {
+            url.searchParams.set('since', lastSyncAt);
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            // Fallback if endpoint not available
+            return { adrs: 0, patterns: 0, sprints: 0, total: 0 };
+        }
+        const data = await response.json();
+        // API returns { changes: { ADR: n, Pattern: n, Sprint: n, ... }, total: n }
+        return {
+            adrs: data.changes?.ADR || 0,
+            patterns: data.changes?.Pattern || 0,
+            sprints: data.changes?.Sprint || 0,
+            total: data.total || 0,
+        };
+    }
+    catch {
+        return { adrs: 0, patterns: 0, sprints: 0, total: 0 };
+    }
+}
+/**
+ * Format human-readable message based on staleness state
+ */
+function formatMessage(severity, daysSinceSync, lastSyncAt, changes) {
+    if (severity === 'none') {
+        if (!lastSyncAt) {
+            return 'No sync history';
+        }
+        return `Last synced ${formatRelativeTime(lastSyncAt)}`;
+    }
+    if (!lastSyncAt || daysSinceSync === Infinity) {
+        return 'Never synced - team context not loaded';
+    }
+    const changeInfo = changes.total > 0
+        ? ` (${changes.total} change${changes.total === 1 ? '' : 's'})`
+        : '';
+    if (severity === 'critical') {
+        return `${daysSinceSync} days since last sync${changeInfo}. Team patterns and ADRs may be outdated.`;
+    }
+    return `${daysSinceSync} day${daysSinceSync === 1 ? '' : 's'} since last sync${changeInfo}.`;
+}
+/**
+ * Format relative time for display
+ */
+function formatRelativeTime(dateStr) {
+    const date = new Date(dateStr);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffMins = Math.floor(diffMs / (1000 * 60));
+    const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    if (diffMins < 1)
+        return 'just now';
+    if (diffMins < 60)
+        return `${diffMins} minute${diffMins === 1 ? '' : 's'} ago`;
+    if (diffHours < 24)
+        return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;
+    if (diffDays < 7)
+        return `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;
+    return date.toLocaleDateString();
+}
+/**
+ * Helper to create a StalenessResult with proper types
+ */
+function createResult(partial) {
+    return partial;
+}
+// =============================================================================
+// Exports for Testing
+// =============================================================================
+export const _internal = {
+    calculateDaysSinceSync,
+    determineSeverity,
+    formatMessage,
+    formatRelativeTime,
+    DEFAULT_CONFIG,
+};
+//# sourceMappingURL=staleness-detector.js.map

package/dist/lib/staleness-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness-detector.js","sourceRoot":"","sources":["../../src/lib/staleness-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAmC1B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,yBAAyB,CAAC;AAExE,MAAM,cAAc,GAAoB;IACtC,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;CACzB,CAAC;AAEF,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,KAAa,EACb,MAAiC;IAEjC,MAAM,YAAY,GAAoB;QACpC,GAAG,cAAc;QACjB,GAAG,MAAM;KACV,CAAC;IAEF,IAAI,CAAC;QACH,kDAAkD;QAClD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,QAAQ,0BAA0B,CAAC,CAAC;QACrE,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEnD,MAAM,kBAAkB,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE;YAC/D,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,KAAK,EAAE;gBAChC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,kBAAkB,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACtC,yEAAyE;YACzE,OAAO,YAAY,CAAC;gBAClB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,IAAI;gBAChB,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;gBAChE,OAAO,EAAE,mBAAmB;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC;YAC3B,gEAAgE;YAChE,OAAO,YAAY,CAAC;gBAClB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,IAAI;gBAChB,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;gBAChE,OAAO,EAAE,oCAAoC;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAuD,CAAC;QAC5G,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,YAAY,IAAI,IAAI,CAAC;QAEnE,4BAA4B;QAC5B,MAAM,aAAa,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAEzD,yCAAyC;QACzC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAEhE,4DAA4D;QAC5D,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,YAAY,CAAC;gBAClB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,MAAM;gBAChB,aAAa;gBACb,UAAU;gBACV,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;gBAChE,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;aAC5G,CAAC,CAAC;QACL,CAAC;QAED,gCAAgC;QAChC,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAEjF,kCAAkC;QAClC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAErF,OAAO,YAAY,CAAC;YAClB,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,aAAa;YACb,UAAU;YACV,gBAAgB;YAChB,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,YAAY,CAAC;YAClB,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,MAAM;YAChB,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,IAAI;YAChB,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;YAChE,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,gBAAgB,CAAC,IAAI,OAAO,MAAM,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACvH,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,gBAAgB,CAAC,QAAQ,WAAW,MAAM,CAAC,gBAAgB,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACnI,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,gBAAgB,CAAC,OAAO,UAAU,MAAM,CAAC,gBAAgB,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChI,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,sBAAsB,CAAC,UAAyB;IACvD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAErD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,aAAqB,EACrB,MAAuB;IAEvB,IAAI,aAAa,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAClD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,aAAa,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAAe,EACf,KAAa,EACb,UAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,QAAQ,uBAAuB,CAAC,CAAC;QACxD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,KAAK,EAAE;gBAChC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,qCAAqC;YACrC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAG/B,CAAC;QAEF,4EAA4E;QAC5E,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YAC5B,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC;YACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;YAClC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;SACvB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,QAAyC,EACzC,aAAqB,EACrB,UAAyB,EACzB,OAAyB;IAEzB,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,eAAe,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,UAAU,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,wCAAwC,CAAC;IAClD,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC;QAClC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,UAAU,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QAC/D,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,GAAG,aAAa,wBAAwB,UAAU,2CAA2C,CAAC;IACvG,CAAC;IAED,OAAO,GAAG,aAAa,OAAO,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mBAAmB,UAAU,GAAG,CAAC;AAC/F,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAE5D,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACpC,IAAI,QAAQ,GAAG,EAAE;QAAE,OAAO,GAAG,QAAQ,UAAU,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAC/E,IAAI,SAAS,GAAG,EAAE;QAAE,OAAO,GAAG,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChF,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,GAAG,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAC3E,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,OAAwB;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,sBAAsB;IACtB,iBAAiB;IACjB,aAAa;IACb,kBAAkB;IAClB,cAAc;CACf,CAAC"}

package/dist/lib/team-sync-reporter.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [sync, team, reporting, changes, EPIC-008]
+ * @related: [../commands/sync/sync-command.ts, ../commands/sync/team-sync.ts, staleness-detector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+/**
+ * Change details for a single node type
+ */
+export interface TypeChange {
+    type: string;
+    action: string;
+    count: number;
+    titles: string[];
+}
+/**
+ * Summary of changes for a single team member
+ */
+export interface MemberChangeSummary {
+    email: string;
+    displayName: string | null;
+    changes: TypeChange[];
+    totalChanges: number;
+}
+/**
+ * Summary of all team changes since last sync
+ */
+export interface TeamChangeSummary {
+    byMember: Map<string, MemberChangeSummary>;
+    totalChanges: number;
+    sinceSyncAt: string | null;
+    period: string;
+}
+/**
+ * Raw change record from API
+ */
+interface RawChangeRecord {
+    id: string;
+    type: string;
+    title: string;
+    action: 'created' | 'updated' | 'deleted';
+    editedBy: string;
+    editedByName?: string | null;
+    editedAt: string;
+}
+/**
+ * Fetch team changes since last sync
+ *
+ * @param graphId - The graph ID to query
+ * @param token - Bearer token for authentication
+ * @param lastSyncAt - ISO timestamp of last sync (null if never synced)
+ * @returns TeamChangeSummary with changes grouped by member
+ *
+ * @example
+ * ```typescript
+ * const summary = await getTeamChangesSinceLast(graphId, token, '2026-01-01T00:00:00Z');
+ * if (summary.totalChanges > 0) {
+ *   displayTeamChangeReport(summary);
+ * }
+ * ```
+ */
+export declare function getTeamChangesSinceLast(graphId: string, token: string, lastSyncAt: string | null): Promise<TeamChangeSummary>;
+/**
+ * Aggregate raw changes into team summary
+ */
+declare function aggregateChanges(changes: RawChangeRecord[], lastSyncAt: string | null): TeamChangeSummary;
+/**
+ * Create empty summary (used for error cases)
+ */
+declare function createEmptySummary(lastSyncAt: string | null): TeamChangeSummary;
+/**
+ * Calculate human-readable period string
+ */
+declare function calculatePeriod(lastSyncAt: string | null): string;
+/**
+ * Format team change report as string (for logging or testing)
+ *
+ * @param summary - The team change summary to format
+ * @returns Formatted string with colors stripped for logging
+ */
+export declare function formatTeamChangeReport(summary: TeamChangeSummary): string;
+/**
+ * Display team change report to console with chalk colors
+ *
+ * @param summary - The team change summary to display
+ */
+export declare function displayTeamChangeReport(summary: TeamChangeSummary): void;
+/**
+ * Display compact change summary (single line)
+ *
+ * @param summary - The team change summary
+ * @returns Single line summary string
+ */
+export declare function formatCompactSummary(summary: TeamChangeSummary): string;
+/**
+ * Format email for display (truncate domain)
+ */
+declare function formatEmail(email: string): string;
+export declare const _internal: {
+    aggregateChanges: typeof aggregateChanges;
+    calculatePeriod: typeof calculatePeriod;
+    formatEmail: typeof formatEmail;
+    createEmptySummary: typeof createEmptySummary;
+};
+export {};
+//# sourceMappingURL=team-sync-reporter.d.ts.map

package/dist/lib/team-sync-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-sync-reporter.d.ts","sourceRoot":"","sources":["../../src/lib/team-sync-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAiDD;;GAEG;AACH,iBAAS,gBAAgB,CACvB,OAAO,EAAE,eAAe,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,iBAAiB,CAgDnB;AAED;;GAEG;AACH,iBAAS,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAOxE;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAiB1D;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAuCzE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAgDxE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAOvE;AAMD;;GAEG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa1C;AAMD,eAAO,MAAM,SAAS;;;;;CAKrB,CAAC"}