@xxkeefer/mrkl 0.4.0 → 0.4.1

package/dist/chunks/list-tui.mjs

@@ -0,0 +1,252 @@
+import { Fzf } from 'fzf';
+
+const ESC = "\x1B";
+const CSI = `${ESC}[`;
+const ALT_SCREEN_ON = `${CSI}?1049h`;
+const ALT_SCREEN_OFF = `${CSI}?1049l`;
+const CURSOR_HIDE = `${CSI}?25l`;
+const CURSOR_SHOW = `${CSI}?25h`;
+const CLEAR_SCREEN = `${CSI}2J${CSI}H`;
+const BOLD = `${CSI}1m`;
+const UNDERLINE = `${CSI}4m`;
+const RESET = `${CSI}0m`;
+const INVERSE = `${CSI}7m`;
+const FG_CYAN = `${CSI}36m`;
+const FG_YELLOW = `${CSI}33m`;
+const FG_GREEN = `${CSI}32m`;
+const FG_RED = `${CSI}31m`;
+const FG_GRAY = `${CSI}90m`;
+function statusColor(status) {
+  switch (status) {
+    case "todo":
+      return FG_YELLOW;
+    case "in-progress":
+      return FG_CYAN;
+    case "done":
+      return FG_GREEN;
+    case "closed":
+      return FG_RED;
+    default:
+      return "";
+  }
+}
+function buildEntries(tasks) {
+  return tasks.map((task) => ({
+    task,
+    searchText: `${task.id} ${task.type} ${task.status} ${task.title} ${task.description}`
+  }));
+}
+async function interactiveList(tasks, archivedTasks) {
+  const { stdin, stdout } = process;
+  const datasets = [
+    { label: "Tasks", entries: buildEntries(tasks) },
+    { label: "Archive", entries: buildEntries(archivedTasks) }
+  ];
+  let activeTab = 0;
+  let query = "";
+  let selectedIndex = 0;
+  let scrollOffset = 0;
+  function getFiltered() {
+    const entries = datasets[activeTab].entries;
+    if (!query) return entries;
+    const fzf = new Fzf(entries, { selector: (e) => e.searchText });
+    return fzf.find(query).map((r) => r.item);
+  }
+  function getTermSize() {
+    return { cols: stdout.columns || 80, rows: stdout.rows || 24 };
+  }
+  function render() {
+    const { cols, rows } = getTermSize();
+    const filtered = getFiltered();
+    const buf = [];
+    const tabParts = datasets.map((ds, i) => {
+      if (i === activeTab) {
+        return `${FG_CYAN}${BOLD}[${ds.label}]${RESET}`;
+      }
+      return `${FG_GRAY} ${ds.label} ${RESET}`;
+    });
+    buf.push(tabParts.join("  "));
+    buf.push("");
+    buf.push(`${FG_CYAN}>${RESET} ${query}${UNDERLINE} ${RESET}`);
+    const listWidth = Math.floor(cols * 0.55);
+    const previewWidth = cols - listWidth - 3;
+    buf.push(`${FG_GRAY}${"\u2500".repeat(listWidth)}\u252C${"\u2500".repeat(previewWidth + 2)}${RESET}`);
+    const headerLine = formatRow("ID", "TYPE", "STATUS", "TITLE", listWidth);
+    buf.push(`${BOLD}${headerLine}${RESET}${FG_GRAY}\u2502${RESET}${BOLD} Preview${RESET}`);
+    buf.push(`${FG_GRAY}${"\u2500".repeat(listWidth)}\u253C${"\u2500".repeat(previewWidth + 2)}${RESET}`);
+    const contentRows = rows - 9;
+    const maxVisible = Math.max(1, contentRows);
+    if (filtered.length === 0) {
+      selectedIndex = 0;
+    } else {
+      selectedIndex = Math.min(selectedIndex, filtered.length - 1);
+      selectedIndex = Math.max(selectedIndex, 0);
+    }
+    if (selectedIndex < scrollOffset) scrollOffset = selectedIndex;
+    if (selectedIndex >= scrollOffset + maxVisible) scrollOffset = selectedIndex - maxVisible + 1;
+    const selectedTask = filtered[selectedIndex]?.task;
+    const previewLines = buildPreviewLines(selectedTask, previewWidth);
+    for (let i = 0; i < maxVisible; i++) {
+      const taskIdx = scrollOffset + i;
+      const entry = filtered[taskIdx];
+      let leftPart;
+      if (!entry) {
+        leftPart = " ".repeat(listWidth);
+      } else {
+        const isSelected = taskIdx === selectedIndex;
+        const row = formatRow(entry.task.id, entry.task.type, entry.task.status, entry.task.title, listWidth);
+        if (isSelected) {
+          leftPart = `${INVERSE}${row}${RESET}`;
+        } else {
+          const sc = statusColor(entry.task.status);
+          leftPart = colorizeRow(entry.task.id, entry.task.type, entry.task.status, entry.task.title, listWidth, sc);
+        }
+      }
+      const rightPart = previewLines[i] ?? "";
+      buf.push(`${leftPart}${FG_GRAY}\u2502${RESET} ${rightPart}`);
+    }
+    buf.push(`${FG_GRAY}${"\u2500".repeat(listWidth)}\u2534${"\u2500".repeat(previewWidth + 2)}${RESET}`);
+    const countInfo = `${filtered.length}/${datasets[activeTab].entries.length}`;
+    buf.push(`${FG_GRAY}${countInfo} tasks  \u2191\u2193: navigate  Tab: switch  Enter: select  Esc: quit  Type to search${RESET}`);
+    stdout.write(CLEAR_SCREEN + buf.join("\n"));
+  }
+  function formatRow(id, type, status, title, width) {
+    const idCol = id.padEnd(14);
+    const typeCol = type.padEnd(12);
+    const statusCol = status.padEnd(14);
+    const usedWidth = 14 + 12 + 14;
+    const titleWidth = Math.max(1, width - usedWidth);
+    const titleCol = title.length > titleWidth ? title.slice(0, titleWidth - 1) + "\u2026" : title.padEnd(titleWidth);
+    return `${idCol}${typeCol}${statusCol}${titleCol}`;
+  }
+  function colorizeRow(id, type, status, title, width, sc) {
+    const idCol = id.padEnd(14);
+    const typeCol = type.padEnd(12);
+    const statusCol = status.padEnd(14);
+    const usedWidth = 14 + 12 + 14;
+    const titleWidth = Math.max(1, width - usedWidth);
+    const titleCol = title.length > titleWidth ? title.slice(0, titleWidth - 1) + "\u2026" : title.padEnd(titleWidth);
+    return `${FG_CYAN}${idCol}${RESET}${typeCol}${sc}${statusCol}${RESET}${titleCol}`;
+  }
+  function buildPreviewLines(task, width) {
+    if (!task) return [];
+    const lines = [];
+    lines.push(`${BOLD}${task.id}${RESET} ${FG_GRAY}${task.type}${RESET} ${statusColor(task.status)}${task.status}${RESET}`);
+    lines.push(`${BOLD}${task.title}${RESET}`);
+    lines.push("");
+    if (task.description) {
+      lines.push(`${UNDERLINE}Description${RESET}`);
+      for (const line of wrapText(task.description, width)) {
+        lines.push(line);
+      }
+      lines.push("");
+    }
+    if (task.acceptance_criteria.length > 0) {
+      lines.push(`${UNDERLINE}Acceptance Criteria${RESET}`);
+      for (const ac of task.acceptance_criteria) {
+        for (const line of wrapText(`- [ ] ${ac}`, width)) {
+          lines.push(line);
+        }
+      }
+    }
+    return lines;
+  }
+  function wrapText(text, width) {
+    if (width <= 0) return [text];
+    const result = [];
+    for (const rawLine of text.split("\n")) {
+      const words = rawLine.split(" ");
+      let current = "";
+      for (const word of words) {
+        if (current.length + word.length + 1 > width && current.length > 0) {
+          result.push(current);
+          current = word;
+        } else {
+          current = current ? `${current} ${word}` : word;
+        }
+      }
+      if (current) result.push(current);
+    }
+    return result;
+  }
+  if (stdin.isTTY) stdin.setRawMode(true);
+  stdin.resume();
+  stdin.setEncoding("utf-8");
+  stdout.write(ALT_SCREEN_ON + CURSOR_HIDE);
+  render();
+  return new Promise((resolve) => {
+    function cleanup() {
+      stdout.write(CURSOR_SHOW + ALT_SCREEN_OFF);
+      if (stdin.isTTY) stdin.setRawMode(false);
+      stdin.pause();
+      stdin.removeListener("data", onData);
+    }
+    function onData(data) {
+      const filtered = getFiltered();
+      for (let i = 0; i < data.length; i++) {
+        const ch = data[i];
+        if (ch === ESC) {
+          if (data[i + 1] === "[") {
+            const arrow = data[i + 2];
+            if (arrow === "A") {
+              if (selectedIndex > 0) selectedIndex--;
+              i += 2;
+              continue;
+            }
+            if (arrow === "B") {
+              if (selectedIndex < filtered.length - 1) selectedIndex++;
+              i += 2;
+              continue;
+            }
+            i += 2;
+            continue;
+          }
+          cleanup();
+          resolve();
+          return;
+        }
+        if (ch === "") {
+          cleanup();
+          resolve();
+          return;
+        }
+        if (ch === "	") {
+          activeTab = (activeTab + 1) % datasets.length;
+          query = "";
+          selectedIndex = 0;
+          scrollOffset = 0;
+          continue;
+        }
+        if (ch === "\r" || ch === "\n") {
+          cleanup();
+          const selected = getFiltered()[selectedIndex];
+          if (selected) {
+            process.stdout.write(`
+Selected: ${selected.task.id} - ${selected.task.title}
+`);
+          }
+          resolve();
+          return;
+        }
+        if (ch === "\x7F" || ch === "\b") {
+          if (query.length > 0) {
+            query = query.slice(0, -1);
+            selectedIndex = 0;
+            scrollOffset = 0;
+          }
+          continue;
+        }
+        if (ch >= " " && ch <= "~") {
+          query += ch;
+          selectedIndex = 0;
+          scrollOffset = 0;
+        }
+      }
+      render();
+    }
+    stdin.on("data", onData);
+    stdout.on("resize", () => render());
+  });
+}
+
+export { interactiveList };

