@arka-labs/nemesis 1.2.0

package/lib/ui/menu.js

@@ -0,0 +1,306 @@
+/**
+ * Interactive keyboard-navigable menu — zero deps.
+ * Uses readline.emitKeypressEvents for reliable arrow key handling.
+ * Arrow keys (up/down), Enter to select, q/Ctrl+C to quit.
+ * Supports scrollable viewport via maxVisible option.
+ * '/' activates filter mode for substring search.
+ */
+
+import { emitKeypressEvents } from 'node:readline';
+import { style, stripAnsi } from './colors.js';
+
+/**
+ * Pure function — filter items by substring (case-insensitive) on label + description.
+ * @param {Array<{label: string, value: string, description?: string}>} items
+ * @param {string} text
+ * @returns {Array<{label: string, value: string, description?: string, _origIndex: number}>}
+ */
+export function filterItems(items, text) {
+  if (!text) return items.map((item, i) => ({ ...item, _origIndex: i }));
+  const lower = text.toLowerCase();
+  return items
+    .map((item, i) => ({ ...item, _origIndex: i }))
+    .filter(item => {
+      const haystack = (stripAnsi(item.label) + ' ' + (item.description || '')).toLowerCase();
+      return haystack.includes(lower);
+    });
+}
+
+/**
+ * @param {Array<{label: string, value: string, description?: string}>} items
+ * @param {object} opts
+ * @param {string} [opts.title]
+ * @param {string} [opts.hint]
+ * @param {number} [opts.maxVisible] — 0 = show all (default)
+ * @returns {Promise<string|null>} selected value or null if cancelled
+ */
+export function interactiveMenu(items, opts = {}) {
+  const {
+    title,
+    hint: customHint,
+    maxVisible = 0,
+  } = opts;
+
+  const defaultHint = 'Fleches \u2191\u2193 naviguer, Enter selectionner, / filtrer, q quitter';
+
+  return new Promise(resolve => {
+    let cursor = 0;
+    let viewOffset = 0;
+    let filterMode = false;
+    let filterText = '';
+    let filteredItems = items;
+    const { stdin, stdout } = process;
+
+    if (!stdin.isTTY) {
+      resolve(null);
+      return;
+    }
+
+    function getVisibleItems() {
+      return filterMode ? filteredItems : items;
+    }
+
+    function getEffectiveMax() {
+      const vis = getVisibleItems();
+      return maxVisible > 0 && maxVisible < vis.length ? maxVisible : vis.length;
+    }
+
+    function getNeedsScroll() {
+      return getVisibleItems().length > getEffectiveMax();
+    }
+
+    emitKeypressEvents(stdin);
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding('utf8');
+
+    // Fixed line count — scroll indicators always reserve space when scrollable
+    function fixedLineCount() {
+      let count = 0;
+      if (title) count += 2;              // title + blank
+      if (getNeedsScroll()) count += 2;   // ▲ + ▼ (or placeholders)
+      count += getEffectiveMax();          // visible items
+      count += 2;                          // blank + hint
+      if (filterMode) count += 1;          // filter bar
+      return count;
+    }
+
+    function adjustViewport() {
+      const vis = getVisibleItems();
+      const eMax = getEffectiveMax();
+      if (vis.length === 0) { viewOffset = 0; return; }
+      if (cursor < viewOffset) viewOffset = cursor;
+      if (cursor >= viewOffset + eMax) viewOffset = cursor - eMax + 1;
+    }
+
+    function draw() {
+      const vis = getVisibleItems();
+      const eMax = getEffectiveMax();
+      const needsScroll = getNeedsScroll();
+
+      if (title) {
+        stdout.write(`  ${style.bold(title)}\n`);
+        stdout.write('\n');
+      }
+
+      // Scroll up indicator
+      if (needsScroll) {
+        if (viewOffset > 0) {
+          stdout.write(`    ${style.dim(`\u25B2 ${viewOffset} de plus`)}\n`);
+        } else {
+          stdout.write('\n');
+        }
+      }
+
+      // Visible items
+      if (vis.length === 0) {
+        for (let i = 0; i < eMax || i < 1; i++) {
+          if (i === 0) {
+            stdout.write(`    ${style.dim('(aucun resultat)')}\n`);
+          } else {
+            stdout.write('\n');
+          }
+        }
+      } else {
+        for (let i = 0; i < eMax; i++) {
+          const realIndex = viewOffset + i;
+          if (realIndex >= vis.length) {
+            stdout.write('\n');
+          } else {
+            const item = vis[realIndex];
+            const active = realIndex === cursor;
+            const marker = active ? style.arkaRed('\u276f') : ' ';
+            const label = active ? style.bold(item.label) : item.label;
+            const desc = item.description ? style.gray(` \u2014 ${item.description}`) : '';
+            stdout.write(`  ${marker} ${label}${desc}\n`);
+          }
+        }
+      }
+
+      // Scroll down indicator
+      if (needsScroll) {
+        const remaining = vis.length - viewOffset - eMax;
+        if (remaining > 0) {
+          stdout.write(`    ${style.dim(`\u25BC ${remaining} de plus`)}\n`);
+        } else {
+          stdout.write('\n');
+        }
+      }
+
+      // Hint
+      const hint = customHint || defaultHint;
+      stdout.write(`\n  ${style.dim(hint)}\n`);
+
+      // Filter bar
+      if (filterMode) {
+        stdout.write(`  ${style.nemesisAccent('/')} ${filterText}${style.dim('_')}\n`);
+      }
+    }
+
+    function redraw() {
+      stdout.write(`\x1b[${fixedLineCount()}A\x1b[J`);
+      draw();
+    }
+
+    function cleanup() {
+      stdin.removeListener('keypress', onKeypress);
+      stdin.setRawMode(false);
+      stdin.pause();
+      stdout.write(`\x1b[${fixedLineCount() + 1}A\x1b[J`);
+    }
+
+    function applyFilter() {
+      filteredItems = filterItems(items, filterText);
+      cursor = 0;
+      viewOffset = 0;
+    }
+
+    function onKeypress(ch, key) {
+      if (!key) return;
+
+      // Ctrl+C — always quit
+      if (key.ctrl && key.name === 'c') {
+        cleanup();
+        resolve(null);
+        return;
+      }
+
+      // --- Filter mode ---
+      if (filterMode) {
+        // Escape — exit filter mode
+        if (key.name === 'escape') {
+          filterMode = false;
+          filterText = '';
+          filteredItems = items;
+          cursor = 0;
+          viewOffset = 0;
+          redraw();
+          return;
+        }
+
+        // Enter — select current item in filtered list
+        if (key.name === 'return') {
+          const vis = getVisibleItems();
+          if (vis.length > 0) {
+            cleanup();
+            stdout.write('\n');
+            resolve(vis[cursor].value);
+          }
+          return;
+        }
+
+        // Backspace — delete last char
+        if (key.name === 'backspace') {
+          if (filterText.length > 0) {
+            filterText = filterText.slice(0, -1);
+            applyFilter();
+          }
+          redraw();
+          return;
+        }
+
+        // Arrow up
+        if (key.name === 'up') {
+          const vis = getVisibleItems();
+          if (vis.length > 0) {
+            cursor = (cursor - 1 + vis.length) % vis.length;
+            adjustViewport();
+          }
+          redraw();
+          return;
+        }
+
+        // Arrow down
+        if (key.name === 'down') {
+          const vis = getVisibleItems();
+          if (vis.length > 0) {
+            cursor = (cursor + 1) % vis.length;
+            adjustViewport();
+          }
+          redraw();
+          return;
+        }
+
+        // Printable character — append to filter
+        if (ch && ch.length === 1 && !key.ctrl && !key.meta) {
+          filterText += ch;
+          applyFilter();
+          redraw();
+          return;
+        }
+
+        return;
+      }
+
+      // --- Normal mode ---
+
+      // '/' — enter filter mode
+      if (ch === '/' && !key.ctrl && !key.meta) {
+        filterMode = true;
+        filterText = '';
+        filteredItems = filterItems(items, '');
+        cursor = 0;
+        viewOffset = 0;
+        redraw();
+        return;
+      }
+
+      // Escape or q
+      if (key.name === 'escape' || (ch === 'q' && !key.ctrl && !key.meta)) {
+        cleanup();
+        resolve(null);
+        return;
+      }
+
+      // Enter
+      if (key.name === 'return') {
+        cleanup();
+        stdout.write('\n');
+        resolve(items[cursor].value);
+        return;
+      }
+
+      // Arrow up or k
+      if (key.name === 'up' || ch === 'k') {
+        cursor = (cursor - 1 + items.length) % items.length;
+        adjustViewport();
+        redraw();
+        return;
+      }
+
+      // Arrow down or j
+      if (key.name === 'down' || ch === 'j') {
+        cursor = (cursor + 1) % items.length;
+        adjustViewport();
+        redraw();
+        return;
+      }
+    }
+
+    // Initial draw
+    stdout.write('\n');
+    draw();
+
+    stdin.on('keypress', onKeypress);
+  });
+}

