pi-kanban 0.2.0 → 0.3.1

package/lib/task-store.js

@@ -1,136 +1,152 @@
-const fs = require('node:fs');
-const path = require('node:path');
-const os = require('node:os');
-
-const PI_DIR = process.env.PI_DIR || path.join(os.homedir(), '.pi');
-const TASKS_DIR = path.join(PI_DIR, 'agent', 'kanban', 'tasks');
-
-function getTasksDir() {
-  return TASKS_DIR;
-}
-
-function sessionDir(sessionId) {
-  return path.join(TASKS_DIR, sessionId);
-}
-
-function taskPath(sessionId, taskId) {
-  return path.join(sessionDir(sessionId), `${taskId}.json`);
-}
-
-function readTask(sessionId, taskId) {
-  try {
-    const raw = fs.readFileSync(taskPath(sessionId, taskId), 'utf8');
-    return JSON.parse(raw);
-  } catch { return null; }
-}
-
-function listSessionIds() {
-  try { return fs.readdirSync(TASKS_DIR); }
-  catch { return []; }
-}
-
-function listTasks(sessionId) {
-  const dir = sessionDir(sessionId);
-  let entries;
-  try { entries = fs.readdirSync(dir); }
-  catch { return []; }
-  const out = [];
-  for (const name of entries) {
-    if (!name.endsWith('.json')) continue;
-    try {
-      const raw = fs.readFileSync(path.join(dir, name), 'utf8');
-      out.push(JSON.parse(raw));
-    } catch {}
-  }
-  return out;
-}
-
-function writeTask(sessionId, task) {
-  const dir = sessionDir(sessionId);
-  fs.mkdirSync(dir, { recursive: true });
-  const final = path.join(dir, `${task.id}.json`);
-  const tmp = `${final}.tmp`;
-  fs.writeFileSync(tmp, JSON.stringify(task, null, 2));
-  fs.renameSync(tmp, final);
-}
-
-function deleteTask(sessionId, taskId) {
-  try { fs.unlinkSync(taskPath(sessionId, taskId)); return true; }
-  catch (e) {
-    if (e.code === 'ENOENT') return false;
-    throw e;
-  }
-}
-
-function normalizeTask(snapTask, existing) {
-  const e = existing || {};
-  return {
-    id: String(snapTask.id),
-    subject: snapTask.subject ?? snapTask.text ?? '',
-    description: snapTask.description ?? null,
-    activeForm: snapTask.activeForm ?? e.activeForm ?? null,
-    status: snapTask.status ?? 'pending',
-    blocks: Array.isArray(e.blocks) ? e.blocks : [],
-    blockedBy: Array.isArray(e.blockedBy) ? e.blockedBy : [],
-  };
-}
-
-function tasksEqual(a, b) {
-  return a.subject === b.subject
-    && a.description === b.description
-    && a.activeForm === b.activeForm
-    && a.status === b.status;
-}
-
-function cleanupIfAllCompleted(sessionId) {
-  if (!sessionId) return false;
-  const tasks = listTasks(sessionId);
-  if (!tasks.length) return false;
-  const live = tasks.filter((t) => t.status !== 'deleted');
-  if (!live.length) return false;
-  if (!live.every((t) => t.status === 'completed')) return false;
-  const dir = sessionDir(sessionId);
-  for (const t of tasks) {
-    try { fs.unlinkSync(path.join(dir, `${t.id}.json`)); } catch {}
-  }
-  try { fs.rmdirSync(dir); } catch {}
-  return true;
-}
-
-function reconcileFromSnapshot(sessionId, snapshot) {
-  if (!sessionId || !Array.isArray(snapshot)) return;
-  const dir = sessionDir(sessionId);
-  fs.mkdirSync(dir, { recursive: true });
-
-  const seen = new Set();
-  for (const t of snapshot) {
-    if (t == null || t.id === undefined || t.id === null) continue;
-    const id = String(t.id);
-    seen.add(id);
-    const existing = readTask(sessionId, id);
-    const merged = normalizeTask(t, existing);
-    if (existing && tasksEqual(existing, merged)) continue;
-    writeTask(sessionId, merged);
-  }
-
-  let entries;
-  try { entries = fs.readdirSync(dir); } catch { return; }
-  for (const name of entries) {
-    if (!name.endsWith('.json')) continue;
-    const id = name.slice(0, -5);
-    if (seen.has(id)) continue;
-    try { fs.unlinkSync(path.join(dir, name)); } catch {}
-  }
-}
-
-module.exports = {
-  getTasksDir,
-  sessionDir,
-  listSessionIds,
-  listTasks,
-  readTask,
-  writeTask,
-  deleteTask,
-  reconcileFromSnapshot,
-  cleanupIfAllCompleted,
-};
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const PI_DIR = process.env.PI_DIR || path.join(os.homedir(), '.pi');
+const TASKS_DIR = path.join(PI_DIR, 'agent', 'kanban', 'tasks');
+
+function getTasksDir() {
+  return TASKS_DIR;
+}
+
+function sessionDir(sessionId) {
+  return path.join(TASKS_DIR, sessionId);
+}
+
+function taskPath(sessionId, taskId) {
+  return path.join(sessionDir(sessionId), `${taskId}.json`);
+}
+
+function readTask(sessionId, taskId) {
+  try {
+    const raw = fs.readFileSync(taskPath(sessionId, taskId), 'utf8');
+    return JSON.parse(raw);
+  } catch { return null; }
+}
+
+async function listSessionIdsAsync() {
+  try { return await fs.promises.readdir(TASKS_DIR); }
+  catch { return []; }
+}
+
+function listTasks(sessionId) {
+  const dir = sessionDir(sessionId);
+  let entries;
+  try { entries = fs.readdirSync(dir); }
+  catch { return []; }
+  const out = [];
+  for (const name of entries) {
+    if (!name.endsWith('.json')) continue;
+    try {
+      const raw = fs.readFileSync(path.join(dir, name), 'utf8');
+      out.push(JSON.parse(raw));
+    } catch {}
+  }
+  return out;
+}
+
+async function listTasksAsync(sessionId) {
+  const dir = sessionDir(sessionId);
+  let entries;
+  try { entries = await fs.promises.readdir(dir); }
+  catch { return []; }
+  const jsons = entries.filter((n) => n.endsWith('.json'));
+  const tasks = await Promise.all(jsons.map(async (name) => {
+    try {
+      const raw = await fs.promises.readFile(path.join(dir, name), 'utf8');
+      return JSON.parse(raw);
+    } catch { return null; }
+  }));
+  return tasks.filter(Boolean);
+}
+
+function writeTask(sessionId, task) {
+  const dir = sessionDir(sessionId);
+  fs.mkdirSync(dir, { recursive: true });
+  const final = path.join(dir, `${task.id}.json`);
+  const tmp = `${final}.tmp`;
+  fs.writeFileSync(tmp, JSON.stringify(task, null, 2));
+  fs.renameSync(tmp, final);
+}
+
+function deleteTask(sessionId, taskId) {
+  try { fs.unlinkSync(taskPath(sessionId, taskId)); return true; }
+  catch (e) {
+    if (e.code === 'ENOENT') return false;
+    throw e;
+  }
+}
+
+function normalizeTask(snapTask, existing) {
+  const e = existing || {};
+  return {
+    id: String(snapTask.id),
+    subject: snapTask.subject ?? snapTask.text ?? '',
+    description: snapTask.description ?? null,
+    activeForm: snapTask.activeForm ?? e.activeForm ?? null,
+    status: snapTask.status ?? 'pending',
+    blocks: Array.isArray(e.blocks) ? e.blocks : [],
+    blockedBy: Array.isArray(e.blockedBy) ? e.blockedBy : [],
+  };
+}
+
+function tasksEqual(a, b) {
+  return a.subject === b.subject
+    && a.description === b.description
+    && a.activeForm === b.activeForm
+    && a.status === b.status;
+}
+
+function cleanupIfAllCompleted(sessionId) {
+  if (!sessionId) return false;
+  const tasks = listTasks(sessionId);
+  if (!tasks.length) return false;
+  const live = tasks.filter((t) => t.status !== 'deleted');
+  if (!live.length) return false;
+  if (!live.every((t) => t.status === 'completed')) return false;
+  const dir = sessionDir(sessionId);
+  for (const t of tasks) {
+    try { fs.unlinkSync(path.join(dir, `${t.id}.json`)); } catch {}
+  }
+  try { fs.rmdirSync(dir); } catch {}
+  return true;
+}
+
+function reconcileFromSnapshot(sessionId, snapshot) {
+  if (!sessionId || !Array.isArray(snapshot)) return;
+  const dir = sessionDir(sessionId);
+  fs.mkdirSync(dir, { recursive: true });
+
+  const seen = new Set();
+  for (const t of snapshot) {
+    if (t == null || t.id === undefined || t.id === null) continue;
+    const id = String(t.id);
+    seen.add(id);
+    const existing = readTask(sessionId, id);
+    const merged = normalizeTask(t, existing);
+    if (existing && tasksEqual(existing, merged)) continue;
+    writeTask(sessionId, merged);
+  }
+
+  let entries;
+  try { entries = fs.readdirSync(dir); } catch { return; }
+  for (const name of entries) {
+    if (!name.endsWith('.json')) continue;
+    const id = name.slice(0, -5);
+    if (seen.has(id)) continue;
+    try { fs.unlinkSync(path.join(dir, name)); } catch {}
+  }
+}
+
+module.exports = {
+  getTasksDir,
+  sessionDir,
+  listSessionIdsAsync,
+  listTasks,
+  listTasksAsync,
+  readTask,
+  writeTask,
+  deleteTask,
+  reconcileFromSnapshot,
+  cleanupIfAllCompleted,
+};

