kanbango 3.0.2 → 3.1.0

package/AGENTS.md

@@ -6,8 +6,11 @@ This document provides build commands, testing procedures, and code style guidel
 
 Source of truth: `agent-playbook.js` (also MCP tool descriptions + `kanban_read` `operation=help`).
 
+- hierarchy: epic (context) → task (work+plan) → subtasks (steps)
 - list: `col` filter, `view=summary`; keep `task_id`s; no full-board re-list after every write
+- list_epics / show_epic for initiatives; filter tasks with `epic=E001`
 - show: `view=execution` while coding; `full` only if needed
+- epic_create with description/goals; create tasks with `epic=E001` (prefer id)
 - create once with `description`, `specs`, `in_scope`, `out_of_scope`, `acceptance_criteria`
 - move/update: `return=none`; subtasks = full array replace (no toggle)
 - non-trivial work: `plan_create` → `plan_advance` → `plan_evidence` (real tests, truncated logs) → `plan_done`

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to kanbango will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2026-07-30
+
+### Added
+- First-class epic containers under `backlog/epics/E00N.json` (description, goals, in/out scope, notes)
+- Task field `epic_id` with denormalized `epic_group` title for lists/GUI
+- Derived epic status/progress from child task columns (no epic board column)
+- MCP: `list_epics`, `show_epic`, `epic_create`, `epic_update`
+- CLI: `kanban epic list|show|add|update`
+- HTTP: `GET/POST /api/epics` for real epics; `POST /api/tasks` for tasks (legacy `/api/epics` + `column` still creates tasks)
+- Auto-migration of legacy `epic_group` string labels into epic entities
+- GUI swimlanes group by `epic_id` and show epic context
+- Regression tests in `tests/epics.test.js`
+
+### Changed
+- Hierarchy documented for agents: epic → task → subtasks
+- Task summary view includes `epic_id`
+- Agent playbook includes epic discovery/create rules
+
 ## [3.0.2] - 2026-07-29
 
 ### Added

package/README.md

@@ -31,8 +31,13 @@ kanban serve
 # List all tasks
 kanban list --json
 
-# Add a task
-kanban add "My task" --col planned --epic "Phase 1"
+# Add an epic (initiative container), then a task under it
+kanban epic add "Phase 1" --description "Why this initiative" --goals "Ship X"
+kanban add "My task" --col planned --epic E001
+
+# List epics / show epic with child rollup
+kanban epic list --json
+kanban epic show E001
 
 # Show details
 kanban show 001
@@ -44,6 +49,16 @@ kanban move 001 active
 kanban update 001 '{"subtasks":[{"done":true,"text":"Research"},{"done":false,"text":"Implementation"}]}'
 ```
 
+### Hierarchy
+
+| Level | What | Storage |
+|-------|------|---------|
+| **Epic** | Initiative context (description, goals) | `backlog/epics/E001.json` |
+| **Task** | Kanban card (column, AC, plan) | `backlog/{col}/001.json` |
+| **Subtask** | Checklist / plan steps | `subtasks[]` on task |
+
+Epic status is **derived** from child task columns (not a board column).
+
 ### Columns
 
 | Column | Purpose |
@@ -163,7 +178,7 @@ kanban serve
 
 ```js
 const kanban = require('kanbango');