package/lib/ui/note-card.js

@@ -0,0 +1,198 @@
+import { stringWidth, padEndVisible } from './box.js';
+import { style } from './colors.js';
+import { levelLabel, levelBorder } from './note-colors.js';
+
+// NOTE — bordure simple
+const SINGLE = { tl: '\u250c', tr: '\u2510', bl: '\u2514', br: '\u2518', h: '\u2500', v: '\u2502' };
+// CR — double bordure
+const DOUBLE = { tl: '\u2554', tr: '\u2557', bl: '\u255a', br: '\u255d', h: '\u2550', v: '\u2551' };
+
+export const CARD_WIDTH = 72;
+
+// --- NOTE card ---
+
+export function renderNoteCard(note, options = {}) {
+  const level = note.level || 'L1';
+  const color = (ch) => levelBorder(level, ch);
+  const agentShort = (note.agentId || '').replace(/^Agent_/i, '');
+  const time = formatTime(note.timestamp);
+  const lbl = levelLabel(level);
+
+  const lines = [];
+
+  // Header : ┌─ L4 · DECISION · Agent · 09:03 ─────────┐
+  const headerText = ` ${level} \u00b7 ${lbl} \u00b7 ${agentShort} \u00b7 ${time} `;
+  const headerFill = SINGLE.h.repeat(Math.max(0, CARD_WIDTH - stringWidth(headerText) - 1));
+  lines.push(color(SINGLE.tl + SINGLE.h) + color(headerText) + color(headerFill + SINGLE.tr));
+
+  // Ligne vide
+  lines.push(color(SINGLE.v) + padEndVisible('', CARD_WIDTH) + color(SINGLE.v));
+
+  if (!options.compact) {
+    // Contenu (word-wrap a CARD_WIDTH - 4 pour padding)
+    const contentLines = wrapText(note.content || '', CARD_WIDTH - 4);
+    for (const cl of contentLines) {
+      lines.push(color(SINGLE.v) + '  ' + padEndVisible(cl, CARD_WIDTH - 2) + color(SINGLE.v));
+    }
+
+    // Actions
+    if (note.extractedActions?.length > 0) {
+      lines.push(color(SINGLE.v) + padEndVisible('', CARD_WIDTH) + color(SINGLE.v));
+      for (const action of note.extractedActions) {
+        const wrapped = wrapText(`\u21b3 ${action}`, CARD_WIDTH - 4);
+        for (let i = 0; i < wrapped.length; i++) {
+          const prefix = i === 0 ? '  ' : '    ';
+          lines.push(color(SINGLE.v) + padEndVisible(`${prefix}${wrapped[i]}`, CARD_WIDTH) + color(SINGLE.v));
+        }
+      }
+    }
+
+    // Ligne vide
+    lines.push(color(SINGLE.v) + padEndVisible('', CARD_WIDTH) + color(SINGLE.v));
+
+    // Footer : tags + provider + ID
+    const tags = (note.tags || []).map(t => `# ${t}`).join('  ');
+    const id = note.id || '';
+    const provider = note.llmProvider ? style.dim(`[${note.llmProvider}${note.llmFallback ? ' fb' : ''}]`) : '';
+    const footerLeft = `  ${tags}`;
+    const footerRight = provider ? `${provider} ${id}  ` : `${id}  `;
+    const totalNeeded = stringWidth(footerLeft) + 1 + stringWidth(footerRight);
+    if (totalNeeded <= CARD_WIDTH) {
+      const gap = CARD_WIDTH - stringWidth(footerLeft) - stringWidth(footerRight);
+      const footer = footerLeft + ' '.repeat(Math.max(1, gap)) + footerRight;
+      lines.push(color(SINGLE.v) + padEndVisible(footer, CARD_WIDTH) + color(SINGLE.v));
+    } else {
+      for (const tl of wrapText(tags, CARD_WIDTH - 4)) {
+        lines.push(color(SINGLE.v) + padEndVisible(`  ${tl}`, CARD_WIDTH) + color(SINGLE.v));
+      }
+      lines.push(color(SINGLE.v) + padEndVisible(`  ${footerRight.trim()}`, CARD_WIDTH) + color(SINGLE.v));
+    }
+  }
+
+  // Bottom border
+  lines.push(color(SINGLE.bl + SINGLE.h.repeat(CARD_WIDTH) + SINGLE.br));
+
+  return lines;
+}
+
+// --- CR card ---
+
+export function renderCrCard(cr, options = {}) {
+  const agentShort = (cr.agentId || '').replace(/^Agent_/i, '');
+  const date = formatDate(cr.period?.from);
+  const time = formatTime(cr.period?.from);
+  const endTime = formatTime(cr.period?.to);
+
+  const lines = [];
+  const dbl = (ch) => style.nemesisAccent(ch);
+
+  // Header double : ╔═ CR · Agent · date heure ═══╗
+  const headerText = ` CR \u00b7 ${agentShort} \u00b7 ${date} ${time} `;
+  const headerFill = DOUBLE.h.repeat(Math.max(0, CARD_WIDTH - stringWidth(headerText) - 1));
+  lines.push(dbl(DOUBLE.tl + DOUBLE.h) + dbl(headerText) + dbl(headerFill + DOUBLE.tr));
+
+  // Ligne vide
+  lines.push(dbl(DOUBLE.v) + padEndVisible('', CARD_WIDTH) + dbl(DOUBLE.v));
+
+  // Titre
+  const titleLine = `  ${style.bold(cr.title || 'CR sans titre')}`;
+  lines.push(dbl(DOUBLE.v) + padEndVisible(titleLine, CARD_WIDTH) + dbl(DOUBLE.v));
+
+  // Periode + notes + trigger
+  const metaLine = `  Periode : ${time} \u2192 ${endTime}  \u00b7  ${cr.noteCount || 0} notes  \u00b7  ${cr.trigger || '-'}`;
+  lines.push(dbl(DOUBLE.v) + padEndVisible(metaLine, CARD_WIDTH) + dbl(DOUBLE.v));
+
+  if (!options.compact) {
+    lines.push(dbl(DOUBLE.v) + padEndVisible('', CARD_WIDTH) + dbl(DOUBLE.v));
+
+    // Section CONTEXTE PRECEDENT
+    if (cr.previousCrSummary) {
+      lines.push(dbl(DOUBLE.v) + padEndVisible(`  ${style.bold('\u25b6 CONTEXTE PRECEDENT')}`, CARD_WIDTH) + dbl(DOUBLE.v));
+      for (const cl of wrapText(cr.previousCrSummary, CARD_WIDTH - 4)) {
+        lines.push(dbl(DOUBLE.v) + padEndVisible(`  ${cl}`, CARD_WIDTH) + dbl(DOUBLE.v));
+      }
+      lines.push(dbl(DOUBLE.v) + padEndVisible('', CARD_WIDTH) + dbl(DOUBLE.v));
+    }
+
+    // Section DECISIONS
+    if (cr.decisions?.length > 0) {
+      lines.push(dbl(DOUBLE.v) + padEndVisible(`  ${style.bold('\u25b6 DECISIONS')}`, CARD_WIDTH) + dbl(DOUBLE.v));
+      for (const d of cr.decisions) {
+        const wrapped = wrapText(`\u2022 ${d}`, CARD_WIDTH - 4);
+        for (let i = 0; i < wrapped.length; i++) {
+          const prefix = i === 0 ? '  ' : '    ';
+          lines.push(dbl(DOUBLE.v) + padEndVisible(`${prefix}${wrapped[i]}`, CARD_WIDTH) + dbl(DOUBLE.v));
+        }
+      }
+      lines.push(dbl(DOUBLE.v) + padEndVisible('', CARD_WIDTH) + dbl(DOUBLE.v));
+    }
+
+    // Section ACTIONS EN ATTENTE
+    if (cr.actions?.length > 0) {
+      lines.push(dbl(DOUBLE.v) + padEndVisible(`  ${style.bold('\u25b6 ACTIONS EN ATTENTE')}`, CARD_WIDTH) + dbl(DOUBLE.v));
+      for (const a of cr.actions) {
+        const wrapped = wrapText(`\u2022 ${a}`, CARD_WIDTH - 4);
+        for (let i = 0; i < wrapped.length; i++) {
+          const prefix = i === 0 ? '  ' : '    ';
+          lines.push(dbl(DOUBLE.v) + padEndVisible(`${prefix}${wrapped[i]}`, CARD_WIDTH) + dbl(DOUBLE.v));
+        }
+      }
+      lines.push(dbl(DOUBLE.v) + padEndVisible('', CARD_WIDTH) + dbl(DOUBLE.v));
+    }
+
+    // Footer : notes liees + ID
+    const noteIds = (cr.noteIds || []);
+    let notesRef = noteIds.slice(0, 3).join(' ');
+    if (noteIds.length > 3) notesRef += ` ... (+${noteIds.length - 3})`;
+    const footerLeft = `  Notes liees : ${notesRef}`;
+    const crId = cr.id || '';
+    const crIdRight = `${crId}  `;
+    const totalNeeded = stringWidth(footerLeft) + 1 + stringWidth(crIdRight);
+    if (totalNeeded <= CARD_WIDTH) {
+      const gap = CARD_WIDTH - stringWidth(footerLeft) - stringWidth(crIdRight);
+      const footer = footerLeft + ' '.repeat(Math.max(1, gap)) + crIdRight;
+      lines.push(dbl(DOUBLE.v) + padEndVisible(footer, CARD_WIDTH) + dbl(DOUBLE.v));
+    } else {
+      for (const fl of wrapText(`Notes liees : ${notesRef}`, CARD_WIDTH - 4)) {
+        lines.push(dbl(DOUBLE.v) + padEndVisible(`  ${fl}`, CARD_WIDTH) + dbl(DOUBLE.v));
+      }
+      lines.push(dbl(DOUBLE.v) + padEndVisible(`  ${crId}`, CARD_WIDTH) + dbl(DOUBLE.v));
+    }
+  }
+
+  // Bottom : bordure simple pour le bas (comme le mockup spec)
+  lines.push(SINGLE.bl + SINGLE.h.repeat(CARD_WIDTH) + SINGLE.br);
+
+  return lines;
+}
+
+// --- Utilitaires ---
+
+export function formatTime(isoString) {
+  if (!isoString) return '--:--';
+  const d = new Date(isoString);
+  return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+}
+
+export function formatDate(isoString) {
+  if (!isoString) return '--/--/----';
+  const d = new Date(isoString);
+  return `${String(d.getDate()).padStart(2, '0')}/${String(d.getMonth() + 1).padStart(2, '0')}/${d.getFullYear()}`;
+}
+
+export function wrapText(text, maxWidth) {
+  if (!text) return [];
+  const words = text.split(/\s+/);
+  const lines = [];
+  let current = '';
+  for (const word of words) {
+    if (current && stringWidth(current + ' ' + word) > maxWidth) {
+      lines.push(current);
+      current = word;
+    } else {
+      current = current ? current + ' ' + word : word;
+    }
+  }
+  if (current) lines.push(current);
+  return lines;
+}

package/lib/ui/note-colors.js

@@ -0,0 +1,26 @@
+import { style } from './colors.js';
+
+export const LEVEL_COLORS = {
+  L1: { r: 34,  g: 197, b: 94,  label: 'INFO' },
+  L2: { r: 59,  g: 130, b: 246, label: 'ECHANGE' },
+  L3: { r: 139, g: 92,  b: 246, label: 'CLARIFICATION' },
+  L4: { r: 249, g: 115, b: 22,  label: 'DECISION' },
+  L5: { r: 199, g: 18,  b: 68,  label: 'CRITIQUE' },
+};
+
+export function levelColor(level, text) {
+  const c = LEVEL_COLORS[level] || LEVEL_COLORS.L1;
+  return style.rgb(c.r, c.g, c.b, text);
+}
+
+export function levelLabel(level) {
+  return (LEVEL_COLORS[level] || LEVEL_COLORS.L1).label;
+}
+
+export function levelDot(level) {
+  return levelColor(level, '\u25CF');
+}
+
+export function levelBorder(level, char) {
+  return levelColor(level, char);
+}