@vibecoded/work 0.0.14 → 0.0.15

package/README.md

@@ -16,14 +16,14 @@ Minimal local time-tracking CLI (Bun + TypeScript) that stores everything on dis
 
 ## Install
 
-```typescript
+```bash
 bun add -g @vibecoded/work
 npm install -g @vibecoded/work
 ````
 
 ## Quick start
 
-```typescript
+```bash
 work init
 work on "Client X" "Kickoff call"
 work status
@@ -35,13 +35,35 @@ work undo
 work off
 ```
 
+## Library usage
+
+Import the Node API and call the same lower-level helpers used by the CLI.
+
+```typescript
+import { ensureWorkHome, getWorkHome, loadProjects } from '@vibecoded/work';
+
+const workHome = getWorkHome();
+await ensureWorkHome(workHome);
+
+const projects = await loadProjects(workHome);
+console.log(projects.projects);
+```
+
+You can also import the explicit library entry:
+
+```typescript
+import { fmtElapsed } from '@vibecoded/work/lib';
+
+console.log(fmtElapsed(90_000));
+```
+
 ## Data location
 
 Default: `~/.work`
 
 Override with:
 
-```typescript
+```bash
 work --dir ./my-work-data status
 ```
 
@@ -145,9 +167,9 @@ Each project is stored in `data/<projectId>/` with:
 
 ## Build
 
-Build the CLI binary:
+Build the CLI and library bundles:
 