package/dist/cli.mjs

@@ -231,6 +231,25 @@ function executePrune(dir, filenames) {
     unlinkSync(join(archiveDir, f));
   }
 }
+function listArchivedTasks(filter) {
+  const config = loadConfig(filter.dir);
+  const archiveDir = join(filter.dir, config.tasks_dir, ".archive");
+  if (!existsSync(archiveDir)) return [];
+  const files = readdirSync(archiveDir).filter((f) => f.endsWith(".md") && !f.startsWith("."));
+  let tasks = files.flatMap((f) => {
+    try {
+      const content = readFileSync(join(archiveDir, f), "utf-8");
+      const task = parse(content, f);
+      if (!task.id || !task.type || !task.status) return [];
+      return [task];
+    } catch {
+      return [];
+    }
+  });
+  if (filter.type) tasks = tasks.filter((t) => t.type === filter.type);
+  if (filter.status) tasks = tasks.filter((t) => t.status === filter.status);
+  return tasks;
+}
 function closeTask(dir, id) {
   const config = loadConfig(dir);
   const tasksDir = join(dir, config.tasks_dir);
@@ -357,6 +376,12 @@ const createCommand = defineCommand({
   }
 });
 
+const COL_ID = 14;
+const COL_TYPE = 12;
+const COL_STATUS = 14;
+function formatRow(id, type, status, title) {
+  return `${id.padEnd(COL_ID)}${type.padEnd(COL_TYPE)}${status.padEnd(COL_STATUS)}${title}`;
+}
 const listCommand = defineCommand({
   meta: {
     name: "list",
@@ -372,23 +397,46 @@ const listCommand = defineCommand({
       type: "string",
       alias: "s",
       description: "Filter by status (todo, in-progress, done)"
+    },
+    plain: {
+      type: "boolean",
+      alias: "p",
+      description: "Plain text output (no interactive TUI)"
     }
   },
-  run({ args }) {
+  async run({ args }) {
     const dir = process.cwd();
     try {
-      const tasks = listTasks({
+      const filter = {
         dir,
         type: args.type,
         status: args.status
-      });
-      if (tasks.length === 0) {
-        consola.info("\u{1F4ED} No tasks found");
+      };
+      const tasks = listTasks(filter);
+      const archivedTasks = listArchivedTasks(filter);
+      if (tasks.length === 0 && archivedTasks.length === 0) {
+        consola.info("No tasks found");
         return;
       }
-      for (const task of tasks) {
-        consola.log(`${task.id}  ${task.type.padEnd(10)} ${task.status.padEnd(12)} ${task.title}`);
+      const usePlain = args.plain || !process.stdout.isTTY;
+      if (usePlain) {
+        consola.log(formatRow("ID", "TYPE", "STATUS", "TITLE"));
+        consola.log("\u2500".repeat(60));
+        for (const task of tasks) {
+          consola.log(formatRow(task.id, task.type, task.status, task.title));
+        }
+        if (archivedTasks.length > 0) {
+          consola.log("");
+          consola.log(`Archive (${archivedTasks.length}):`);
+          consola.log("\u2500".repeat(60));
+          for (const task of archivedTasks) {
+            consola.log(formatRow(task.id, task.type, task.status, task.title));
+          }
+        }
+        return;
       }
+      const { interactiveList } = await import('./chunks/list-tui.mjs');
+      await interactiveList(tasks, archivedTasks);
     } catch (err) {
       consola.error(String(err.message));
       process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xxkeefer/mrkl",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Lightweight CLI tool for structured markdown task tracking",
   "bin": {
@@ -28,6 +28,7 @@
   "dependencies": {
     "citty": "^0.1.6",
     "consola": "^3.4.0",
+    "fzf": "^0.5.2",
     "gray-matter": "^4.0.3",
     "smol-toml": "^1.3.1"
   },