@vibecoded/work 0.0.8 → 0.0.10

package/README.md

@@ -1,9 +1,16 @@
 # @vibecoded/work
 
-Minimal local time-tracking CLI (Bun + TypeScript).
-Stores data per project in `data/<projectId>/` with:
-- `tasks.json`
-- one CSV per month: `YYYY-MM.csv`
+[![npm version](https://img.shields.io/npm/v/@vibecoded/work)](https://www.npmjs.com/package/@vibecoded/work)
+[![npm downloads](https://img.shields.io/npm/dm/@vibecoded/work)](https://www.npmjs.com/package/@vibecoded/work)
+
+Minimal local time-tracking CLI (Bun + TypeScript) that stores everything on disk.
+
+## Features
+
+- One command to start/stop tracking.
+- Task picking with fuzzy search.
+- Monthly CSV storage for easy exports.
+- No servers, no accounts, no lock-in.
 
 ## Install
 
@@ -12,6 +19,15 @@ bun add -g @vibecoded/work
 npm install -g @vibecoded/work
 ````
 
+## Quick start
+
+```typescript
+work init
+work on "Client X" "Kickoff call"
+work status
+work off
+```
+
 ## Data location
 
 Default: `~/.work`
@@ -87,6 +103,26 @@ work info 2026-01
 work info Project 2026-01 --export
 ```
 
+## Data layout
+
+Each project is stored in `data/<projectId>/` with:
+
+- `tasks.json` (task index)
+- one CSV per month: `YYYY-MM.csv`
+
+## Build
+
+Build the CLI binary:
+
+```typescript
+bun run build
+```
+
+## Versioning & releases
+
+The published version is tracked in `package.json` and surfaced via the npm badge above.
+Release builds are produced with `bun run build` before publishing.
+
 ## Notes
 
 - Uses **local timezone** for day/month grouping.

package/dist/cli.js

@@ -2168,6 +2168,46 @@ function fmtElapsed(ms) {
   return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
 }
 
+// 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/cli.ts
 function usage() {
   console.log(`
@@ -2225,18 +2265,15 @@ async function main() {
 }
 async function cmdInit(workHome) {
   await ensureWorkHome(workHome);
-  const projectsPath = pathJoin(workHome, "projects.json");
-  const runningPath = pathJoin(workHome, "running.json");
-  const projects = await loadJson(projectsPath, { projects: [] });
-  const running = await loadJson(runningPath, { session: null });
-  await saveJson(projectsPath, projects);
-  await saveJson(runningPath, running);
+  const projects = await loadProjects(workHome);
+  const running = await loadRunning(workHome);
+  await saveProjects(workHome, projects);
+  await saveRunning(workHome, running);
   console.log(`Initialized: ${workHome}`);
 }
 async function cmdProjects(workHome) {
   await ensureWorkHome(workHome);
-  const projectsPath = pathJoin(workHome, "projects.json");
-  const projects = await loadJson(projectsPath, { projects: [] });
+  const projects = await loadProjects(workHome);
   if (!projects.projects.length) {
     console.log("No projects yet. Use: work on (create one)");
     return;
@@ -2250,8 +2287,7 @@ async function cmdProjects(workHome) {
 }
 async function cmdTasks(workHome, rest) {
   await ensureWorkHome(workHome);
-  const projectsPath = pathJoin(workHome, "projects.json");
-  const projects = await loadJson(projectsPath, { projects: [] });
+  const projects = await loadProjects(workHome);
   const arg = rest[0]?.trim();
   const project = arg ? findProjectByNameOrId(projects, arg) : await pickProjectOnly(projects);
   if (!project) {
@@ -2263,17 +2299,7 @@ async function cmdTasks(workHome, rest) {
     console.log(`No tasks for project "${project.name}" yet.`);
     return;
   }
-  const tasks = [...idx.tasks].sort((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);
-  });
+  const tasks = [...idx.tasks].sort(sortTasksByUsage);
   console.log(`Tasks for ${project.name}`);
   console.log("-".repeat(`Tasks for ${project.name}`.length));
   const rows = tasks.map((t) => [t.name, String(t.count ?? 0), t.lastUsedAt ?? ""]);
@@ -2281,30 +2307,28 @@ async function cmdTasks(workHome, rest) {
 }
 async function cmdOn(workHome, rest, flags) {
   await ensureWorkHome(workHome);
-  const projectsPath = pathJoin(workHome, "projects.json");
-  const runningPath = pathJoin(workHome, "running.json");
-  const projects = await loadJson(projectsPath, { projects: [] });
-  const running = await loadJson(runningPath, { session: null });
+  const projects = await loadProjects(workHome);
+  const running = await loadRunning(workHome);
   const argProject = rest[0]?.trim();
   const argTask = rest.slice(1).join(" ").trim();
-  const project = argProject ? await resolveProjectByNameOrCreate(projects, projectsPath, argProject) : await pickProjectOrCreate(projects, projectsPath);
+  const project = argProject ? await resolveProjectByNameOrCreate(workHome, projects, argProject) : await pickProjectOrCreate(workHome, projects);
   const task = argTask ? await resolveTaskByNameOrCreate(workHome, project.id, argTask) : await pickTaskOrCreate(workHome, project.id, project.name);
   if (running.session) {
     const cur = running.session;
     if (cur.projectId === project.id && cur.task === task) {
-      const elapsed = fmtElapsed(Date.now() - Date.parse(cur.startAt) - (cur.pausedMs ?? 0));
-      console.log(`Already working on ${project.name}${task ? " • " + task : ""} (${elapsed})`);
+      const elapsed = fmtElapsed(sessionElapsedMs(cur));
+      console.log(`Already working on ${formatWorkLabel(project.name, task)} (${elapsed})`);
       return;
     }
     if (!flags.yes) {
-      const elapsed = fmtElapsed(Date.now() - Date.parse(cur.startAt) - (cur.pausedMs ?? 0));
+      const elapsed = fmtElapsed(sessionElapsedMs(cur));
       console.log(`You are already working on:
-` + `  ${cur.projectName}${cur.task ? " • " + cur.task : ""}
+` + `  ${formatWorkLabel(cur.projectName, cur.task)}
 ` + `  started: ${cur.startAt}
 ` + `  elapsed: ${elapsed}
 
 ` + `Switch to:
-` + `  ${project.name}${task ? " • " + task : ""}
+` + `  ${formatWorkLabel(project.name, task)}
 `);
       const ok = await dist_default2({
         message: "Stop current and start the new one now?",
@@ -2328,60 +2352,45 @@ async function cmdOn(workHome, rest, flags) {
     pausedMs: 0,
     note: ""
   };
-  await saveJson(runningPath, { session });
-  console.log(`Working on ${project.name}${task ? " • " + task : ""}`);
+  await saveRunning(workHome, { session });
+  console.log(`Working on ${formatWorkLabel(project.name, task)}`);
 }
 async function cmdOff(workHome) {
   await ensureWorkHome(workHome);
-  const runningPath = pathJoin(workHome, "running.json");
-  const running = await loadJson(runningPath, { session: null });
+  const running = await loadRunning(workHome);
   if (!running.session) {
     console.error("No active session.");
     process.exit(1);
   }
   await stopAndPersist(workHome, running.session, nowIso());
-  await saveJson(runningPath, { session: null });
+  await saveRunning(workHome, { session: null });
   console.log("Stopped.");
 }
 async function cmdStatus(workHome) {
   await ensureWorkHome(workHome);
-  const runningPath = pathJoin(workHome, "running.json");
-  const running = await loadJson(runningPath, { session: null });
+  const running = await loadRunning(workHome);
   if (!running.session) {
     console.log("No active session.");
     return;
   }
   const s = running.session;
-  const pausedMs = s.pausedMs ?? 0;
-  const elapsed = fmtElapsed(Date.now() - Date.parse(s.startAt) - pausedMs);
-  console.log(`Running: ${s.projectName}${s.task ? " • " + s.task : ""}
+  const elapsed = fmtElapsed(sessionElapsedMs(s));
+  console.log(`Running: ${formatWorkLabel(s.projectName, s.task)}
 ` + `Started: ${s.startAt}
 ` + `Elapsed: ${elapsed}${s.pausedAt ? " (paused)" : ""}`);
 }
 async function cmdInfo(workHome, rest, flags) {
   await ensureWorkHome(workHome);
-  const projectsPath = pathJoin(workHome, "projects.json");
-  const projects = await loadJson(projectsPath, { projects: [] });
-  const a1 = rest[0]?.trim();
-  const a2 = rest[1]?.trim();
-  let projectArg = null;
-  let monthArg = null;
-  if (a1 && /^\d{4}-\d{2}$/.test(a1)) {
-    monthArg = a1;
-  } else if (a1) {
-    projectArg = a1;
-  }
-  if (a2 && /^\d{4}-\d{2}$/.test(a2)) {
-    monthArg = a2;
-  }
+  const projects = await loadProjects(workHome);
+  const { projectArg, monthArg } = parseInfoArgs(rest);
   const month = monthArg ?? localYearMonth(new Date);
   const project = projectArg != null ? findProjectByNameOrId(projects, projectArg) : await pickProjectOnly(projects);
   if (!project) {
     console.error(`Project not found.`);
     process.exit(1);
   }
-  const projectDir = pathJoin(workHome, "data", project.id);
-  const csvPath = pathJoin(projectDir, `${month}.csv`);
+  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;
@@ -2396,7 +2405,7 @@ async function cmdInfo(workHome, rest, flags) {
     totalMs += ms;
     const dayKey = localDateKey(new Date(start));
     byDayMs.set(dayKey, (byDayMs.get(dayKey) ?? 0) + ms);
-    const taskKey = (r.task ?? "").trim() || "(no task)";
+    const taskKey = normalizeTaskLabel(r.task);
     byTaskMs.set(taskKey, (byTaskMs.get(taskKey) ?? 0) + ms);
   }
   const dayRows = sortMapByKey(byDayMs).map(([k, ms]) => ({
@@ -2446,7 +2455,7 @@ async function pickProjectOnly(projects) {
   });
   return projects.projects.find((p) => p.id === picked) ?? null;
 }
-async function resolveProjectByNameOrCreate(projects, projectsPath, name) {
+async function resolveProjectByNameOrCreate(workHome, projects, name) {
   const n = name.trim();
   const found = projects.projects.find((p) => p.name.toLowerCase() === n.toLowerCase());
   if (found)
@@ -2457,10 +2466,10 @@ async function resolveProjectByNameOrCreate(projects, projectsPath, name) {
     createdAt: nowIso()
   };
   projects.projects.push(created);
-  await saveJson(projectsPath, projects);
+  await saveProjects(workHome, projects);
   return created;
 }
-async function pickProjectOrCreate(projects, projectsPath) {
+async function pickProjectOrCreate(workHome, projects) {
   const picked = await dist_default4({
     message: "Select a project",
     source: async (term) => {
@@ -2478,41 +2487,22 @@ async function pickProjectOrCreate(projects, projectsPath) {
       message: "New project name",
       validate: (v) => v.trim().length ? true : "Required"
     })).trim();
-    const created = {
-      id: globalThis.crypto?.randomUUID ? globalThis.crypto.randomUUID() : randomUuidFallback(),
-      name,
-      createdAt: nowIso()
-    };
-    projects.projects.push(created);
-    await saveJson(projectsPath, projects);
-    return created;
+    return resolveProjectByNameOrCreate(workHome, projects, name);
   }
   const found = projects.projects.find((p) => p.id === picked);
   if (!found)
     throw new Error("Project selection failed");
   return found;
 }
-async function loadTaskIndex(workHome, projectId) {
-  const dir = pathJoin(workHome, "data", projectId);
-  await ensureDir(dir);
-  const path = pathJoin(dir, "tasks.json");
-  return await loadJson(path, { tasks: [] });
-}
-async function saveTaskIndex(workHome, projectId, idx) {
-  const dir = pathJoin(workHome, "data", projectId);
-  await ensureDir(dir);
-  const path = pathJoin(dir, "tasks.json");
-  await saveJson(path, idx);
-}
 async function resolveTaskByNameOrCreate(workHome, projectId, task) {
   const idx = await loadTaskIndex(workHome, projectId);
-  const t = task.trim();
-  const found = idx.tasks.find((x) => x.name.toLowerCase() === t.toLowerCase());
+  const normalized = task.trim();
+  const found = idx.tasks.find((x) => x.name.toLowerCase() === normalized.toLowerCase());
   if (found)
     return found.name;
-  idx.tasks.push({ name: t, count: 0, lastUsedAt: null, createdAt: nowIso() });
+  idx.tasks.push({ name: normalized, count: 0, lastUsedAt: null, createdAt: nowIso() });
   await saveTaskIndex(workHome, projectId, idx);
-  return t;
+  return normalized;
 }
 async function pickTaskOrCreate(workHome, projectId, projectName) {
   const idx = await loadTaskIndex(workHome, projectId);
@@ -2520,13 +2510,7 @@ async function pickTaskOrCreate(workHome, projectId, projectName) {
     message: `Select a task for "${projectName}"`,
     source: async (term) => {
       const q = (term ?? "").toLowerCase();
-      const tasks = [...idx.tasks].sort((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);
-      }).filter((t) => t.name.toLowerCase().includes(q)).map((t) => ({ name: t.name, value: t.name }));
+      const tasks = [...idx.tasks].sort(sortTasksByRecentUse).filter((t) => t.name.toLowerCase().includes(q)).map((t) => ({ name: t.name, value: t.name }));
       return [...tasks, { name: "➕ Create new task…", value: "__create__" }];
     }
   });
@@ -2541,25 +2525,14 @@ async function pickTaskOrCreate(workHome, projectId, projectName) {
   return picked;
 }
 async function stopAndPersist(workHome, s, endAtIso) {
-  const projectDir = pathJoin(workHome, "data", s.projectId);
+  const projectDir = getProjectDir(workHome, s.projectId);
   await ensureDir(projectDir);
   const idx = await loadTaskIndex(workHome, s.projectId);
-  const entry = idx.tasks.find((t) => t.name.toLowerCase() === s.task.toLowerCase());
-  if (entry) {
-    entry.count = (entry.count ?? 0) + 1;
-    entry.lastUsedAt = nowIso();
-  } else if (s.task.trim()) {
-    idx.tasks.push({
-      name: s.task,
-      count: 1,
-      lastUsedAt: nowIso(),
-      createdAt: nowIso()
-    });
-  }
+  updateTaskStats(idx, s.task);
   await saveTaskIndex(workHome, s.projectId, idx);
   const endAt = new Date(Date.parse(endAtIso));
   const ym = localYearMonth(endAt);
-  const csvPath = pathJoin(projectDir, `${ym}.csv`);
+  const csvPath = getMonthCsvPath(workHome, s.projectId, ym);
   await ensureCsvHeader(csvPath);
   const row = {
     id: s.id,
@@ -2628,6 +2601,65 @@ function csvEsc(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) {
+  return Date.now() - Date.parse(session.startAt) - (session.pausedMs ?? 0);
+}
+function parseInfoArgs(args) {
+  const a1 = args[0]?.trim();
+  const a2 = args[1]?.trim();
+  let projectArg = null;
+  let monthArg = null;
+  if (a1 && /^\d{4}-\d{2}$/.test(a1)) {
+    monthArg = a1;
+  } else if (a1) {
+    projectArg = a1;
+  }
+  if (a2 && /^\d{4}-\d{2}$/.test(a2)) {
+    monthArg = a2;
+  }
+  return { projectArg, monthArg };
+}
+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()
+  });
+}
 process.on("uncaughtException", (error) => {
   if (error && typeof error === "object" && error.name === "ExitPromptError") {
     console.log("\uD83D\uDC4B until next time!");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecoded/work",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Work: CLI Time Tracker",
   "module": "dist/cli.js",
   "scripts": {
@@ -26,6 +26,7 @@
     "README.md"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
 }