package/package.json

@@ -1,59 +1,66 @@
-{
-  "name": "pi-kanban",
-  "version": "0.2.0",
-  "description": "Workspace for the pi coding agent — sessions, todos, subagents, and more.",
-  "main": "server.js",
-  "bin": {
-    "pi-kanban": "./server.js"
-  },
-  "scripts": {
-    "start": "node server.js",
-    "dev": "node --watch server.js",
-    "build:demo": "node scripts/build-demo.js",
-    "preview:demo": "npm run build:demo && npx --yes http-server dist -p 8765 -c-1"
-  },
-  "keywords": [
-    "pi-package",
-    "kanban",
-    "dashboard",
-    "observability",
-    "sessions",
-    "subagents"
-  ],
-  "files": [
-    "server.js",
-    "lib/",
-    "public/",
-    "extensions/",
-    "themes/",
-    "README.md"
-  ],
-  "license": "MIT",
-  "author": "nikiforovall",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/NikiforovAll/pi-kanban.git"
-  },
-  "bugs": {
-    "url": "https://github.com/NikiforovAll/pi-kanban/issues"
-  },
-  "homepage": "https://github.com/NikiforovAll/pi-kanban#readme",
-  "dependencies": {
-    "chokidar": "^3.5.3",
-    "express": "^4.18.2",
-    "open": "^11.0.0"
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*"
-  },
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ],
-    "video": "https://raw.githubusercontent.com/NikiforovAll/pi-kanban/main/assets/pi-kanban-demo.mp4",
-    "image": "https://raw.githubusercontent.com/NikiforovAll/pi-kanban/main/assets/pi-kanban-poster.png"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}
+{
+  "name": "pi-kanban",
+  "version": "0.3.1",
+  "description": "Workspace for the pi coding agent — sessions, todos, subagents, and more.",
+  "main": "server.js",
+  "bin": {
+    "pi-kanban": "./server.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node --watch server.js",
+    "build:demo": "node scripts/build-demo.js",
+    "preview:demo": "npm run build:demo && npx --yes http-server dist -p 8765 -c-1",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "release:local": "npm version \"$(git describe --tags --exact-match)\" --no-git-tag-version --allow-same-version && npm publish --access public && git checkout -- package.json package-lock.json"
+  },
+  "devDependencies": {
+    "vitepress": "^1.6.4"
+  },
+  "keywords": [
+    "pi-package",
+    "kanban",
+    "dashboard",
+    "observability",
+    "sessions",
+    "subagents"
+  ],
+  "files": [
+    "server.js",
+    "lib/",
+    "public/",
+    "extensions/",
+    "themes/",
+    "README.md"
+  ],
+  "license": "MIT",
+  "author": "nikiforovall",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NikiforovAll/pi-kanban.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NikiforovAll/pi-kanban/issues"
+  },
+  "homepage": "https://github.com/NikiforovAll/pi-kanban#readme",
+  "dependencies": {
+    "chokidar": "^3.5.3",
+    "express": "^4.18.2",
+    "open": "^11.0.0"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ],
+    "video": "https://raw.githubusercontent.com/NikiforovAll/pi-kanban/main/assets/pi-kanban-demo.mp4",
+    "image": "https://raw.githubusercontent.com/NikiforovAll/pi-kanban/main/assets/pi-kanban-poster.png"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}