-```typescript
+```bash
 bun run build
 ```
 

package/dist/cli.js

@@ -2221,8 +2221,345 @@ async function saveTaskIndex(workHome, projectId, idx) {
   await saveJson(getTaskIndexPath(workHome, projectId), idx);
 }
 
-// src/cli.ts
+// src/lib/services/format.ts
+function formatWorkLabel(projectName, task) {
+  return `${projectName}${task ? " • " + task : ""}`;
+}
+
+// src/lib/services/history.ts
 import { readdir } from "node:fs/promises";
+async function findLatestSession(projects, workHome) {
+  let latest = null;
+  for (const project of projects.projects) {
+    const projectDir = getProjectDir(workHome, project.id);
+    let entries = [];
+    try {
+      entries = await readdir(projectDir);
+    } catch {
+      continue;
+    }
+    const csvFiles = entries.filter((entry) => /^\d{4}-\d{2}\.csv$/.test(entry));
+    for (const file of csvFiles) {
+      const csvPath = pathJoin(projectDir, file);
+      const rows = await readCsvRows(csvPath);
+      for (let i = 0;i < rows.length; i++) {
+        const row = rows[i];
+        if (!row || row.deletedAt)
+          continue;
+        const timeMs = Date.parse(row.endAt) || Date.parse(row.startAt) || 0;
+        if (!latest || timeMs > latest.timeMs) {
+          latest = { project, csvPath, rowIndex: i, rows, timeMs };
+        }
+      }
+    }
+  }
+  return latest;
+}
+
+// src/lib/services/dates.ts
+function localYearMonth(d) {
+  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}`;
+}
+function localDateKey(d) {
+  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
+}
+function parsePartialDateTime(input) {
+  const trimmed = input.trim();
+  if (!trimmed)
+    return null;
+  const [datePart, timePartRaw] = trimmed.split(/[T ]/);
+  const dateMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(datePart);
+  if (!dateMatch)
+    return null;
+  const year = Number(dateMatch[1]);
+  const month = Number(dateMatch[2]);
+  const day = Number(dateMatch[3]);
+  if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day))
+    return null;
+  let hour = 0;
+  let minute = randomInt(0, 59);
+  let second = randomInt(0, 59);
+  let ms = randomInt(0, 999);
+  if (timePartRaw) {
+    const timeParts = timePartRaw.split(":");
+    if (timeParts[0])
+      hour = Number(timeParts[0]);
+    if (!Number.isFinite(hour))
+      return null;
+    if (timeParts[1] != null) {
+      minute = fillPartialNumber(timeParts[1], 0, 59);
+    }
+    if (timeParts[2] != null) {
+      const [secPart, msPart] = timeParts[2].split(".");
+      second = fillPartialNumber(secPart, 0, 59);
+      if (msPart != null) {
+        ms = fillPartialMs(msPart);
+      }
+    }
+    if (timeParts[1] == null) {
+      minute = randomInt(0, 59);
+      second = randomInt(0, 59);
+      ms = randomInt(0, 999);
+    } else if (timeParts[2] == null) {
+      second = randomInt(0, 59);
+      ms = randomInt(0, 999);
+    }
+  }
+  if (hour < 0 || hour > 23)
+    return null;
+  if (minute < 0 || minute > 59)
+    return null;
+  if (second < 0 || second > 59)
+    return null;
+  if (ms < 0 || ms > 999)
+    return null;
+  return new Date(year, month - 1, day, hour, minute, second, ms);
+}
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function fillPartialNumber(part, min, max) {
+  const trimmed = part.trim();
+  if (!trimmed)
+    return randomInt(min, max);
+  if (/^\d$/.test(trimmed)) {
+    const tens = Number(trimmed) * 10;
+    return clamp(tens + randomInt(0, 9), min, max);
+  }
+  const value = Number(trimmed);
+  if (!Number.isFinite(value))
+    return randomInt(min, max);
+  return clamp(value, min, max);
+}
+function fillPartialMs(part) {
+  const trimmed = part.trim();
+  if (!trimmed)
+    return randomInt(0, 999);
+  if (/^\d{1,3}$/.test(trimmed)) {
+    const value = Number(trimmed.padEnd(3, String(randomInt(0, 9))));
+    return clamp(value, 0, 999);
+  }
+  return randomInt(0, 999);
+}
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+
+// src/lib/services/info.ts
+function normalizeTaskLabel(task) {
+  return (task ?? "").trim() || "(no task)";
+}
+function fmtHours(ms) {
+  const totalMin = Math.round(ms / 60000);
+  const h = Math.floor(totalMin / 60);
+  const m = totalMin % 60;
+  if (h === 0)
+    return `${m}m`;
+  if (m === 0)
+    return `${h}h`;
+  return `${h}h ${String(m).padStart(2, "0")}m`;
+}
+function buildInfoSummary(rows) {
+  const active = rows.filter((r) => !r.deletedAt);
+  const byDayMs = new Map;
+  const byTaskMs = new Map;
+  let totalMs = 0;
+  for (const r of active) {
+    const start = Date.parse(r.startAt);
+    const end = Date.parse(r.endAt);
+    if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start)
+      continue;
+    const ms = end - start;
+    totalMs += ms;
+    const dayKey = localDateKey(new Date(start));
+    byDayMs.set(dayKey, (byDayMs.get(dayKey) ?? 0) + ms);
+    const taskKey = normalizeTaskLabel(r.task);
+    byTaskMs.set(taskKey, (byTaskMs.get(taskKey) ?? 0) + ms);
+  }
+  const dayRows = sortMapByKey(byDayMs).map(([k, ms]) => ({
+    key: k,
+    ms,
+    pretty: fmtHours(ms)
+  }));
+  const taskRows = sortMapByValueDesc(byTaskMs).map(([k, ms]) => ({
+    key: k,
+    ms,
+    pretty: fmtHours(ms)
+  }));
+  return { totalMs, dayRows, taskRows };
+}
+function buildInfoExportCsv(projectName, month, totalMs, dayRows, taskRows) {
+  const lines = [];
+  lines.push(`meta,project,${csvEsc(projectName)}`);
+  lines.push(`meta,month,${csvEsc(month)}`);
+  lines.push(`meta,total,${csvEsc(fmtHours(totalMs))}`);
+  lines.push("");
+  lines.push("type,key,durationMinutes,duration");
+  for (const r of dayRows) {
+    lines.push(`day,${csvEsc(r.key)},${Math.round(r.ms / 60000)},${csvEsc(r.pretty)}`);
+  }
+  for (const r of taskRows) {
+    lines.push(`task,${csvEsc(r.key)},${Math.round(r.ms / 60000)},${csvEsc(r.pretty)}`);
+  }
+  return lines.join(`
+`) + `
+`;
+}
+function sortMapByKey(m) {
+  return [...m.entries()].sort((a, b) => a[0].localeCompare(b[0]));
+}
+function sortMapByValueDesc(m) {
+  return [...m.entries()].sort((a, b) => b[1] - a[1]);
+}
+function csvEsc(v) {
+  if (/[,"\n\r]/.test(v))
+    return `"${v.replace(/"/g, '""')}"`;
+  return v;
+}
+
+// src/lib/services/ids.ts
+function createId() {
+  return globalThis.crypto?.randomUUID ? globalThis.crypto.randomUUID() : randomUuidFallback();
+}
+function randomUuidFallback() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+
+// src/lib/services/projects.ts
+function findProjectByNameOrId(projects, arg) {
+  const a = arg.trim().toLowerCase();
+  return projects.projects.find((p) => p.id.toLowerCase() === a) ?? projects.projects.find((p) => p.name.toLowerCase() === a) ?? null;
+}
+async function resolveProjectByNameOrCreate(workHome, projects, name) {
+  const n = name.trim();
+  const found = projects.projects.find((p) => p.name.toLowerCase() === n.toLowerCase());
+  if (found)
+    return found;
+  const created = {
+    id: createId(),
+    name: n,
+    createdAt: nowIso()
+  };
+  projects.projects.push(created);
+  await saveProjects(workHome, projects);
+  return created;
+}
+
+// src/lib/services/tasks.ts
+function sortTasksByUsage(a, b) {
+  const ca = a.count ?? 0;
+  const cb = b.count ?? 0;
+  if (cb !== ca)
+    return cb - ca;
+  const la = a.lastUsedAt ? Date.parse(a.lastUsedAt) : 0;
+  const lb = b.lastUsedAt ? Date.parse(b.lastUsedAt) : 0;
+  if (lb !== la)
+    return lb - la;
+  return a.name.localeCompare(b.name);
+}
+function sortTasksByRecentUse(a, b) {
+  const la = a.lastUsedAt ? Date.parse(a.lastUsedAt) : 0;
+  const lb = b.lastUsedAt ? Date.parse(b.lastUsedAt) : 0;
+  if (lb !== la)
+    return lb - la;
+  return a.name.localeCompare(b.name);
+}
+function updateTaskStats(idx, taskName) {
+  const trimmed = taskName.trim();
+  if (!trimmed)
+    return;
+  const entry = idx.tasks.find((t) => t.name.toLowerCase() === trimmed.toLowerCase());
+  if (entry) {
+    entry.count = (entry.count ?? 0) + 1;
+    entry.lastUsedAt = nowIso();
+    return;
+  }
+  idx.tasks.push({
+    name: trimmed,
+    count: 1,
+    lastUsedAt: nowIso(),
+    createdAt: nowIso()
+  });
+}
+async function resolveTaskByNameOrCreate(workHome, projectId, task) {
+  const idx = await loadTaskIndex(workHome, projectId);
+  const normalized = task.trim();
+  const found = idx.tasks.find((x) => x.name.toLowerCase() === normalized.toLowerCase());
+  if (found)
+    return found.name;
+  idx.tasks.push({ name: normalized, count: 0, lastUsedAt: null, createdAt: nowIso() });
+  await saveTaskIndex(workHome, projectId, idx);
+  return normalized;
+}
+
+// src/lib/services/sessions.ts
+function createSession(projectId, projectName, task) {
+  return {
+    id: createId(),
+    projectId,
+    projectName,
+    task,
+    startAt: nowIso(),
+    pausedAt: null,
+    pausedMs: 0,
+    note: ""
+  };
+}
+function sessionElapsedMs(session) {
+  const endAt = session.pausedAt ? Date.parse(session.pausedAt) : Date.now();
+  return endAt - Date.parse(session.startAt) - (session.pausedMs ?? 0);
+}
+async function stopAndPersist(workHome, s, endAtIso) {
+  const projectDir = getProjectDir(workHome, s.projectId);
+  await ensureDir(projectDir);
+  const idx = await loadTaskIndex(workHome, s.projectId);
+  updateTaskStats(idx, s.task);
+  await saveTaskIndex(workHome, s.projectId, idx);
+  const endAt = new Date(Date.parse(endAtIso));
+  const ym = localYearMonth(endAt);
+  const csvPath = getMonthCsvPath(workHome, s.projectId, ym);
+  await ensureCsvHeader(csvPath);
+  const row = {
+    id: s.id,
+    startAt: s.startAt,
+    endAt: endAtIso,
+    task: s.task,
+    note: s.note ?? "",
+    createdAt: s.startAt,
+    updatedAt: endAtIso,
+    deletedAt: ""
+  };
+  await appendCsvRow(csvPath, row);
+}
+async function addManualEntry(workHome, projectId, task, startAt, endAt, note) {
+  const idx = await loadTaskIndex(workHome, projectId);
+  updateTaskStats(idx, task);
+  await saveTaskIndex(workHome, projectId, idx);
+  const ym = localYearMonth(new Date(Date.parse(endAt)));
+  const csvPath = getMonthCsvPath(workHome, projectId, ym);
+  await ensureCsvHeader(csvPath);
+  const now = nowIso();
+  const row = {
+    id: createId(),
+    startAt,
+    endAt,
+    task,
+    note,
+    createdAt: now,
+    updatedAt: now,
+    deletedAt: ""
+  };
+  await appendCsvRow(csvPath, row);
+}
+
+// src/cli.ts
 function usage() {
   console.log(`
 work - minimal time tracking (monthly CSV per project)
@@ -2376,16 +2713,7 @@ async function cmdOn(workHome, rest, flags) {
     await stopAndPersist(workHome, cur, nowIso());
     running.session = null;
   }
-  const session = {
-    id: globalThis.crypto?.randomUUID ? globalThis.crypto.randomUUID() : randomUuidFallback(),
-    projectId: project.id,
-    projectName: project.name,
-    task,
-    startAt: nowIso(),
-    pausedAt: null,
-    pausedMs: 0,
-    note: ""
-  };
+  const session = createSession(project.id, project.name, task);
   await saveRunning(workHome, { session });
   console.log(`Working on ${formatWorkLabel(project.name, task)}`);
 }
@@ -2436,24 +2764,8 @@ async function cmdAdd(workHome, rest, flags) {
   const projects = await loadProjects(workHome);
   const project = await resolveProjectByNameOrCreate(workHome, projects, projectName);
   const task = await resolveTaskByNameOrCreate(workHome, project.id, taskName);
-  const idx = await loadTaskIndex(workHome, project.id);
-  updateTaskStats(idx, task);
-  await saveTaskIndex(workHome, project.id, idx);
-  const ym = localYearMonth(new Date(endMs));
-  const csvPath = getMonthCsvPath(workHome, project.id, ym);
-  await ensureCsvHeader(csvPath);
-  const now = nowIso();
-  const row = {
-    id: globalThis.crypto?.randomUUID ? globalThis.crypto.randomUUID() : randomUuidFallback(),
-    startAt,
-    endAt,
-    task,
-    note: typeof flags.note === "string" ? flags.note : "",
-    createdAt: now,
-    updatedAt: now,
-    deletedAt: ""
-  };
-  await appendCsvRow(csvPath, row);
+  const note = typeof flags.note === "string" ? flags.note : "";
+  await addManualEntry(workHome, project.id, task, startAt, endAt, note);
   console.log(`Added: ${formatWorkLabel(project.name, task)}`);
 }
 async function cmdPause(workHome) {
@@ -2533,34 +2845,9 @@ async function cmdInfo(workHome, rest, flags) {
     process.exit(1);
   }
   const projectDir = getProjectDir(workHome, project.id);
-  const csvPath = getMonthCsvPath(workHome, project.id, month);
-  const rows = await readCsvRows(csvPath);
-  const active = rows.filter((r) => !r.deletedAt);
-  const byDayMs = new Map;
-  const byTaskMs = new Map;
-  let totalMs = 0;
-  for (const r of active) {
-    const start = Date.parse(r.startAt);
-    const end = Date.parse(r.endAt);
-    if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start)
-      continue;
-    const ms = end - start;
-    totalMs += ms;
-    const dayKey = localDateKey(new Date(start));
-    byDayMs.set(dayKey, (byDayMs.get(dayKey) ?? 0) + ms);
-    const taskKey = normalizeTaskLabel(r.task);
-    byTaskMs.set(taskKey, (byTaskMs.get(taskKey) ?? 0) + ms);
-  }
-  const dayRows = sortMapByKey(byDayMs).map(([k, ms]) => ({
-    key: k,
-    ms,
-    pretty: fmtHours(ms)
-  }));
-  const taskRows = sortMapByValueDesc(byTaskMs).map(([k, ms]) => ({
-    key: k,
-    ms,
-    pretty: fmtHours(ms)
-  }));
+  const csvPath = getMonthCsvPath(workHome, project.id, month);
+  const rows = await readCsvRows(csvPath);
+  const { totalMs, dayRows, taskRows } = buildInfoSummary(rows);
   console.log(`
 Project: ${project.name}`);
   console.log(`Month:   ${month}`);
@@ -2580,10 +2867,6 @@ By task`);
 Exported: ${outPath}`);
   }
 }
-function findProjectByNameOrId(projects, arg) {
-  const a = arg.trim().toLowerCase();
-  return projects.projects.find((p) => p.id.toLowerCase() === a) ?? projects.projects.find((p) => p.name.toLowerCase() === a) ?? null;
-}
 async function pickProjectOnly(projects) {
   if (!projects.projects.length) {
     console.error("No projects found. Use: work on (create one)");
@@ -2598,20 +2881,6 @@ async function pickProjectOnly(projects) {
   });
   return projects.projects.find((p) => p.id === picked) ?? null;
 }
-async function resolveProjectByNameOrCreate(workHome, projects, name) {
-  const n = name.trim();
-  const found = projects.projects.find((p) => p.name.toLowerCase() === n.toLowerCase());
-  if (found)
-    return found;
-  const created = {
-    id: globalThis.crypto?.randomUUID ? globalThis.crypto.randomUUID() : randomUuidFallback(),
-    name: n,
-    createdAt: nowIso()
-  };
-  projects.projects.push(created);
-  await saveProjects(workHome, projects);
-  return created;
-}
 async function pickProjectOrCreate(workHome, projects) {
   const picked = await dist_default4({
     message: "Select a project",
@@ -2637,16 +2906,6 @@ async function pickProjectOrCreate(workHome, projects) {
     throw new Error("Project selection failed");
   return found;
 }
-async function resolveTaskByNameOrCreate(workHome, projectId, task) {
-  const idx = await loadTaskIndex(workHome, projectId);
-  const normalized = task.trim();
-  const found = idx.tasks.find((x) => x.name.toLowerCase() === normalized.toLowerCase());
-  if (found)
-    return found.name;
-  idx.tasks.push({ name: normalized, count: 0, lastUsedAt: null, createdAt: nowIso() });
-  await saveTaskIndex(workHome, projectId, idx);
-  return normalized;
-}
 async function pickTaskOrCreate(workHome, projectId, projectName) {
   const idx = await loadTaskIndex(workHome, projectId);
   const picked = await dist_default4({
@@ -2667,53 +2926,6 @@ async function pickTaskOrCreate(workHome, projectId, projectName) {
   }
   return picked;
 }
-async function stopAndPersist(workHome, s, endAtIso) {
-  const projectDir = getProjectDir(workHome, s.projectId);
-  await ensureDir(projectDir);
-  const idx = await loadTaskIndex(workHome, s.projectId);
-  updateTaskStats(idx, s.task);
-  await saveTaskIndex(workHome, s.projectId, idx);
-  const endAt = new Date(Date.parse(endAtIso));
-  const ym = localYearMonth(endAt);
-  const csvPath = getMonthCsvPath(workHome, s.projectId, ym);
-  await ensureCsvHeader(csvPath);
-  const row = {
-    id: s.id,
-    startAt: s.startAt,
-    endAt: endAtIso,
-    task: s.task,
-    note: s.note ?? "",
-    createdAt: s.startAt,
-    updatedAt: endAtIso,
-    deletedAt: ""
-  };
-  await appendCsvRow(csvPath, row);
-}
-function pad2(n) {
-  return String(n).padStart(2, "0");
-}
-function localYearMonth(d) {
-  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}`;
-}
-function localDateKey(d) {
-  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
-}
-function fmtHours(ms) {
-  const totalMin = Math.round(ms / 60000);
-  const h = Math.floor(totalMin / 60);
-  const m = totalMin % 60;
-  if (h === 0)
-    return `${m}m`;
-  if (m === 0)
-    return `${h}h`;
-  return `${h}h ${String(m).padStart(2, "0")}m`;
-}
-function sortMapByKey(m) {
-  return [...m.entries()].sort((a, b) => a[0].localeCompare(b[0]));
-}
-function sortMapByValueDesc(m) {
-  return [...m.entries()].sort((a, b) => b[1] - a[1]);
-}
 function printTable(headers, rows) {
   const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
   const line = (cols) => cols.map((c, i) => (c ?? "").padEnd(widths[i] || 0)).join("  ").trimEnd();
@@ -2722,38 +2934,6 @@ function printTable(headers, rows) {
   for (const r of rows)
     console.log(line(r));
 }
-function buildInfoExportCsv(projectName, month, totalMs, dayRows, taskRows) {
-  const lines = [];
-  lines.push(`meta,project,${csvEsc(projectName)}`);
-  lines.push(`meta,month,${csvEsc(month)}`);
-  lines.push(`meta,total,${csvEsc(fmtHours(totalMs))}`);
-  lines.push("");
-  lines.push("type,key,durationMinutes,duration");
-  for (const r of dayRows) {
-    lines.push(`day,${csvEsc(r.key)},${Math.round(r.ms / 60000)},${csvEsc(r.pretty)}`);
-  }
-  for (const r of taskRows) {
-    lines.push(`task,${csvEsc(r.key)},${Math.round(r.ms / 60000)},${csvEsc(r.pretty)}`);
-  }
-  return lines.join(`
-`) + `
-`;
-}
-function csvEsc(v) {
-  if (/[,"\n\r]/.test(v))
-    return `"${v.replace(/"/g, '""')}"`;
-  return v;
-}
-function formatWorkLabel(projectName, task) {
-  return `${projectName}${task ? " • " + task : ""}`;
-}
-function normalizeTaskLabel(task) {
-  return (task ?? "").trim() || "(no task)";
-}
-function sessionElapsedMs(session) {
-  const endAt = session.pausedAt ? Date.parse(session.pausedAt) : Date.now();
-  return endAt - Date.parse(session.startAt) - (session.pausedMs ?? 0);
-}
 function parseInfoArgs(args) {
   const a1 = args[0]?.trim();
   const a2 = args[1]?.trim();
@@ -2783,149 +2963,6 @@ function parseDateArg(value, label) {
   }
   return parsed.toISOString();
 }
-function parsePartialDateTime(input) {
-  const trimmed = input.trim();
-  if (!trimmed)
-    return null;
-  const [datePart, timePartRaw] = trimmed.split(/[T ]/);
-  const dateMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(datePart);
-  if (!dateMatch)
-    return null;
-  const year = Number(dateMatch[1]);
-  const month = Number(dateMatch[2]);
-  const day = Number(dateMatch[3]);
-  if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day))
-    return null;
-  let hour = 0;
-  let minute = randomInt(0, 59);
-  let second = randomInt(0, 59);
-  let ms = randomInt(0, 999);
-  if (timePartRaw) {
-    const timeParts = timePartRaw.split(":");
-    if (timeParts[0])
-      hour = Number(timeParts[0]);
-    if (!Number.isFinite(hour))
-      return null;
-    if (timeParts[1] != null) {
-      minute = fillPartialNumber(timeParts[1], 0, 59);
-    }
-    if (timeParts[2] != null) {
-      const [secPart, msPart] = timeParts[2].split(".");
-      second = fillPartialNumber(secPart, 0, 59);
-      if (msPart != null) {
-        ms = fillPartialMs(msPart);
-      }
-    }
-    if (timeParts[1] == null) {
-      minute = randomInt(0, 59);
-      second = randomInt(0, 59);
-      ms = randomInt(0, 999);
-    } else if (timeParts[2] == null) {
-      second = randomInt(0, 59);
-      ms = randomInt(0, 999);
-    }
-  }
-  if (hour < 0 || hour > 23)
-    return null;
-  if (minute < 0 || minute > 59)
-    return null;
-  if (second < 0 || second > 59)
-    return null;
-  if (ms < 0 || ms > 999)
-    return null;
-  return new Date(year, month - 1, day, hour, minute, second, ms);
-}
-function fillPartialNumber(part, min, max) {
-  const trimmed = part.trim();
-  if (!trimmed)
-    return randomInt(min, max);
-  if (/^\d$/.test(trimmed)) {
-    const tens = Number(trimmed) * 10;
-    return clamp(tens + randomInt(0, 9), min, max);
-  }
-  const value = Number(trimmed);
-  if (!Number.isFinite(value))
-    return randomInt(min, max);
-  return clamp(value, min, max);
-}
-function fillPartialMs(part) {
-  const trimmed = part.trim();
-  if (!trimmed)
-    return randomInt(0, 999);
-  if (/^\d{1,3}$/.test(trimmed)) {
-    const value = Number(trimmed.padEnd(3, String(randomInt(0, 9))));
-    return clamp(value, 0, 999);
-  }
-  return randomInt(0, 999);
-}
-function randomInt(min, max) {
-  return Math.floor(Math.random() * (max - min + 1)) + min;
-}
-function clamp(value, min, max) {
-  return Math.min(max, Math.max(min, value));
-}
-function sortTasksByUsage(a, b) {
-  const ca = a.count ?? 0;
-  const cb = b.count ?? 0;
-  if (cb !== ca)
-    return cb - ca;
-  const la = a.lastUsedAt ? Date.parse(a.lastUsedAt) : 0;
-  const lb = b.lastUsedAt ? Date.parse(b.lastUsedAt) : 0;
-  if (lb !== la)
-    return lb - la;
-  return a.name.localeCompare(b.name);
-}
-function sortTasksByRecentUse(a, b) {
-  const la = a.lastUsedAt ? Date.parse(a.lastUsedAt) : 0;
-  const lb = b.lastUsedAt ? Date.parse(b.lastUsedAt) : 0;
-  if (lb !== la)
-    return lb - la;
-  return a.name.localeCompare(b.name);
-}
-function updateTaskStats(idx, taskName) {
-  const trimmed = taskName.trim();
-  if (!trimmed)
-    return;
-  const entry = idx.tasks.find((t) => t.name.toLowerCase() === trimmed.toLowerCase());
-  if (entry) {
-    entry.count = (entry.count ?? 0) + 1;
-    entry.lastUsedAt = nowIso();
-    return;
-  }
-  idx.tasks.push({
-    name: trimmed,
-    count: 1,
-    lastUsedAt: nowIso(),
-    createdAt: nowIso()
-  });
-}
-async function findLatestSession(projects, workHome) {
-  let latest = null;
-  for (const project of projects.projects) {
-    const projectDir = getProjectDir(workHome, project.id);
-    let entries = [];
-    try {
-      entries = await readdir(projectDir);
-    } catch {
-      continue;
-    }
-    const csvFiles = entries.filter((entry) => /^\d{4}-\d{2}\.csv$/.test(entry));
-    for (const file of csvFiles) {
-      const csvPath = pathJoin(projectDir, file);
-      const rows = await readCsvRows(csvPath);
-      for (let i = 0;i < rows.length; i++) {
-        const row = rows[i];
-        if (!row || row.deletedAt)
-          continue;
-        const timeMs = Date.parse(row.endAt) || Date.parse(row.startAt) || 0;
-        if (!latest || timeMs > latest.timeMs) {
-          latest = { project, csvPath, rowIndex: i, rows, timeMs };
-        }
-      }
-    }
-  }
-  return latest;
-}
 process.on("uncaughtException", (error) => {
   if (error && typeof error === "object" && error.name === "ExitPromptError") {
     console.log("\uD83D\uDC4B until next time!");
@@ -2933,10 +2970,4 @@ process.on("uncaughtException", (error) => {
     throw error;
   }
 });
-function randomUuidFallback() {
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
-    const r = Math.random() * 16 | 0, v = c === "x" ? r : r & 3 | 8;
-    return v.toString(16);
-  });
-}
 await main();

package/dist/lib.js

@@ -0,0 +1,277 @@
+// src/lib/csv.ts
+import { appendFile, readFile, writeFile, access } from "node:fs/promises";
+import { constants as FS } from "node:fs";
+var HEADER = `id,startAt,endAt,task,note,createdAt,updatedAt,deletedAt
+`;
+function esc(v) {
+  const s = (v ?? "").toString();
+  if (/[,"\n\r]/.test(s))
+    return `"${s.replace(/"/g, '""')}"`;
+  return s;
+}
+async function exists(path) {
+  try {
+    await access(path, FS.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function ensureCsvHeader(path) {
+  if (!await exists(path)) {
+    await writeFile(path, HEADER, "utf-8");
+  }
+}
+async function appendCsvRow(path, row) {
+  const line = serializeCsvRows([row], false);
+  await appendFile(path, line, "utf-8");
+}
+function unquoteCsvCell(s) {
+  if (s.startsWith('"') && s.endsWith('"')) {
+    return s.slice(1, -1).replace(/""/g, '"');
+  }
+  return s;
+}
+function splitCsvLine(line) {
+  const out = [];
+  let cur = "";
+  let inQ = false;
+  for (let i = 0;i < line.length; i++) {
+    const ch = line[i];
+    if (ch === '"') {
+      const next = line[i + 1];
+      if (inQ && next === '"') {
+        cur += '"';
+        i++;
+      } else {
+        inQ = !inQ;
+      }
+      continue;
+    }
+    if (ch === "," && !inQ) {
+      out.push(cur);
+      cur = "";
+      continue;
+    }
+    cur += ch;
+  }
+  out.push(cur);
+  return out.map(unquoteCsvCell);
+}
+async function readCsvRows(path) {
+  if (!await exists(path))
+    return [];
+  const txt = await readFile(path, "utf-8");
+  const lines = txt.split(/\r?\n/).filter((l) => l.trim().length > 0);
+  if (lines.length <= 1)
+    return [];
+  const header = lines[0]?.trim();
+  if (header !== HEADER.trim()) {
+    throw new Error(`Unexpected CSV header in ${path}`);
+  }
+  const rows = [];
+  for (let i = 1;i < lines.length; i++) {
+    const cols = splitCsvLine(lines[i] || "");
+    if (cols.length < 8)
+      continue;
+    rows.push({
+      id: cols[0] ?? "",
+      startAt: cols[1] ?? "",
+      endAt: cols[2] ?? "",
+      task: cols[3] ?? "",
+      note: cols[4] ?? "",
+      createdAt: cols[5] ?? "",
+      updatedAt: cols[6] ?? "",
+      deletedAt: cols[7] ?? ""
+    });
+  }
+  return rows;
+}
+function serializeCsvRows(rows, includeHeader = true) {
+  const lines = [];
+  if (includeHeader)
+    lines.push(HEADER.trimEnd());
+  for (const row of rows) {
+    lines.push([
+      row.id,
+      row.startAt,
+      row.endAt,
+      row.task,
+      row.note,
+      row.createdAt,
+      row.updatedAt,
+      row.deletedAt
+    ].map(esc).join(","));
+  }
+  return lines.join(`
+`) + `
+`;
+}
+async function writeCsvRows(path, rows) {
+  await writeFile(path, serializeCsvRows(rows, true), "utf-8");
+}
+// src/lib/fs.ts
+import { mkdir } from "node:fs/promises";
+import { readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { homedir } from "node:os";
+function pathJoin(...parts) {
+  const cleaned = parts.filter(Boolean).map((p, i) => {
+    let s = String(p).trim();
+    if (i === 0)
+      s = s.replace(/\/+$/g, "");
+    else
+      s = s.replace(/^\/+/g, "").replace(/\/+$/g, "");
+    return s;
+  }).filter((p) => p.length > 0);
+  if (cleaned.length === 0)
+    return "";
+  const joined = cleaned.join("/");
+  const first = parts.find((p) => String(p ?? "").trim().length > 0) ?? "";
+  const isAbs = String(first).trim().startsWith("/");
+  return isAbs ? joined.startsWith("/") ? joined : `/${joined}` : joined;
+}
+function expandHome(p) {
+  const home = process.env.HOME || process.env.USERPROFILE || homedir() || "";
+  if (!home)
+    return p;
+  if (p === "~")
+    return home;
+  if (p.startsWith("~/"))
+    return `${home}/${p.slice(2)}`;
+  return p;
+}
+function getWorkHome(dirFlag) {
+  if (typeof dirFlag === "string" && dirFlag.trim())
+    return expandHome(dirFlag.trim());
+  const home = process.env.HOME || process.env.USERPROFILE || homedir() || ".";
+  return pathJoin(home, ".work");
+}
+async function ensureDir(dir) {
+  await mkdir(dir, { recursive: true });
+}
+async function ensureWorkHome(workHome) {
+  await ensureDir(workHome);
+  await ensureDir(pathJoin(workHome, "data"));
+}
+async function loadJson(path, fallback) {
+  try {
+    const txt = await readFile2(path, "utf8");
+    return JSON.parse(txt);
+  } catch {
+    return fallback;
+  }
+}
+async function saveJson(path, data) {
+  const txt = JSON.stringify(data, null, 2) + `
+`;
+  await writeFile2(path, txt, "utf8");
+}
+async function writeTextFile(path, content) {
+  await writeFile2(path, content, "utf8");
+}
+function nowIso() {
+  return new Date().toISOString();
+}
+function slugify(s) {
+  return s.trim().toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "project";
+}
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0;i < argv.length; i++) {
+    const a = String(argv[i] ?? "");
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (!next || String(next).startsWith("-")) {
+        flags[key] = true;
+      } else {
+        flags[key] = String(next);
+        i++;
+      }
+    } else {
+      positional.push(a);
+    }
+  }
+  const cmd = positional[0];
+  const rest = positional.slice(1);
+  return { cmd, rest, flags };
+}
+// src/lib/store.ts
+var PROJECTS_FILE = "projects.json";
+var RUNNING_FILE = "running.json";
+var TASKS_FILE = "tasks.json";
+function getProjectsPath(workHome) {
+  return pathJoin(workHome, PROJECTS_FILE);
+}
+function getRunningPath(workHome) {
+  return pathJoin(workHome, RUNNING_FILE);
+}
+function getProjectDir(workHome, projectId) {
+  return pathJoin(workHome, "data", projectId);
+}
+function getTaskIndexPath(workHome, projectId) {
+  return pathJoin(getProjectDir(workHome, projectId), TASKS_FILE);
+}
+function getMonthCsvPath(workHome, projectId, yearMonth) {
+  return pathJoin(getProjectDir(workHome, projectId), `${yearMonth}.csv`);
+}
+async function loadProjects(workHome) {
+  return loadJson(getProjectsPath(workHome), { projects: [] });
+}
+async function saveProjects(workHome, projects) {
+  await saveJson(getProjectsPath(workHome), projects);
+}
+async function loadRunning(workHome) {
+  return loadJson(getRunningPath(workHome), { session: null });
+}
+async function saveRunning(workHome, running) {
+  await saveJson(getRunningPath(workHome), running);
+}
+async function loadTaskIndex(workHome, projectId) {
+  await ensureDir(getProjectDir(workHome, projectId));
+  return loadJson(getTaskIndexPath(workHome, projectId), { tasks: [] });
+}
+async function saveTaskIndex(workHome, projectId, idx) {
+  await ensureDir(getProjectDir(workHome, projectId));
+  await saveJson(getTaskIndexPath(workHome, projectId), idx);
+}
+// src/lib/time.ts
+function fmtElapsed(ms) {
+  const total = Math.max(0, Math.floor(ms / 1000));
+  const h = Math.floor(total / 3600);
+  const m = Math.floor(total % 3600 / 60);
+  const s = total % 60;
+  return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+export {
+  writeTextFile,
+  writeCsvRows,
+  slugify,
+  serializeCsvRows,
+  saveTaskIndex,
+  saveRunning,
+  saveProjects,
+  saveJson,
+  readCsvRows,
+  pathJoin,
+  parseArgs,
+  nowIso,
+  loadTaskIndex,
+  loadRunning,
+  loadProjects,
+  loadJson,
+  getWorkHome,
+  getTaskIndexPath,
+  getRunningPath,
+  getProjectsPath,
+  getProjectDir,
+  getMonthCsvPath,
+  fmtElapsed,
+  expandHome,
+  ensureWorkHome,
+  ensureDir,
+  ensureCsvHeader,
+  appendCsvRow,
+  HEADER as CSV_HEADER
+};

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@vibecoded/work",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "Work: CLI Time Tracker",
-  "module": "dist/cli.js",
+  "main": "dist/lib.js",
+  "module": "dist/lib.js",
   "scripts": {
-    "build": "bun build ./src/cli.ts --outdir=dist --target=node",
+    "build": "bun build ./src/cli.ts --outfile=dist/cli.js --target=node && bun build ./src/lib/index.ts --outfile=dist/lib.js --target=node",
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
@@ -21,6 +22,11 @@
   "bin": {
     "work": "dist/cli.js"
   },
+  "exports": {
+    ".": "./dist/lib.js",
+    "./cli": "./dist/cli.js",
+    "./lib": "./dist/lib.js"
+  },
   "files": [
     "dist",
     "README.md"