feat(v0.4.5): sort_order="asc"|"desc" sur leexi_list_calls (defaut "asc" hardcoded)

L'orchestrateur cote skill (leexi-routine v0.8.0) demandait a Claude
de trier ASC via prompt Markdown — pas fiable, Claude pouvait l'oublier
au runtime, et le user voyait des batches dans le mauvais ordre.

Fix : hardcoder le tri dans le code du tool MCP. Garanti, peu importe
ce que fait Claude au runtime.

- Nouveau param sort_order: "asc" | "desc" (defaut "asc")
- Tri local par performed_at (string ISO-8601, comparison directe)
- Applique AVANT only_unprocessed filter et AVANT fields strip
- Critique pour la reprise historique : les fiches client se construisent
  dans l'ordre logique (R1 -> R2 -> kickoff -> steerco) au lieu de
  l'inverse.

Tests : 60/60 (was 58) avec 2 nouveaux tests qui valident le re-sort
quand l'API retourne dans l'ordre inverse.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: cedriclombardot

.claude-plugin/marketplace.json

@@ -6,12 +6,12 @@
   },
   "metadata": {
     "description": "Leexi MCP plugin — read calls and transcripts from Claude.",
-    "version": "0.4.4"
+    "version": "0.4.5"
   },
   "plugins": [
     {
       "name": "leexi-mcp",
-      "version": "0.4.4",
+      "version": "0.4.5",
       "source": "./",
       "description": "Read Leexi calls and transcripts from Claude. Built for post-call automation routines.",
       "category": "productivity",

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "leexi-mcp",
   "description": "Read Leexi calls and transcripts from Claude. Built for post-call automation routines.",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "author": {
     "name": "DonkeyCode",
     "email": "hello@donkeycode.com"

CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@donkeycode/leexi-mcp` will be documented here. Format i
 
 ## [Unreleased]
 
+## [0.4.5] — 2026-05-26
+
+### Added
+
+- **`sort_order: "asc" | "desc"`** param on `leexi_list_calls` (default `"asc"`). Tri par `performed_at` appliqué CÔTÉ TOOL (après réception de l'API), pour garantir l'ordre chronologique indépendamment de ce que renvoie l'API Leexi. Critique pour la reprise historique : les fiches client se construisent dans l'ordre logique (R1 → R2 → kickoff → steerco) au lieu de l'inverse.
+
+### Why
+
+- L'orchestrateur côté skill (`leexi-routine` v0.8.0) demandait à Claude de trier ASC via prompt Markdown — pas fiable, Claude pouvait l'oublier au runtime. Hardcoder le tri dans le code du tool garantit le comportement. Le param `sort_order` reste configurable pour les cas où on veut le contraire (polling continu newest-first).
+
+### Tests
+
+- 60 tests (was 58). +2 couvrant sort ASC default + sort DESC explicit, avec API qui retourne dans l'ordre inverse pour valider le re-sort.
+
 ## [0.4.4] — 2026-05-26
 
 ### Added

dist/index.js

@@ -1,6 +1,6 @@
 {
   "name": "@donkeycode/leexi-mcp",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "DonkeyCode MCP server for Leexi (AI Notetaker) — exposes calls, transcripts, and processing state.",
   "license": "MIT",
   "author": "DonkeyCode <hello@donkeycode.com>",

dist/index.js.map

@@ -23,6 +23,18 @@ export const ListCallsInputSchema = z.object({
    *   Utile uniquement pour debug ou exports massifs.
    */
   fields: z.enum(["summary", "full"]).default("summary"),
+  /**
+   * v0.4.5 — tri par performed_at appliqué CÔTÉ TOOL (après réception API).
+   * - "asc" (défaut) : du plus ancien au plus récent. Critique pour la reprise
+   *   historique : les fiches client se construisent dans l'ordre logique
+   *   (R1 → R2 → kickoff → steerco) au lieu de l'inverse.
+   * - "desc" : du plus récent au plus ancien. Utile pour "qu'est-ce qui s'est
+   *   passé hier" ou polling continu.
+   *
+   * Important : le tri est appliqué AVANT le filter only_unprocessed et AVANT
+   * le strip fields, sur l'ensemble retourné par l'API pour cette page.
+   */
+  sort_order: z.enum(["asc", "desc"]).default("asc"),
 });
 
 // Raw (pre-default) input type: what callers actually pass in (e.g. {}).
@@ -65,7 +77,10 @@ export function createListCallsTool(
   return {
     name: "leexi_list_calls",
     description:
-      "List Leexi calls (paginated). Default fields='summary' returns lightweight metadata only (uuid, title, performed_at, duration, locale, owner, speakers, leexi_url, summary text) — recommended for any listing/filtering use case. Pass fields='full' to include simple_transcript, chapters, tasks, prompts (~30KB extra per call, only for debug/export). Use only_unprocessed=true to skip calls already marked processed by this MCP. Pagination uses { page, items, count }.",
+      "List Leexi calls (paginated, sorted ASC by performed_at by default). " +
+      "Default sort_order='asc' (oldest first) is critical for historical backfills so that client timelines build in chronological order (R1 → R2 → kickoff). Pass 'desc' for newest-first polling. " +
+      "Default fields='summary' returns lightweight metadata only (uuid, title, performed_at, duration, locale, owner, speakers, leexi_url, summary text) — recommended for any listing/filtering. Pass fields='full' to include simple_transcript, chapters, tasks, prompts (~30KB extra per call, only for debug/export). " +
+      "Use only_unprocessed=true to skip calls already marked processed by this MCP. Pagination uses { page, items, count }.",
     inputSchema: ListCallsInputSchema,
     handler: async (rawInput) => {
       // Parse to apply Zod defaults before using the values.
@@ -81,6 +96,11 @@ export function createListCallsTool(
 
       let calls = list.calls;
 
+      // v0.4.5 — Sort by performed_at locally. ASC by default for historical
+      // backfill correctness. The Leexi API may return calls in arbitrary
+      // order (typically DESC), so we re-sort here to guarantee the contract.
+      calls = sortCalls(calls, input.sort_order);
+
       if (input.only_unprocessed) {
         const filtered: CallSummary[] = [];
         for (const call of calls) {
@@ -103,6 +123,19 @@ export function createListCallsTool(
   };
 }
 
+// ---------------------------------------------------------------------------
+// sortCalls — guarantees chronological order regardless of API behavior.
+// performedAt is ISO-8601 so string comparison is correct.
+// ---------------------------------------------------------------------------
+function sortCalls(calls: CallSummary[], order: "asc" | "desc"): CallSummary[] {
+  const dir = order === "asc" ? 1 : -1;
+  return [...calls].sort((a, b) => {
+    if (a.performedAt < b.performedAt) return -1 * dir;
+    if (a.performedAt > b.performedAt) return 1 * dir;
+    return 0;
+  });
+}
+
 // ---------------------------------------------------------------------------
 // stripHeavyFields — drop transcript/chapters/tasks/prompts/scorecards.
 // Keeps the call object structurally valid (CallSummary type), just emptied.