@nickmeriano/task 0.1.0

package/dist/store.js

@@ -0,0 +1,346 @@
+import { DatabaseSync } from "node:sqlite";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+export const TASK_DIR = ".task";
+export const DB_FILE = "tasks.db";
+export const CONFIG_FILE = "config.json";
+/** Spacing between adjacent board positions — leaves room to drop between. */
+const POSITION_GAP = 1024;
+/**
+ * Walk up from `from` looking for a `.task/config.json`, the way git finds its
+ * `.git`. Returns the directory that *contains* `.task`, or null.
+ */
+export function findRoot(from) {
+    let dir = from;
+    for (;;) {
+        if (existsSync(join(dir, TASK_DIR, CONFIG_FILE)))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** Directories that never contain a board worth serving. */
+const SKIP_DIRS = new Set(["node_modules", "dist", "build", "out", "coverage", "target"]);
+/**
+ * The multi-board complement of `findRoot`: walk *down* from `serveRoot`
+ * collecting every directory that holds a `.task/config.json`, so one
+ * `task serve` at a monorepo root can serve every nested board. Boards are
+ * identified by relative path — unique where names need not be. Dot-dirs,
+ * dependency/build dirs and symlinks are skipped; unreadable dirs are ignored.
+ */
+export function findBoards(serveRoot, maxDepth = 6) {
+    const boards = [];
+    let level = [serveRoot];
+    for (let depth = 0; depth <= maxDepth && level.length > 0; depth++) {
+        const next = [];
+        for (const dir of level) {
+            if (existsSync(join(dir, TASK_DIR, CONFIG_FILE))) {
+                const rel = relative(serveRoot, dir).split(sep).join("/");
+                boards.push({ id: rel === "" ? "." : rel, root: dir });
+            }
+            let entries;
+            try {
+                entries = readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                // isDirectory() is false for symlinks — that's the cycle/escape guard.
+                if (!entry.isDirectory())
+                    continue;
+                if (entry.name.startsWith(".") || SKIP_DIRS.has(entry.name))
+                    continue;
+                next.push(join(dir, entry.name));
+            }
+        }
+        level = next;
+    }
+    // "." first, then lexicographic: the default board is deterministic.
+    boards.sort((a, b) => (a.id === "." ? -1 : b.id === "." ? 1 : a.id < b.id ? -1 : 1));
+    return boards;
+}
+/** Derive an id prefix from a project name: "phone agent" → "PHONE". */
+export function derivePrefix(name) {
+    const word = name.toUpperCase().replace(/[^A-Z0-9]+/g, " ").trim().split(" ")[0];
+    return (word || "TASK").slice(0, 10);
+}
+function now() {
+    return new Date().toISOString();
+}
+/**
+ * The whole persistence layer: one SQLite database inside `.task/`, opened
+ * synchronously via node:sqlite (built into Node ≥22.13 — zero dependencies,
+ * nothing to compile, safe for `npx`).
+ */
+export class TaskStore {
+    root;
+    taskDir;
+    config;
+    db;
+    constructor(root) {
+        this.root = root;
+        this.taskDir = join(root, TASK_DIR);
+        this.config = JSON.parse(readFileSync(join(this.taskDir, CONFIG_FILE), "utf8"));
+        this.db = new DatabaseSync(join(this.taskDir, DB_FILE));
+        // Multiple writers (CLI + serve + agents) are expected; wait for locks
+        // instead of failing fast with SQLITE_BUSY.
+        this.db.exec("PRAGMA busy_timeout = 3000");
+        this.db.exec("PRAGMA foreign_keys = ON");
+        migrate(this.db);
+    }
+    close() {
+        this.db.close();
+    }
+    displayId(number) {
+        return `${this.config.prefix}-${number}`;
+    }
+    /** Accepts "PHONE-12", "phone-12" or "12". */
+    parseId(ref) {
+        const match = /^(?:[A-Za-z0-9]+-)?(\d+)$/.exec(ref.trim());
+        if (!match)
+            throw new Error(`invalid task id: ${ref}`);
+        return Number(match[1]);
+    }
+    toTask(row) {
+        return {
+            id: this.displayId(row.id),
+            number: row.id,
+            title: row.title,
+            description: row.description,
+            status: row.status,
+            tags: JSON.parse(row.tags),
+            milestone: row.milestone,
+            needsHuman: row.needs_human !== 0,
+            position: row.position,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    toComment(row) {
+        return {
+            id: row.id,
+            taskId: this.displayId(row.task_id),
+            author: row.author,
+            body: row.body,
+            createdAt: row.created_at,
+        };
+    }
+    list(filter = {}) {
+        const where = [];
+        const params = [];
+        if (filter.statuses?.length) {
+            where.push(`status IN (${filter.statuses.map(() => "?").join(", ")})`);
+            params.push(...filter.statuses);
+        }
+        if (filter.milestone) {
+            where.push("milestone = ?");
+            params.push(filter.milestone);
+        }
+        if (filter.needsHuman !== undefined) {
+            where.push("needs_human = ?");
+            params.push(filter.needsHuman ? 1 : 0);
+        }
+        const sql = `SELECT * FROM tasks${where.length ? ` WHERE ${where.join(" AND ")}` : ""} ORDER BY position, id`;
+        let rows = this.db.prepare(sql).all(...params);
+        if (filter.tags?.length) {
+            // Tags are a JSON blob, not a table — match them in JS, any-of.
+            const wanted = new Set(filter.tags);
+            rows = rows.filter((r) => JSON.parse(r.tags).some((t) => wanted.has(t)));
+        }
+        return rows.map((r) => this.toTask(r));
+    }
+    get(number) {
+        const row = this.db.prepare("SELECT * FROM tasks WHERE id = ?").get(number);
+        return row ? this.toTask(row) : null;
+    }
+    create(input) {
+        const status = input.status ?? "todo";
+        // New tasks land at the bottom of their column.
+        const max = this.db
+            .prepare("SELECT MAX(position) AS max FROM tasks WHERE status = ?")
+            .get(status);
+        const timestamp = now();
+        const result = this.db
+            .prepare(`INSERT INTO tasks (title, description, status, tags, milestone, needs_human, position, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(input.title, input.description ?? "", status, JSON.stringify(input.tags ?? []), input.milestone ?? null, input.needsHuman ? 1 : 0, (max.max ?? 0) + POSITION_GAP, timestamp, timestamp);
+        return this.get(Number(result.lastInsertRowid));
+    }
+    update(number, patch) {
+        const existing = this.get(number);
+        if (!existing)
+            throw new Error(`no such task: ${this.displayId(number)}`);
+        const sets = [];
+        const params = [];
+        const set = (column, value) => {
+            sets.push(`${column} = ?`);
+            params.push(value);
+        };
+        if (patch.title !== undefined)
+            set("title", patch.title);
+        if (patch.description !== undefined)
+            set("description", patch.description);
+        if (patch.tags !== undefined)
+            set("tags", JSON.stringify(patch.tags));
+        if (patch.milestone !== undefined)
+            set("milestone", patch.milestone);
+        if (patch.needsHuman !== undefined)
+            set("needs_human", patch.needsHuman ? 1 : 0);
+        if (patch.status !== undefined) {
+            set("status", patch.status);
+            if (patch.position === undefined && patch.status !== existing.status) {
+                // Moved columns without an explicit slot → land on top, where the
+                // freshest movement is visible (Linear's behavior).
+                const min = this.db
+                    .prepare("SELECT MIN(position) AS min FROM tasks WHERE status = ?")
+                    .get(patch.status);
+                set("position", (min.min ?? 0) - POSITION_GAP);
+            }
+        }
+        if (patch.position !== undefined)
+            set("position", patch.position);
+        if (sets.length === 0)
+            return existing;
+        set("updated_at", now());
+        params.push(number);
+        this.db.prepare(`UPDATE tasks SET ${sets.join(", ")} WHERE id = ?`).run(...params);
+        return this.get(number);
+    }
+    delete(number) {
+        const result = this.db.prepare("DELETE FROM tasks WHERE id = ?").run(number);
+        if (result.changes === 0)
+            throw new Error(`no such task: ${this.displayId(number)}`);
+    }
+    comments(number) {
+        const rows = this.db
+            .prepare("SELECT * FROM comments WHERE task_id = ? ORDER BY id")
+            .all(number);
+        return rows.map((r) => this.toComment(r));
+    }
+    addComment(number, body, author = "") {
+        if (!this.get(number))
+            throw new Error(`no such task: ${this.displayId(number)}`);
+        const result = this.db
+            .prepare("INSERT INTO comments (task_id, author, body, created_at) VALUES (?, ?, ?, ?)")
+            .run(number, author, body, now());
+        const row = this.db
+            .prepare("SELECT * FROM comments WHERE id = ?")
+            .get(Number(result.lastInsertRowid));
+        return this.toComment(row);
+    }
+    deleteComment(number, commentId) {
+        const row = this.db
+            .prepare("SELECT * FROM comments WHERE id = ? AND task_id = ?")
+            .get(commentId, number);
+        if (!row)
+            throw new Error(`no such comment on ${this.displayId(number)}: ${commentId}`);
+        this.db.prepare("DELETE FROM comments WHERE id = ?").run(commentId);
+        return this.toComment(row);
+    }
+    commentCounts() {
+        const rows = this.db
+            .prepare("SELECT task_id, COUNT(*) AS count FROM comments GROUP BY task_id")
+            .all();
+        return new Map(rows.map((r) => [r.task_id, r.count]));
+    }
+}
+/**
+ * Schema history, one entry per version, applied in order from whatever
+ * `PRAGMA user_version` the file is at. `.task/tasks.db` is committed to git,
+ * so an existing database is the normal case, not the exception: every step
+ * has to be safe to run against a file someone else's checkout wrote.
+ *
+ * There is one linear path — a fresh database runs *every* step, so it lands
+ * on a schema byte-identical to a migrated one, and there's no second
+ * definition of "current" to keep in sync.
+ */
+const MIGRATIONS = [
+    // v1 — the original schema. `IF NOT EXISTS` is load-bearing: user_version 0
+    // means "fresh *or* written before versioning existed", and this is the step
+    // that makes both of those safe to start from.
+    //
+    // The odd indentation is deliberate and load-bearing: SQLite stores the
+    // CREATE statement *verbatim* in sqlite_master, so keeping this byte-for-byte
+    // as it originally shipped is what lets a freshly-created database and a
+    // migrated one end up with an identical schema rather than one that only
+    // matches in structure.
+    `
+    CREATE TABLE IF NOT EXISTS tasks (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL DEFAULT 'todo',
+      priority TEXT NOT NULL DEFAULT 'none',
+      assignee TEXT,
+      labels TEXT NOT NULL DEFAULT '[]',
+      position REAL NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS comments (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      task_id INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+      author TEXT NOT NULL DEFAULT '',
+      body TEXT NOT NULL,
+      created_at TEXT NOT NULL
+    );
+  `,
+    // v2 — labels become tags, priority/assignee give way to milestone and a
+    // needs-human flag. RENAME COLUMN (SQLite 3.25+) and DROP COLUMN (3.35+) are
+    // both available on Node ≥ 22.13, which bundles 3.49.
+    //
+    // If DROP COLUMN ever weren't available the escape hatch is the usual table
+    // rebuild — but note it would need `PRAGMA foreign_keys = OFF` issued
+    // *outside* the transaction (the pragma is a no-op inside one), because
+    // comments.task_id references tasks(id).
+    `ALTER TABLE tasks RENAME COLUMN labels TO tags;
+   ALTER TABLE tasks ADD COLUMN milestone TEXT;
+   ALTER TABLE tasks ADD COLUMN needs_human INTEGER NOT NULL DEFAULT 0;
+   ALTER TABLE tasks DROP COLUMN priority;
+   ALTER TABLE tasks DROP COLUMN assignee;`,
+];
+/**
+ * Bring `db` up to the newest schema. DDL and `PRAGMA user_version` are both
+ * transactional in SQLite, so a failure halfway leaves the file exactly as it
+ * was — schema *and* version.
+ */
+function migrate(db) {
+    const { user_version: version } = db.prepare("PRAGMA user_version").get();
+    if (version >= MIGRATIONS.length)
+        return;
+    db.exec("BEGIN");
+    try {
+        for (const step of MIGRATIONS.slice(version))
+            db.exec(step);
+        db.exec(`PRAGMA user_version = ${MIGRATIONS.length}`);
+        db.exec("COMMIT");
+    }
+    catch (error) {
+        db.exec("ROLLBACK");
+        throw error;
+    }
+}
+/**
+ * Create `.task/` in `root`: config, an empty database, and a .gitignore for
+ * SQLite's transient sidecar files (the database itself is meant to be
+ * committed — that's the point).
+ */
+export function initProject(root, options) {
+    const taskDir = join(root, TASK_DIR);
+    if (existsSync(join(taskDir, CONFIG_FILE))) {
+        throw new Error(`already initialized: ${join(taskDir, CONFIG_FILE)} exists`);
+    }
+    mkdirSync(taskDir, { recursive: true });
+    const config = {
+        name: options.name,
+        prefix: options.prefix ?? derivePrefix(options.name),
+        version: 1,
+    };
+    writeFileSync(join(taskDir, CONFIG_FILE), `${JSON.stringify(config, null, 2)}\n`);
+    writeFileSync(join(taskDir, ".gitignore"), "# SQLite transients — tasks.db itself is committed.\n*.db-journal\n*.db-wal\n*.db-shm\n");
+    return new TaskStore(root);
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+/** The five workflow states, in board order. Fixed on purpose — a task manager
+ * you can configure is a task manager you have to configure. */
+export declare const STATUSES: readonly ["backlog", "todo", "in_progress", "done", "canceled"];
+export type Status = (typeof STATUSES)[number];
+export interface Task {
+    /** Display id — `<prefix>-<number>`, e.g. "PHONE-12". */
+    id: string;
+    number: number;
+    title: string;
+    description: string;
+    status: Status;
+    tags: string[];
+    milestone: string | null;
+    /** This ticket can't be finished by an agent alone. */
+    needsHuman: boolean;
+    /** Sort key within a status column; smaller sorts first. */
+    position: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Comment {
+    id: number;
+    taskId: string;
+    author: string;
+    body: string;
+    createdAt: string;
+}
+export interface ProjectConfig {
+    name: string;
+    /** Uppercase id prefix, e.g. "PHONE" → PHONE-1, PHONE-2, … */
+    prefix: string;
+    version: number;
+}
+export interface TaskFilter {
+    statuses?: Status[];
+    /** Any-of: a task matches if it carries at least one of these tags. */
+    tags?: string[];
+    milestone?: string;
+    /** undefined = don't filter on it at all. */
+    needsHuman?: boolean;
+}
+export interface TaskInput {
+    title: string;
+    description?: string;
+    status?: Status;
+    tags?: string[];
+    milestone?: string | null;
+    needsHuman?: boolean;
+}
+export interface TaskPatch {
+    title?: string;
+    description?: string;
+    status?: Status;
+    tags?: string[];
+    milestone?: string | null;
+    needsHuman?: boolean;
+    /** Explicit board position (used by drag-and-drop in the UI). */
+    position?: number;
+}
+export declare function isStatus(value: string): value is Status;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;gEACgE;AAChE,eAAO,MAAM,QAAQ,iEAMX,CAAA;AACV,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9C,MAAM,WAAW,IAAI;IACnB,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAA;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEvD"}

package/dist/types.js

@@ -0,0 +1,13 @@
+/** The five workflow states, in board order. Fixed on purpose — a task manager
+ * you can configure is a task manager you have to configure. */
+export const STATUSES = [
+    "backlog",
+    "todo",
+    "in_progress",
+    "done",
+    "canceled",
+];
+export function isStatus(value) {
+    return STATUSES.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;gEACgE;AAChE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS;IACT,MAAM;IACN,aAAa;IACb,MAAM;IACN,UAAU;CACF,CAAA;AAgEV,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAQ,QAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@nickmeriano/task",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "A task manager that lives in your repo — SQLite in .task/, a zero-dependency CLI for humans and agents, and a live kanban/table UI via `task serve`.",
+  "license": "MIT",
+  "homepage": "https://task.nickmeriano.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nicmeriano/nickmeriano.com.git",
+    "directory": "projects/task/cli"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "task": "./dist/cli.js"
+  },
+  "keywords": [
+    "task",
+    "tasks",
+    "todo",
+    "kanban",
+    "cli",
+    "sqlite",
+    "agents",
+    "local-first",
+    "monorepo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "ui/dist",
+    "skill"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && vite build ui",
+    "prepack": "pnpm build",
+    "dev": "vite ui",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p ui"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "devDependencies": {
+    "@fontsource-variable/inter": "^5.3.0",
+    "@tailwindcss/vite": "^4.2.0",
+    "@tanstack/react-query": "^5.90.5",
+    "@tanstack/react-router": "^1.170.18",
+    "@tiptap/core": "^3.29.2",
+    "@tiptap/extension-list": "^3.29.2",
+    "@tiptap/extensions": "^3.29.2",
+    "@tiptap/markdown": "^3.29.2",
+    "@tiptap/pm": "^3.29.2",
+    "@tiptap/react": "^3.29.2",
+    "@tiptap/starter-kit": "^3.29.2",
+    "@types/node": "^22.19.11",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^1.26.0",
+    "react": "^19.2.0",
+    "react-aria-components": "^1.19.0",
+    "react-dom": "^19.2.0",
+    "shadcn": "^4.14.0",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.2.0",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.1"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: tasks
+description: >-
+  Work with this repository's built-in task manager (the `task` CLI — a .task/
+  directory with a SQLite database, from @nickmeriano/task). Use this
+  skill whenever the user mentions tasks, tickets, issues, todos, backlog,
+  kanban, board, "what's next", "what should I work on", or asks you to plan,
+  track, or report progress on work — and also on your own initiative: when you
+  start a multi-step piece of work in a repo that has a .task/ directory, track
+  it here instead of only in your internal todo list, so the user can watch
+  progress live on the board and the plan survives your session.
+---
+
+# tasks — the repo's task manager
+
+This repository tracks its work in `.task/` at the project root: a SQLite
+database driven by the `task` CLI. Tasks live in the repo, next to the code
+they describe — when you update a task, the user sees it instantly (the board
+UI at `task serve` updates in realtime), and the state is committed with the
+code, so it survives sessions and travels with branches.
+
+Run `task` from anywhere in the repo; it walks up to find `.task/` like git
+finds `.git`. If the CLI isn't on PATH, use `npx @nickmeriano/task` instead.
+
+## The one rule that matters
+
+Always pass `--json` when you need to read a result — it prints stable,
+machine-readable output. Human-format output is for the user's terminal, not
+for parsing.
+
+## Commands
+
+```bash
+task list [--status s1,s2] [--tag a,b] [--milestone m] [--needs-human] [--all] --json
+task show <id> --json                  # full task + comments
+task add "Title" [--description text] [--status s] [--tags a,b]
+                 [--milestone m] [--needs-human] --json
+task update <id> [--title t] [--description text] [--status s] [--tags a,b]
+                 [--milestone m] [--needs-human | --no-needs-human] --json
+task start <id>                        # → in_progress
+task done <id>                         # → done
+task move <id> <status>                # any status change
+task comment <id> "text" --author claude
+task delete <id>
+task whoami                            # who comments are attributed to
+```
+
+- `<id>` is `PREFIX-12` or just `12`.
+- Statuses: `backlog` `todo` `in_progress` `done` `canceled`.
+- `--tag a,b` matches a task carrying *either* tag, not both.
+- Clear a field by passing it empty: `--tags ""`, `--milestone ""`.
+- `task list` hides done/canceled by default; `--all` shows everything.
+
+## How to work with the board
+
+**Starting work.** Before picking up a request, check `task list --json` —
+the work may already be tracked. If it is, `task start <id>` so the board
+shows it moving. If it isn't and the work is more than a quick edit, create a
+task first: the user watching the board should be able to tell what you're
+doing without reading your transcript.
+
+**While working.** Leave short progress comments at real milestones —
+`task comment 12 "found the root cause: the debounce swallows the last event" --author claude`.
+Comment when something changes understanding, not on a timer. If you discover
+new work you're not going to do now (a bug, a refactor, a follow-up), don't
+let it evaporate: `task add` it to `backlog` or `todo` with enough description
+that someone else could pick it up cold.
+
+**Finishing.** `task done <id>` only when the work is actually done — code
+written, checks passing. If you're stopping partway, leave it `in_progress`
+with a comment saying exactly where you stopped and what's left. If the work
+turned out to be unnecessary, `task move <id> canceled` with a comment saying
+why — a canceled task with a reason beats a deleted one.
+
+**When you can't finish it alone.** Some tickets need a person: a credential
+only they can issue, a design call that isn't yours to make, an action against
+production. Mark those `--needs-human`, comment saying exactly what you need,
+and leave the task `in_progress` — not `done`. Moving it to `done` because
+your part is finished hides the one thing the board exists to surface. Clear
+the flag with `--no-needs-human` once the person has unblocked it.
+
+**Attribution.** Pass `--author claude` on your comments so the user can tell
+your updates from theirs. Their own comments are attributed automatically from
+`git config user.name` — there's nothing to configure, and `task whoami` shows
+who the CLI thinks you are.
+
+## Writing good tasks
+
+Titles are imperative and specific: "Fix retry loop dropping the last
+webhook", not "webhook bug". Descriptions carry the context you'd want if you
+picked the task up cold: the file paths involved, the constraint that makes it
+non-obvious, the definition of done. Tags are lowercase single words
+(`api`, `infra`, `ui`, `bug`) — reuse the repo's existing tags
+(`task list --all --json` shows what's in use) before inventing new ones. A
+milestone is the one release or push a task belongs to; there's at most one,
+and the same rule applies — join an existing one rather than coining a variant.
+
+## The UI
+
+`task serve` starts the board (kanban + table) at `http://localhost:4400`.
+It updates live as you run CLI commands — no refresh needed. Offer to start
+it when the user wants to see the state of the work; don't start it unasked
+in a session where nobody will look at it.
+
+In a monorepo, `task serve` run at the root serves every nested board (each
+package's `.task/`) from one server — the header becomes a board switcher.
+This changes nothing for the other commands: they still operate on the
+nearest `.task/` walking up from the current directory, so `cd` into the
+package whose board you mean before running them.