-const tasks = await kanban.allEpics();
+const tasks = await kanban.allTasks();
 ```
 
 ## Requirements

package/agent-playbook.js

@@ -6,8 +6,11 @@
 
 const DROP_IN_RULE = [
   'Kanbango MCP — token rules:',
+  '- hierarchy: epic (context) → task (work+plan) → subtasks (steps)',
   '- list: col filter, view=summary; keep task_ids; no full-board re-list after writes',
+  '- list_epics / show_epic for initiatives; list tasks with epic=E001 for work',
   '- show: view=execution while coding; full only if needed',
+  '- epic_create with description/goals; create tasks with epic=E001 (prefer id)',
   '- create once with description,specs,in_scope,out_of_scope,acceptance_criteria',
   '- move/update: return=none; subtasks=full array replace',
   '- non-trivial: plan_create → plan_advance → plan_evidence (real tests, truncated logs) → plan_done',
@@ -17,21 +20,25 @@ const DROP_IN_RULE = [
 const TOOL_DESCRIPTIONS = {
   kanban_read: [
     'Read board. TOKEN RULES: list defaults to view=summary (id/title/col/progress only).',
+    'Hierarchy: epic (container/context) → task (work) → subtasks (steps).',
     'Always pass col when possible. Prefer show+view=execution over full.',
+    'list_epics/show_epic for initiatives; filter list with epic=E001 or epic title.',
     'Do not re-list the whole board after every write — keep task_id from create/move.',
-    'IDs are numeric ("014" or "14"). views: summary|planning|execution|full; fields[] overrides view.',
+    'Task IDs numeric ("014"); epic IDs "E001". views: summary|planning|execution|full; fields[] overrides view.',
     'operation=help returns this playbook as short text (no board I/O).'
   ].join(' '),
 
   kanban_manage: [
     'Write board / plan. TOKEN RULES: one create with all planning fields beats many updates;',
     'after write use return=none (or summary). Do not dump full task unless needed.',
-    'Actions: create|move|update (daily); plan_create→plan_advance→plan_evidence→plan_done (non-trivial only).',
+    'Actions: create|move|update (daily); epic_create|epic_update (containers);',
+    'plan_create→plan_advance→plan_evidence→plan_done (non-trivial only).',
+    'epic_create: title + description/goals/in_scope/out_of_scope. Link tasks via epic=E001.',
     'create/plan_create: title required; also send description,specs,in_scope,out_of_scope,acceptance_criteria',
     '(missing → warnings, not failure). move: task_id+column. update: task_id + fields or subtasks[] full list',
     '(no toggle). plan_evidence needs real test run: diff,test_command,stdout,stderr,exit_code — truncate logs.',
-    'Example create: {"action":"create","title":"Ship image","description":"...","specs":"...","in_scope":["CLI"],',
-    '"out_of_scope":["GUI"],"acceptance_criteria":["npm test passes"],"col":"planned"}'
+    'Example create: {"action":"create","title":"Ship image","epic":"E001","description":"...","specs":"...",',
+    '"in_scope":["CLI"],"out_of_scope":["GUI"],"acceptance_criteria":["npm test passes"],"col":"planned"}'
   ].join(' '),
 
   kanban_gui: [
@@ -47,7 +54,8 @@ const MUST_CONTAIN = [
   'return=none',
   'plan_create',
   'external_running',
-  'subtasks'
+  'subtasks',
+  'epic_create'
 ];
 
 function playbookHelpPayload() {

package/bin/kanban.js

@@ -99,7 +99,8 @@ async function cliInit() {
         + '- `active/`  — w trakcie (max 1-2)\n'
         + '- `planned/` — zaplanowane\n'
         + '- `icebox/`  — zamrozone / nice-to-have\n'
-        + '- `done/`    — ukonczone\n',
+        + '- `done/`    — ukonczone\n'
+        + '- `epics/`   — first-class epic containers (context for initiatives)\n',
       'utf-8'
     );
   }
@@ -145,13 +146,14 @@ async function cliMcpInit(options) {
 }
 
 async function cliList(colFilter, epicFilter, asJson) {
-  let tasks = await kanban.allEpics();
+  await kanban.migrateEpicGroups();
+  let tasks = await kanban.allTasks();
 
   if (colFilter) {
     tasks = tasks.filter((task) => task.column === colFilter);
   }
   if (epicFilter) {
-    tasks = tasks.filter((task) => task.epic_group === epicFilter);
+    tasks = tasks.filter((task) => kanban.taskMatchesEpicFilter(task, epicFilter));
   }
 
   if (asJson) {
@@ -168,8 +170,11 @@ async function cliList(colFilter, epicFilter, asJson) {
     const progress = kanban.getProgress(task);
     const prog = progress.total ? `${progress.done}/${progress.total}` : '—';
     const title = displayTitle(task).substring(0, 42);
+    const epicLabel = task.epic_id
+      ? `${task.epic_id}:${task.epic_group}`
+      : task.epic_group;
     console.log(
-      `  ${task.column.padEnd(8)}  ${shortId(task.id).padEnd(8)}  ${title.padEnd(43)}  ${prog.padStart(5)}  [${task.epic_group}]`
+      `  ${task.column.padEnd(8)}  ${shortId(task.id).padEnd(8)}  ${title.padEnd(43)}  ${prog.padStart(5)}  [${epicLabel}]`
     );
   }
 }
@@ -181,7 +186,7 @@ async function cliShow(taskId) {
     console.log(`Plik:    ${taskFilePath(task)}`);
     console.log(`Tytuł:   ${displayTitle(task)}`);
     console.log(`Kolumna: ${task.column}`);
-    console.log(`Epik:    ${task.epic_group}`);
+    console.log(`Epik:    ${task.epic_id ? `${task.epic_id} (${task.epic_group})` : task.epic_group}`);
     console.log(`Worzono: ${task.created || '—'}`);
 
     if (task.description) {
@@ -202,6 +207,64 @@ async function cliShow(taskId) {
   }
 }
 
+async function cliEpicList(asJson) {
+  await kanban.migrateEpicGroups();
+  const tasks = await kanban.allTasks();
+  const epics = await kanban.listEpicEntities();
+  const shaped = epics.map((epic) => kanban.shapeEpic(epic, tasks, { view: 'summary' }));
+
+  if (asJson) {
+    console.log(JSON.stringify(shaped, null, 2));
+    return;
+  }
+
+  if (shaped.length === 0) {
+    console.log('(brak epików)');
+    return;
+  }
+
+  for (const epic of shaped) {
+    const p = epic.progress || {};
+    console.log(
+      `  ${epic.id.padEnd(6)}  ${epic.status.padEnd(8)}  ${String(epic.title).substring(0, 40).padEnd(40)}  ${p.tasks_done || 0}/${p.tasks_total || 0} tasks`
+    );
+  }
+}
+
+async function cliEpicShow(epicId) {
+  try {
+    await kanban.migrateEpicGroups();
+    const link = await kanban.resolveEpicRef(epicId, { createIfMissing: false });
+    const epic = await kanban.getEpicEntity(link.epic_id);
+    const tasks = await kanban.allTasks();
+    const shaped = kanban.shapeEpic(epic, tasks, { view: 'full' });
+    console.log(JSON.stringify(shaped, null, 2));
+  } catch (error) {
+    console.error(`✗ ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function cliEpicAdd(title, options = {}) {
+  try {
+    const epic = await kanban.doCreateEpic(title, options);
+    console.log(`✓ Epic ${epic.id}: ${epic.title}`);
+  } catch (error) {
+    console.error(`✗ ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function cliEpicUpdate(epicId, patch) {
+  try {
+    const epic = await kanban.updateEpicEntity(epicId, patch);
+    console.log(`✓ Epic ${epic.id} updated`);
+  } catch (error) {
+    console.error(`✗ ${error.message}`);
+    process.exit(1);
+  }
+}
+
 async function cliMove(taskId, column) {
   const success = await kanban.doMove(taskId, column);
   if (success) {
@@ -238,29 +301,87 @@ async function serveWeb(port) {
       }
 
       if (requestPath === '/api/board') {
-        const tasks = await kanban.allEpics();
+        await kanban.migrateEpicGroups();
+        const tasks = await kanban.allTasks();
         sendJson(res, 200, tasks);
         return;
       }
 
+      if (requestPath === '/api/epics' && req.method === 'GET') {
+        await kanban.migrateEpicGroups();
+        const tasks = await kanban.allTasks();
+        const epics = await kanban.listEpicEntities();
+        sendJson(res, 200, epics.map((epic) => kanban.shapeEpic(epic, tasks, { view: 'full' })));
+        return;
+      }
+
       if (requestPath === '/api/epics' && req.method === 'POST') {
         const body = await readBody(req);
-        const task = await kanban.doCreate(body.title || '', body.column || 'planned', body.epic_group || '—', {
-          description: body.description,
-          specs: body.specs,
-          in_scope: body.in_scope,
-          out_of_scope: body.out_of_scope,
-          acceptance_criteria: body.acceptance_criteria,
-          test_cases: body.test_cases,
-          subtasks: body.subtasks,
-          notes: body.notes
-        });
+        // Real epic container when no task column is provided.
+        if (body.column === undefined && body.as_task !== true) {
+          const epic = await kanban.doCreateEpic(body.title || '', {
+            description: body.description,
+            goals: body.goals,
+            in_scope: body.in_scope,
+            out_of_scope: body.out_of_scope,
+            notes: body.notes
+          });
+          sendJson(res, 201, kanban.shapeEpic(epic, [], { view: 'full' }));
+          return;
+        }
+
+        const task = await kanban.doCreate(
+          body.title || '',
+          body.column || 'planned',
+          body.epic_id || body.epic || body.epic_group || '—',
+          {
+            description: body.description,
+            specs: body.specs,
+            in_scope: body.in_scope,
+            out_of_scope: body.out_of_scope,
+            acceptance_criteria: body.acceptance_criteria,
+            test_cases: body.test_cases,
+            subtasks: body.subtasks,
+            notes: body.notes
+          }
+        );
+        sendJson(res, 201, task);
+        return;
+      }
+
+      if (requestPath === '/api/tasks' && req.method === 'POST') {
+        const body = await readBody(req);
+        const task = await kanban.doCreate(
+          body.title || '',
+          body.column || 'planned',
+          body.epic_id || body.epic || body.epic_group || '—',
+          {
+            description: body.description,
+            specs: body.specs,
+            in_scope: body.in_scope,
+            out_of_scope: body.out_of_scope,
+            acceptance_criteria: body.acceptance_criteria,
+            test_cases: body.test_cases,
+            subtasks: body.subtasks,
+            notes: body.notes
+          }
+        );
         sendJson(res, 201, task);
         return;
       }
 
       if (req.method === 'PATCH') {
-        const moveMatch = requestPath.match(/^\/api\/epics\/([^/]+)\/move$/);
+        const epicUpdateMatch = requestPath.match(/^\/api\/epic-entities\/([^/]+)$/);
+        if (epicUpdateMatch) {
+          const body = await readBody(req);
+          const patch = body.patch ? { ...body.patch } : { ...body };
+          delete patch.patch;
+          const epic = await kanban.updateEpicEntity(epicUpdateMatch[1], patch);
+          sendJson(res, 200, kanban.shapeEpic(epic, await kanban.allTasks(), { view: 'full' }));
+          return;
+        }
+
+        const moveMatch = requestPath.match(/^\/api\/(?:epics|tasks)\/([^/]+)\/move$/);
         if (moveMatch) {
           const taskId = moveMatch[1];
           const body = await readBody(req);
@@ -269,7 +390,7 @@ async function serveWeb(port) {
           return;
         }
 
-        const toggleMatch = requestPath.match(/^\/api\/epics\/([^/]+)\/tasks\/(\d+)$/);
+        const toggleMatch = requestPath.match(/^\/api\/(?:epics|tasks)\/([^/]+)\/tasks\/(\d+)$/);
         if (toggleMatch) {
           const taskId = toggleMatch[1];
           const idx = parseInt(toggleMatch[2], 10);
@@ -294,7 +415,7 @@ async function serveWeb(port) {
           return;
         }
 
-        const updateMatch = requestPath.match(/^\/api\/epics\/([^/]+)$/);
+        const updateMatch = requestPath.match(/^\/api\/(?:epics|tasks)\/([^/]+)$/);
         if (updateMatch) {
           const taskId = updateMatch[1];
           const body = await readBody(req);
@@ -309,7 +430,9 @@ async function serveWeb(port) {
           if (body.test_cases !== undefined) patch.test_cases = body.test_cases;
           if (body.subtasks !== undefined) patch.subtasks = body.subtasks;
           if (body.notes !== undefined) patch.notes = body.notes;
-          if (body.epic_group !== undefined) patch.epic_group = body.epic_group;
+          if (body.epic_id !== undefined) patch.epic_id = body.epic_id;
+          else if (body.epic !== undefined) patch.epic = body.epic;
+          else if (body.epic_group !== undefined) patch.epic_group = body.epic_group;
 
           const task = await kanban.updateTask(taskId, patch);
           sendJson(res, 200, task);
@@ -506,6 +629,26 @@ async function main() {
     }
 
     await cliList(colFilter, epicFilter, asJson);
+  } else if (cmd === 'epic') {
+    const sub = args[1];
+    if (sub === 'list') {
+      await cliEpicList(args.includes('--json'));
+    } else if (sub === 'show' && args[2]) {
+      await cliEpicShow(args[2]);
+    } else if (sub === 'add' && args[2]) {
+      let description = '';
+      let goals = '';
+      for (let i = 3; i < args.length; i++) {
+        if (args[i] === '--description' && args[i + 1]) description = args[++i];
+        else if (args[i] === '--goals' && args[i + 1]) goals = args[++i];
+      }
+      await cliEpicAdd(args[2], { description, goals });
+    } else if (sub === 'update' && args[2] && args[3]) {
+      await cliEpicUpdate(args[2], parseJsonPayload(args[3]));
+    } else {
+      console.error('Usage: kanban epic list|show|add|update ...');
+      process.exit(1);
+    }
   } else if (cmd === 'show' && args[1]) {
     await cliShow(args[1]);
   } else if (cmd === 'move' && args[1] && args[2]) {

package/index.html

@@ -529,29 +529,34 @@ const COL_DEFS = [
   { id: "done",    label: "✅ Done",    icon: "✅" },
 ];
 
-let allEpics   = [];
+let allTasks   = [];
+let allEpicEntities = [];
 let colCounts  = {};
 let collapsed  = new Set();
 let expanded   = new Set();
 let editingId  = null;
-let dirtyEdits = {}; // epicId -> editable task draft
+let dirtyEdits = {}; // taskId -> editable task draft
 
 // ── Load & render ─────────────────────────────────────────────────────────────
 
 async function load() {
-  const res = await fetch("/api/board");
-  allEpics = await res.json();
+  const [boardRes, epicsRes] = await Promise.all([
+    fetch("/api/board"),
+    fetch("/api/epics")
+  ]);
+  allTasks = await boardRes.json();
+  allEpicEntities = epicsRes.ok ? await epicsRes.json() : [];
   render();
 }
 
 function render() {
   colCounts = {};
   COL_DEFS.forEach(c => (colCounts[c.id] = 0));
-  allEpics.forEach(e => { if (colCounts[e.column] !== undefined) colCounts[e.column]++; });
+  allTasks.forEach(e => { if (colCounts[e.column] !== undefined) colCounts[e.column]++; });
 
   // Header stats
-  const total = allEpics.length;
-  const done  = allEpics.filter(e => e.column === "done").length;
+  const total = allTasks.length;
+  const done  = allTasks.filter(e => e.column === "done").length;
   document.getElementById("hstats").textContent = `${done}/${total} done`;
 
   // Col headers
@@ -567,59 +572,82 @@ function render() {
   // Swimlanes
   const sl = document.getElementById("swimlanes");
   sl.innerHTML = "";
-  groupEpics(allEpics).forEach(g => sl.appendChild(renderSwimlane(g)));
+  groupTasks(allTasks).forEach(g => sl.appendChild(renderSwimlane(g)));
 }
 
-function groupEpics(epics) {
+function groupTasks(tasks) {
   const map = new Map();
-  epics.forEach(e => {
-    const g = e.epic_group || "—";
-    if (!map.has(g)) map.set(g, []);
-    map.get(g).push(e);
+  tasks.forEach(t => {
+    const key = t.epic_id || "—";
+    if (!map.has(key)) map.set(key, []);
+    map.get(key).push(t);
   });
-  // Sort: known phases first, "—" last
   return [...map.entries()]
     .sort(([a], [b]) => a === "—" ? 1 : b === "—" ? -1 : a.localeCompare(b, "pl"))
-    .map(([name, epics]) => ({ name, epics }));
+    .map(([key, laneTasks]) => {
+      const entity = allEpicEntities.find(e => e.id === key);
+      const name = key === "—"
+        ? "—"
+        : (entity ? entity.title : (laneTasks[0] && laneTasks[0].epic_group) || key);
+      return {
+        key,
+        name,
+        epicId: key === "—" ? null : key,
+        status: entity ? entity.status : null,
+        description: entity ? entity.description : "",
+        goals: entity ? entity.goals : "",
+        tasks: laneTasks
+      };
+    });
 }
 
 // ── Swimlane ──────────────────────────────────────────────────────────────────
 
-function renderSwimlane({ name, epics }) {
-  const isCollapsed = collapsed.has(name);
+function renderSwimlane({ key, name, epicId, status, description, goals, tasks }) {
+  const isCollapsed = collapsed.has(key);
 
   const wrap = el("div", "swimlane");
 
   // Header
   const hdr = el("div", `sl-header${isCollapsed ? " collapsed" : ""}`);
-  const totalTasks = epics.reduce((s, e) => s + e.subtasks.length, 0);
-  const doneTasks  = epics.reduce((s, e) => s + e.subtasks.filter(t => t.done).length, 0);
+  const totalTasks = tasks.reduce((s, e) => s + (e.subtasks || []).length, 0);
+  const doneTasks  = tasks.reduce((s, e) => s + (e.subtasks || []).filter(t => t.done).length, 0);
   const pct = totalTasks > 0 ? Math.round(doneTasks / totalTasks * 100) : null;
+  const cardsDone = tasks.filter(t => t.column === "done").length;
+  const statusBadge = status ? `<span class="sl-cnt" title="derived status">${escHtml(status)}</span>` : "";
 
   hdr.innerHTML = `
     <span class="sl-arrow">▼</span>
-    <span class="sl-name">${escHtml(name === "—" ? "Uncategorized (no epic)" : name)}</span>
-    <span class="sl-cnt">${epics.length}</span>
-    ${pct !== null ? `<span class="sl-progress" style="margin-left:auto">${pct}% tasks done</span>` : ""}
+    <span class="sl-name">${escHtml(name === "—" ? "Uncategorized (no epic)" : name)}${epicId ? ` <small style="opacity:.6">${escHtml(epicId)}</small>` : ""}</span>
+    <span class="sl-cnt">${tasks.length} cards · ${cardsDone} done</span>
+    ${statusBadge}
+    ${pct !== null ? `<span class="sl-progress" style="margin-left:auto">${pct}% subtasks</span>` : ""}
   `;
   hdr.onclick = () => {
-    if (collapsed.has(name)) collapsed.delete(name);
-    else collapsed.add(name);
+    if (collapsed.has(key)) collapsed.delete(key);
+    else collapsed.add(key);
     render();
   };
   wrap.appendChild(hdr);
 
+  if (!isCollapsed && (description || goals)) {
+    const meta = el("div", "sl-body");
+    meta.style.cssText = "display:block;padding:6px 12px 0;font-size:12px;opacity:.85";
+    meta.innerHTML = `${goals ? `<div><strong>Goals:</strong> ${escHtml(goals)}</div>` : ""}${description ? `<div>${escHtml(description)}</div>` : ""}`;
+    wrap.appendChild(meta);
+  }
+
   // Body
   const body = el("div", `sl-body${isCollapsed ? " hidden" : ""}`);
   COL_DEFS.forEach(col => {
     const lane = el("div", `lane col-${col.id}`);
-    epics.filter(e => e.column === col.id).forEach(e => lane.appendChild(renderCard(e, col.id)));
+    tasks.filter(e => e.column === col.id).forEach(e => lane.appendChild(renderCard(e, col.id)));
     // Add button only in non-done columns
     if (col.id !== "done") {
       const addBtn = document.createElement("button");
       addBtn.className = "lane-add";
       addBtn.textContent = "+ Add here";
-      addBtn.onclick = e => { e.stopPropagation(); showLaneAdd(lane, col.id, name, addBtn); };
+      addBtn.onclick = e => { e.stopPropagation(); showLaneAdd(lane, col.id, epicId || name, addBtn); };
       lane.appendChild(addBtn);
     }
     body.appendChild(lane);
@@ -931,7 +959,7 @@ async function saveEdit(epicId) {
   if (!dirty) { editingId = null; render(); return; }
 
   const body = {};
-  const epic = allEpics.find(e => e.id === epicId);
+  const epic = allTasks.find(e => e.id === epicId);
   if (epic) {
     const origTitle = epic.title.replace(/^[\w.-]+:\s*/, "");
     if (dirty.title !== origTitle) body.title = dirty.title;
@@ -1007,13 +1035,15 @@ function showLaneAdd(lane, colId, groupName, addBtn) {
     if (!title) return;
     inp.disabled = true;
     description.disabled = true;
-    const res = await fetch("/api/epics", {
+    const epicRef = groupName === "—" ? "" : groupName;
+    const res = await fetch("/api/tasks", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
         title,
         column: colId,
-        epic_group: groupName === "—" ? "" : groupName,
+        epic: epicRef,
+        epic_id: epicRef && /^E\d+/i.test(epicRef) ? epicRef : undefined,
         description: description.value.trim()
       }),
     });
@@ -1058,10 +1088,10 @@ async function submitNew() {
   const group = document.getElementById("ne-group").value.trim();
   if (!title) { document.getElementById("ne-title").focus(); return; }
 
-  const res = await fetch("/api/epics", {
+  const res = await fetch("/api/tasks", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ title, column: col, epic_group: group || "—" }),
+    body: JSON.stringify({ title, column: col, epic: group || "—" }),
   });
   if (res.ok) {
     toast("Task added ✓");