gitmem-mcp 0.2.0

package/dist/services/thread-vitality.js

@@ -0,0 +1,143 @@
+/**
+ * Thread Vitality Scoring (Phase 2) + Lifecycle State Machine (Phase 6)
+ *
+ * Computes vitality from recency + frequency (two of four eventual components).
+ * Importance and relevance deferred to Phases 3-4 (knowledge graph + per-session embeddings).
+ *
+ * Formula: vitality = W_recency * recency + W_frequency * frequency
+ *
+ * Phase 2 weights (renormalized from 4-component to 2-component):
+ *   recency:   0.55  (original 0.30 / 0.55 total)
+ *   frequency: 0.45  (original 0.25 / 0.55 total)
+ *
+ * Recency: exponential decay based on thread_class half-life
+ *   operational: 3-day half-life (short-lived tasks)
+ *   backlog: 21-day half-life (long-running concerns)
+ *
+ * Frequency: log-scaled touch count normalized against thread age
+ *   log(touch_count + 1) / log(max(days_alive, 0.01) + 1)
+ *
+ * Status thresholds:
+ *   vitality > 0.5  → "active"
+ *   0.2 <= v <= 0.5 → "cooling"
+ *   vitality < 0.2  → "dormant"
+ *
+ * Phase 6 Lifecycle:
+ *   EMERGING (< 24h old) → ACTIVE → COOLING → DORMANT → ARCHIVED (30+ days dormant)
+ *   Any state → RESOLVED (explicit resolve)
+ */
+// ---------- Constants ----------
+const WEIGHTS = {
+    recency: 0.55,
+    frequency: 0.45,
+};
+const HALF_LIVES = {
+    operational: 3,
+    backlog: 21,
+};
+const STATUS_THRESHOLDS = {
+    active: 0.5,
+    cooling: 0.2,
+};
+// Phase 6 lifecycle constants
+export const EMERGING_WINDOW_HOURS = 24;
+export const ARCHIVAL_DORMANT_DAYS = 30;
+const OPERATIONAL_KEYWORDS = [
+    "deploy", "fix", "debug", "hotfix", "urgent", "broken",
+    "failing", "revert", "rollback", "incident", "outage",
+    "blocker", "unblock", "investigate",
+];
+// ---------- Core Computation ----------
+export function computeVitality(input, now) {
+    const currentTime = now || new Date();
+    const recency = computeRecency(input.last_touched_at, input.thread_class, currentTime);
+    const frequency = computeFrequency(input.touch_count, input.created_at, currentTime);
+    const vitality_score = clamp(WEIGHTS.recency * recency + WEIGHTS.frequency * frequency, 0, 1);
+    const status = vitalityToStatus(vitality_score);
+    return {
+        vitality_score: round(vitality_score, 4),
+        status,
+        recency_component: round(recency, 4),
+        frequency_component: round(frequency, 4),
+    };
+}
+// ---------- Lifecycle State Machine (Phase 6) ----------
+/**
+ * Compute the full lifecycle status for a thread.
+ * Wraps vitality scoring with age-based emerging window and archival logic.
+ *
+ * State machine:
+ *   EMERGING (< 24h) → ACTIVE → COOLING → DORMANT → ARCHIVED (30+ days dormant)
+ *   Any state → RESOLVED (handled externally by resolve_thread)
+ */
+export function computeLifecycleStatus(input, now) {
+    const currentTime = now || new Date();
+    // Terminal states: archived and resolved stay as-is
+    if (input.current_status === "archived" || input.current_status === "resolved") {
+        const vitality = computeVitality(input, currentTime);
+        return {
+            lifecycle_status: input.current_status,
+            vitality,
+        };
+    }
+    // Emerging window: threads < 24h old
+    const created = new Date(input.created_at);
+    const hoursAlive = (currentTime.getTime() - created.getTime()) / (1000 * 60 * 60);
+    if (hoursAlive < EMERGING_WINDOW_HOURS) {
+        const vitality = computeVitality(input, currentTime);
+        return { lifecycle_status: "emerging", vitality };
+    }
+    // Compute vitality for normal lifecycle
+    const vitality = computeVitality(input, currentTime);
+    // Archival: dormant for 30+ days
+    if (input.current_status === "dormant" &&
+        input.dormant_since) {
+        const dormantStart = new Date(input.dormant_since);
+        const daysDormant = (currentTime.getTime() - dormantStart.getTime()) / (1000 * 60 * 60 * 24);
+        if (daysDormant >= ARCHIVAL_DORMANT_DAYS) {
+            return { lifecycle_status: "archived", vitality };
+        }
+    }
+    // Normal vitality-derived status (active/cooling/dormant)
+    return { lifecycle_status: vitality.status, vitality };
+}
+// ---------- Components ----------
+function computeRecency(lastTouchedAt, threadClass, now) {
+    const lastTouched = new Date(lastTouchedAt);
+    const daysSinceTouch = Math.max((now.getTime() - lastTouched.getTime()) / (1000 * 60 * 60 * 24), 0);
+    const halfLife = HALF_LIVES[threadClass] || HALF_LIVES.backlog;
+    // Exponential decay: e^(-ln(2) * t / halfLife)
+    return Math.exp(-Math.LN2 * daysSinceTouch / halfLife);
+}
+function computeFrequency(touchCount, createdAt, now) {
+    const created = new Date(createdAt);
+    const daysAlive = Math.max((now.getTime() - created.getTime()) / (1000 * 60 * 60 * 24), 0.01);
+    // log(touchCount + 1) / log(daysAlive + 1), capped at 1.0
+    return Math.min(Math.log(touchCount + 1) / Math.log(daysAlive + 1), 1.0);
+}
+// ---------- Status Mapping ----------
+export function vitalityToStatus(score) {
+    if (score > STATUS_THRESHOLDS.active)
+        return "active";
+    if (score >= STATUS_THRESHOLDS.cooling)
+        return "cooling";
+    return "dormant";
+}
+// ---------- Thread Class Detection ----------
+export function detectThreadClass(text) {
+    const lower = text.toLowerCase();
+    for (const keyword of OPERATIONAL_KEYWORDS) {
+        if (lower.includes(keyword))
+            return "operational";
+    }
+    return "backlog";
+}
+// ---------- Helpers ----------
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function round(value, decimals) {
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=thread-vitality.js.map

package/dist/services/thread-vitality.js.map

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

package/dist/services/tier.d.ts

@@ -0,0 +1,52 @@
+/**
+ * GitMem Tier Detection and Feature Flags
+ *
+ * Three tiers:
+ *   free — Local JSON storage, keyword search, zero config
+ *   pro  — Supabase + embeddings, semantic search, cloud persistence, variants
+ *   dev  — Everything in pro + compliance, transcripts, metrics
+ *
+ * Detection:
+ *   GITMEM_TIER=free|pro|dev   (explicit override)
+ *   Auto-detect: no SUPABASE_URL → free, GITMEM_DEV=1 → dev, else → pro
+ */
+export type GitMemTier = "free" | "pro" | "dev";
+/**
+ * Get the current tier (cached after first call)
+ */
+export declare function getTier(): GitMemTier;
+/**
+ * Reset tier detection (for testing)
+ */
+export declare function resetTier(): void;
+/** Whether Supabase is available for storage (pro, dev) */
+export declare function hasSupabase(): boolean;
+/** Whether embedding generation is available (pro, dev) */
+export declare function hasEmbeddings(): boolean;
+/** Whether session close compliance validation is active (dev only) */
+export declare function hasCompliance(): boolean;
+/** Whether scar variant A/B testing is active (pro, dev — needs Supabase for assignment storage) */
+export declare function hasVariants(): boolean;
+/** Whether transcript storage/retrieval is available (dev only) */
+export declare function hasTranscripts(): boolean;
+/** Whether batch scar usage recording is available (dev only) */
+export declare function hasBatchOperations(): boolean;
+/** Whether cache management tools are available (pro, dev) */
+export declare function hasCacheManagement(): boolean;
+/** Whether detailed performance metrics recording is active (pro, dev — aligned with hasVariants) */
+export declare function hasMetrics(): boolean;
+/** Whether advanced agent detection (5-agent matrix) is active (dev only) */
+export declare function hasAdvancedAgentDetection(): boolean;
+/** Whether multi-project support is active (dev only) */
+export declare function hasMultiProject(): boolean;
+/** Whether LLM-cooperative enforcement fields are generated (dev only) */
+export declare function hasEnforcementFields(): boolean;
+/**
+ * Get the table prefix for the current tier
+ */
+export declare function getTablePrefix(): string;
+/**
+ * Get the fully-qualified table name for a base table name
+ */
+export declare function getTableName(baseName: string): string;
+//# sourceMappingURL=tier.d.ts.map

package/dist/services/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../src/services/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAwBhD;;GAEG;AACH,wBAAgB,OAAO,IAAI,UAAU,CAMpC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAMD,2DAA2D;AAC3D,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,uEAAuE;AACvE,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,oGAAoG;AACpG,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,qGAAqG;AACrG,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,yDAAyD;AACzD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/services/tier.js

@@ -0,0 +1,109 @@
+/**
+ * GitMem Tier Detection and Feature Flags
+ *
+ * Three tiers:
+ *   free — Local JSON storage, keyword search, zero config
+ *   pro  — Supabase + embeddings, semantic search, cloud persistence, variants
+ *   dev  — Everything in pro + compliance, transcripts, metrics
+ *
+ * Detection:
+ *   GITMEM_TIER=free|pro|dev   (explicit override)
+ *   Auto-detect: no SUPABASE_URL → free, GITMEM_DEV=1 → dev, else → pro
+ */
+let _tier = null;
+/**
+ * Detect tier from environment variables
+ */
+function detectTier() {
+    const explicit = process.env.GITMEM_TIER?.toLowerCase();
+    if (explicit === "free" || explicit === "pro" || explicit === "dev") {
+        return explicit;
+    }
+    const supabaseUrl = process.env.SUPABASE_URL;
+    if (!supabaseUrl)
+        return "free";
+    // Dev tier markers
+    if (process.env.GITMEM_DEV === "true" || process.env.GITMEM_DEV === "1") {
+        return "dev";
+    }
+    return "pro";
+}
+/**
+ * Get the current tier (cached after first call)
+ */
+export function getTier() {
+    if (!_tier) {
+        _tier = detectTier();
+        console.error(`[gitmem] Tier: ${_tier}`);
+    }
+    return _tier;
+}
+/**
+ * Reset tier detection (for testing)
+ */
+export function resetTier() {
+    _tier = null;
+}
+// ============================================================================
+// Feature flags
+// ============================================================================
+/** Whether Supabase is available for storage (pro, dev) */
+export function hasSupabase() {
+    return getTier() !== "free";
+}
+/** Whether embedding generation is available (pro, dev) */
+export function hasEmbeddings() {
+    return getTier() !== "free";
+}
+/** Whether session close compliance validation is active (dev only) */
+export function hasCompliance() {
+    return getTier() === "dev";
+}
+/** Whether scar variant A/B testing is active (pro, dev — needs Supabase for assignment storage) */
+export function hasVariants() {
+    return getTier() !== "free";
+}
+/** Whether transcript storage/retrieval is available (dev only) */
+export function hasTranscripts() {
+    return getTier() === "dev";
+}
+/** Whether batch scar usage recording is available (dev only) */
+export function hasBatchOperations() {
+    return getTier() === "dev";
+}
+/** Whether cache management tools are available (pro, dev) */
+export function hasCacheManagement() {
+    return getTier() !== "free";
+}
+/** Whether detailed performance metrics recording is active (pro, dev — aligned with hasVariants) */
+export function hasMetrics() {
+    return getTier() !== "free";
+}
+/** Whether advanced agent detection (5-agent matrix) is active (dev only) */
+export function hasAdvancedAgentDetection() {
+    return getTier() === "dev";
+}
+/** Whether multi-project support is active (dev only) */
+export function hasMultiProject() {
+    return getTier() === "dev";
+}
+/** Whether LLM-cooperative enforcement fields are generated (dev only) */
+export function hasEnforcementFields() {
+    return getTier() === "dev";
+}
+/**
+ * Get the table prefix for the current tier
+ */
+export function getTablePrefix() {
+    if (getTier() === "dev") {
+        return process.env.GITMEM_TABLE_PREFIX || "orchestra_";
+    }
+    return process.env.GITMEM_TABLE_PREFIX || "gitmem_";
+}
+/**
+ * Get the fully-qualified table name for a base table name
+ */
+export function getTableName(baseName) {
+    return `${getTablePrefix()}${baseName}`;
+}
+//# sourceMappingURL=tier.js.map

package/dist/services/tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.js","sourceRoot":"","sources":["../../src/services/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,IAAI,KAAK,GAAsB,IAAI,CAAC;AAEpC;;GAEG;AACH,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;IACxD,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACpE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC7C,IAAI,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IAEhC,mBAAmB;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,UAAU,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,2DAA2D;AAC3D,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB;IACvC,OAAO,OAAO,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,EAAE,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,YAAY,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,GAAG,cAAc,EAAE,GAAG,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

package/dist/services/timezone.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Timezone Display Formatting Service
+ *
+ * Converts UTC timestamps to user's local timezone for display.
+ * Storage timestamps remain UTC — this is display-layer only.
+ *
+ * Config chain: .gitmem/config.json → TZ env var → UTC (default)
+ */
+import type { ThreadObject } from "../types/index.js";
+/** Get the configured timezone. Loads once from config chain. */
+export declare function getTimezone(): string;
+/**
+ * Format a date-only string (YYYY-MM-DD) for display.
+ *
+ * When timezone is UTC (default): returns original string unchanged.
+ * When timezone configured: returns "Feb 9, 2026" format.
+ *
+ * Does NOT shift the date to another timezone — the input is
+ * treated as a calendar date, not a UTC midnight timestamp.
+ */
+export declare function formatDate(dateStr: string): string;
+/**
+ * Format a full ISO timestamp for display.
+ *
+ * When timezone is UTC (default): returns original string unchanged.
+ * When timezone configured: returns "Feb 9, 2026, 1:45 PM EST" format.
+ */
+export declare function formatTimestamp(isoStr: string): string;
+/**
+ * Format a ThreadObject's timestamps for display.
+ * Returns original reference when UTC (no allocation).
+ * Returns a shallow copy with formatted dates when timezone configured.
+ */
+export declare function formatThreadForDisplay(thread: ThreadObject): ThreadObject;
+/** Reset cached timezone (for testing). */
+export declare function resetTimezone(): void;
+//# sourceMappingURL=timezone.d.ts.map

package/dist/services/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/services/timezone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAwDtD,iEAAiE;AACjE,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBlD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAOzE;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/dist/services/timezone.js

@@ -0,0 +1,147 @@
+/**
+ * Timezone Display Formatting Service
+ *
+ * Converts UTC timestamps to user's local timezone for display.
+ * Storage timestamps remain UTC — this is display-layer only.
+ *
+ * Config chain: .gitmem/config.json → TZ env var → UTC (default)
+ */
+import * as fs from "fs";
+import { getGitmemPath } from "./gitmem-dir.js";
+let _timezone = null;
+let _loaded = false;
+/**
+ * Load timezone from config chain:
+ * 1. .gitmem/config.json "timezone" field
+ * 2. TZ environment variable
+ * 3. "UTC" (default, preserves current behavior)
+ */
+function loadTimezone() {
+    if (_loaded)
+        return _timezone || "UTC";
+    // 1. Try .gitmem/config.json
+    try {
+        const configPath = getGitmemPath("config.json");
+        if (fs.existsSync(configPath)) {
+            const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            if (raw.timezone && typeof raw.timezone === "string") {
+                const tz = raw.timezone;
+                try {
+                    Intl.DateTimeFormat(undefined, { timeZone: tz });
+                    _timezone = tz;
+                    _loaded = true;
+                    console.error(`[timezone] Loaded from config.json: ${tz}`);
+                    return tz;
+                }
+                catch {
+                    console.warn(`[timezone] Invalid timezone in config.json: ${tz}, falling back`);
+                }
+            }
+        }
+    }
+    catch {
+        // File doesn't exist or is invalid — fall through
+    }
+    // 2. Try TZ env var
+    const tzEnv = process.env.TZ;
+    if (tzEnv) {
+        try {
+            Intl.DateTimeFormat(undefined, { timeZone: tzEnv });
+            _timezone = tzEnv;
+            _loaded = true;
+            console.error(`[timezone] Loaded from TZ env: ${tzEnv}`);
+            return tzEnv;
+        }
+        catch {
+            console.warn(`[timezone] Invalid TZ env var: ${tzEnv}, falling back to UTC`);
+        }
+    }
+    // 3. Default to UTC
+    _timezone = "UTC";
+    _loaded = true;
+    return _timezone;
+}
+/** Get the configured timezone. Loads once from config chain. */
+export function getTimezone() {
+    return loadTimezone();
+}
+function isTimezoneConfigured() {
+    return getTimezone() !== "UTC";
+}
+/**
+ * Format a date-only string (YYYY-MM-DD) for display.
+ *
+ * When timezone is UTC (default): returns original string unchanged.
+ * When timezone configured: returns "Feb 9, 2026" format.
+ *
+ * Does NOT shift the date to another timezone — the input is
+ * treated as a calendar date, not a UTC midnight timestamp.
+ */
+export function formatDate(dateStr) {
+    if (!isTimezoneConfigured())
+        return dateStr;
+    if (!dateStr || dateStr.length < 10)
+        return dateStr;
+    try {
+        const [year, month, day] = dateStr.split("-").map(Number);
+        const date = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
+        return new Intl.DateTimeFormat("en-US", {
+            month: "short",
+            day: "numeric",
+            year: "numeric",
+            timeZone: "UTC", // Calendar date — don't shift across timezones
+        }).format(date);
+    }
+    catch {
+        return dateStr;
+    }
+}
+/**
+ * Format a full ISO timestamp for display.
+ *
+ * When timezone is UTC (default): returns original string unchanged.
+ * When timezone configured: returns "Feb 9, 2026, 1:45 PM EST" format.
+ */
+export function formatTimestamp(isoStr) {
+    if (!isTimezoneConfigured())
+        return isoStr;
+    if (!isoStr)
+        return isoStr;
+    try {
+        const date = new Date(isoStr);
+        if (isNaN(date.getTime()))
+            return isoStr;
+        return new Intl.DateTimeFormat("en-US", {
+            month: "short",
+            day: "numeric",
+            year: "numeric",
+            hour: "numeric",
+            minute: "2-digit",
+            timeZoneName: "short",
+            timeZone: getTimezone(),
+        }).format(date);
+    }
+    catch {
+        return isoStr;
+    }
+}
+/**
+ * Format a ThreadObject's timestamps for display.
+ * Returns original reference when UTC (no allocation).
+ * Returns a shallow copy with formatted dates when timezone configured.
+ */
+export function formatThreadForDisplay(thread) {
+    if (!isTimezoneConfigured())
+        return thread;
+    return {
+        ...thread,
+        created_at: formatTimestamp(thread.created_at),
+        ...(thread.resolved_at && { resolved_at: formatTimestamp(thread.resolved_at) }),
+    };
+}
+/** Reset cached timezone (for testing). */
+export function resetTimezone() {
+    _timezone = null;
+    _loaded = false;
+}
+//# sourceMappingURL=timezone.js.map

package/dist/services/timezone.js.map

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

package/dist/services/transcript-chunker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Transcript Chunking Service
+ *
+ * Parses JSONL session transcripts, chunks them intelligently,
+ * generates embeddings, and stores in orchestra_transcript_chunks.
+ *
+ * Issue: OD-540
+ */
+import type { Project } from "../types/index.js";
+/**
+ * Process a transcript: parse, chunk, embed, and store
+ */
+export declare function processTranscript(sessionId: string, transcriptContent: string, project?: Project): Promise<{
+    success: boolean;
+    chunksCreated: number;
+    error?: string;
+}>;
+//# sourceMappingURL=transcript-chunker.d.ts.map

package/dist/services/transcript-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-chunker.d.ts","sourceRoot":"","sources":["../../src/services/transcript-chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA2MjD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,OAAyB,GACjC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwFtE"}