@nickmeriano/task 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nick Meriano
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @nickmeriano/task
+
+A task manager that lives in your repo.
+
+Tasks and their status are coupled to the code — so keep them next to it.
+State is a SQLite database in `.task/` at your project root: no accounts, no
+connectors, no drift between the board and the branch. Built for the way
+projects work now — you *and* your AI agents share one backlog, and the board
+updates live while agents move tickets from another terminal.
+
+```bash
+npx @nickmeriano/task init
+```
+
+`init` creates `.task/` — commit it, that's the point.
+
+## Teach your agent
+
+The package ships an agent skill at `skill/SKILL.md` with the conventions that
+make a shared board work: check it before starting, move tasks as work actually
+progresses, comment at milestones, file what you discover instead of letting it
+evaporate. Install it with whatever manages your agent's skills — e.g.
+[`npx skills add`](https://skills.sh) pointed at that directory.
+
+It deliberately isn't installed for you. Where skills live differs by agent and
+by repo layout, and a task manager guessing at that puts a copy somewhere
+nothing reads — which is exactly what happened the first time this tried.
+
+## Use
+
+```bash
+task add "Wire up webhook retries" --tags api --milestone launch
+task list                      # open tasks, board order
+task list --needs-human        # what's blocked on a person
+task start 1                   # → in_progress
+task done 1                    # → done
+task comment 1 "shipped in #42" --author claude
+task serve                     # kanban + table UI at localhost:4400, live
+```
+
+- Ids are `PREFIX-12` or just `12`; the prefix comes from `task init --prefix`.
+- Statuses: `backlog` `todo` `in_progress` `done` `canceled`.
+- A task carries tags, at most one milestone, and a `--needs-human` flag for
+  work an agent can't finish alone. `--tag a,b` matches either tag.
+- Comments are attributed from `git config user.name` with no setup —
+  override with `--author` or `$TASK_AUTHOR`, and check with `task whoami`.
+- Every command takes `--json` — that's the agent interface.
+- Commands work from any subdirectory; the CLI walks up to find `.task/` the
+  way git finds `.git`.
+- `task serve` is the one command that also looks *down*: run it at a monorepo
+  root and it serves every nested board from one server, with a board switcher
+  in the header. Run it inside a package and you get just that board. Every
+  other command stays scoped to the nearest `.task/`.
+- The database self-migrates when it's opened, so pulling a colleague's
+  `.task/` and running any command brings it up to date in place.
+
+## How it's built
+
+- **Zero dependencies.** Storage is Node's built-in `node:sqlite` (Node ≥
+  22.13) — nothing to compile, so `npx` starts in about a second.
+- **Realtime is a file watch.** `task serve` is one `node:http` process: the
+  prebuilt UI, a JSON API, and a server-sent-events stream that pings whenever
+  anything writes to `.task/` — this UI, another terminal, an agent mid-run.
+- **The UI is deliberately simple.** Five fixed statuses, a kanban board with
+  drag and drop, a table, a detail panel. Built on the
+  [mojo](https://ui.nickmeriano.com) design system.
+
+Docs: [task.nickmeriano.com](https://task.nickmeriano.com)

package/dist/author.d.ts

@@ -0,0 +1,17 @@
+export type AuthorSource = "flag" | "env" | "git" | "fallback";
+export interface Author {
+    name: string;
+    source: AuthorSource;
+}
+export declare const ANONYMOUS = "anonymous";
+/**
+ * Who is writing this comment. No config file: git already knows your name and
+ * it's the same one your commits carry, so attribution costs zero setup.
+ *
+ *   --author <who>  →  $TASK_AUTHOR  →  git config user.name  →  "anonymous"
+ *
+ * Agents keep passing `--author claude` explicitly, which is what the first
+ * step is for.
+ */
+export declare function resolveAuthor(flag?: string, cwd?: string): Author;
+//# sourceMappingURL=author.d.ts.map

package/dist/author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"author.d.ts","sourceRoot":"","sources":["../src/author.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAA;AAE9D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,eAAO,MAAM,SAAS,cAAc,CAAA;AA6BpC;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAQhF"}

package/dist/author.js

@@ -0,0 +1,52 @@
+import { execFileSync } from "node:child_process";
+import process from "node:process";
+export const ANONYMOUS = "anonymous";
+/** Resolved at most once per process — git config doesn't change mid-command. */
+const gitNameCache = new Map();
+/**
+ * Ask git who you are. Every way this can fail — git not installed, not a
+ * repository, `user.name` never set — is the same non-answer, so they all
+ * collapse to null rather than being told apart.
+ */
+function gitName(cwd) {
+    const cached = gitNameCache.get(cwd);
+    if (cached !== undefined)
+        return cached;
+    let name = null;
+    try {
+        const out = execFileSync("git", ["config", "--get", "user.name"], {
+            cwd,
+            encoding: "utf8",
+            timeout: 1000,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        name = out.trim() || null;
+    }
+    catch {
+        name = null;
+    }
+    gitNameCache.set(cwd, name);
+    return name;
+}
+/**
+ * Who is writing this comment. No config file: git already knows your name and
+ * it's the same one your commits carry, so attribution costs zero setup.
+ *
+ *   --author <who>  →  $TASK_AUTHOR  →  git config user.name  →  "anonymous"
+ *
+ * Agents keep passing `--author claude` explicitly, which is what the first
+ * step is for.
+ */
+export function resolveAuthor(flag, cwd = process.cwd()) {
+    const flagged = flag?.trim();
+    if (flagged)
+        return { name: flagged, source: "flag" };
+    const env = process.env.TASK_AUTHOR?.trim();
+    if (env)
+        return { name: env, source: "env" };
+    const git = gitName(cwd);
+    if (git)
+        return { name: git, source: "git" };
+    return { name: ANONYMOUS, source: "fallback" };
+}
+//# sourceMappingURL=author.js.map

package/dist/author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"author.js","sourceRoot":"","sources":["../src/author.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,OAAO,MAAM,cAAc,CAAA;AASlC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAA;AAEpC,iFAAiF;AACjF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAA;AAErD;;;;GAIG;AACH,SAAS,OAAO,CAAC,GAAW;IAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACvC,IAAI,IAAI,GAAkB,IAAI,CAAA;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE;YAChE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAA;QACF,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,CAAA;IACb,CAAC;IACD,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3B,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACtE,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAA;IAC5B,IAAI,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAA;IAC3C,IAAI,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC5C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;AAChD,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,415 @@
+#!/usr/bin/env node
+// The `task` CLI — tasks that live in your repo. Zero dependencies: hand-rolled
+// flag parsing, node:sqlite for storage, plain text out (--json for agents).
+//
+//   task init
+//   task add "Wire up webhooks" --tags api,infra --milestone launch
+//   task list --status todo,in_progress
+//   task start TASK-3 && task done TASK-3
+//   task serve
+import { readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import process from "node:process";
+import { resolveAuthor } from "./author.js";
+import { createTaskServer } from "./server.js";
+import { CONFIG_FILE, TASK_DIR, TaskStore, findBoards, findRoot, initProject } from "./store.js";
+import { STATUSES, isStatus } from "./types.js";
+// node:sqlite still emits an ExperimentalWarning on Node 22 — noise in a CLI
+// that runs it on every invocation. Filter that one warning, keep the rest.
+process.removeAllListeners("warning");
+process.on("warning", (warning) => {
+    if (warning.name !== "ExperimentalWarning")
+        console.error(warning);
+});
+const VERSION = "0.1.0";
+const DEFAULT_PORT = 4400;
+// Every valueless flag has to be listed here: an unregistered one swallows the
+// next argv token, so `task list --needs-human todo` would silently eat `todo`.
+const BOOLEAN_FLAGS = new Set([
+    "json",
+    "all",
+    "help",
+    "version",
+    "yes",
+    "needs-human",
+    "no-needs-human",
+]);
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const name = arg.slice(2);
+            const eq = name.indexOf("=");
+            if (eq >= 0) {
+                flags[name.slice(0, eq)] = name.slice(eq + 1);
+            }
+            else if (BOOLEAN_FLAGS.has(name) || i + 1 >= argv.length || argv[i + 1].startsWith("--")) {
+                flags[name] = true;
+            }
+            else {
+                flags[name] = argv[++i];
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function str(flags, name) {
+    const v = flags[name];
+    return typeof v === "string" ? v : undefined;
+}
+function fail(message) {
+    console.error(`error: ${message}`);
+    process.exit(1);
+}
+function openStore() {
+    const root = findRoot(process.cwd());
+    if (!root)
+        fail("no .task directory found in this directory or any parent — run `task init` first");
+    return new TaskStore(root);
+}
+// ── Input normalization ──────────────────────────────────────────────────────
+function parseStatus(value) {
+    const normalized = value.toLowerCase().replace(/-/g, "_");
+    if (!isStatus(normalized))
+        fail(`invalid status "${value}" — one of: ${STATUSES.join(", ")}`);
+    return normalized;
+}
+function parseTags(value) {
+    return value.split(",").map((t) => t.trim()).filter(Boolean);
+}
+function patchFromFlags(flags) {
+    const patch = {};
+    const title = str(flags, "title");
+    if (title !== undefined)
+        patch.title = title;
+    const description = str(flags, "description") ?? str(flags, "desc");
+    if (description !== undefined)
+        patch.description = description;
+    const status = str(flags, "status");
+    if (status !== undefined)
+        patch.status = parseStatus(status);
+    const tags = str(flags, "tags") ?? str(flags, "tag");
+    if (tags !== undefined)
+        patch.tags = parseTags(tags);
+    const milestone = str(flags, "milestone");
+    if (milestone !== undefined)
+        patch.milestone = milestone.trim() || null;
+    if (flags["needs-human"])
+        patch.needsHuman = true;
+    if (flags["no-needs-human"])
+        patch.needsHuman = false;
+    return patch;
+}
+// ── Output helpers ───────────────────────────────────────────────────────────
+const STATUS_GLYPH = {
+    backlog: "◌",
+    todo: "○",
+    in_progress: "◐",
+    done: "●",
+    canceled: "⊘",
+};
+function table(rows) {
+    if (rows.length === 0)
+        return;
+    const widths = rows[0].map((_, col) => Math.max(...rows.map((r) => (r[col] ?? "").length)));
+    for (const row of rows) {
+        console.log(row.map((cell, col) => (cell ?? "").padEnd(widths[col])).join("  ").trimEnd());
+    }
+}
+function taskRow(t) {
+    // Exactly six cells, always — table() lines columns up by index.
+    return [
+        t.id,
+        `${STATUS_GLYPH[t.status]} ${t.status}`,
+        t.needsHuman ? "⚑" : "",
+        t.title,
+        t.tags.join(","),
+        t.milestone ?? "",
+    ];
+}
+function printTask(t) {
+    console.log(`${t.id}  ${STATUS_GLYPH[t.status]} ${t.status}  ${t.title}`);
+}
+// ── Commands ─────────────────────────────────────────────────────────────────
+function cmdInit(args) {
+    const cwd = process.cwd();
+    if (findRoot(cwd) === cwd)
+        fail("already initialized — .task/ exists here");
+    const name = str(args.flags, "name") ?? basename(cwd);
+    const store = initProject(cwd, { name, prefix: str(args.flags, "prefix")?.toUpperCase() });
+    console.log(`Initialized ${store.config.name} (${store.config.prefix}-…) in .task/`);
+    console.log(`\nNext:`);
+    console.log(`  task add "My first task"     create a task`);
+    console.log(`  task list                    see what's open`);
+    console.log(`  task serve                   open the board UI`);
+    console.log(`\nCommit .task/ — tasks belong in the repo, next to the code they describe.`);
+    // Deliberately not installed for you: where an agent's skills live differs
+    // per agent and per repo layout, and a task manager guessing at that is how
+    // you end up with a copy somewhere nothing reads. `skill/` ships in this
+    // package — point your agent's skill installer at it.
+    console.log(`Teach your agent the conventions: skill/SKILL.md in this package.`);
+}
+function cmdAdd(args) {
+    const title = args.positional.join(" ").trim();
+    if (!title)
+        fail(`usage: task add <title> [--description …] [--status …] [--tags a,b] [--milestone …] [--needs-human]`);
+    const store = openStore();
+    const task = store.create({ title, ...patchFromFlags(args.flags) });
+    if (args.flags.json) {
+        console.log(JSON.stringify({ task }, null, 2));
+    }
+    else {
+        printTask(task);
+    }
+}
+function cmdList(args) {
+    const store = openStore();
+    const statusFlag = str(args.flags, "status");
+    const statuses = statusFlag
+        ? statusFlag.split(",").map(parseStatus)
+        : args.flags.all
+            ? undefined
+            : ["backlog", "todo", "in_progress"];
+    const tagFlag = str(args.flags, "tags") ?? str(args.flags, "tag");
+    const tasks = store.list({
+        statuses,
+        tags: tagFlag ? parseTags(tagFlag) : undefined,
+        milestone: str(args.flags, "milestone"),
+        needsHuman: args.flags["needs-human"] ? true : undefined,
+    });
+    // Present in board order: grouped by status column, then position.
+    const order = new Map(STATUSES.map((s, i) => [s, i]));
+    tasks.sort((a, b) => order.get(a.status) - order.get(b.status) || a.position - b.position);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ tasks }, null, 2));
+    }
+    else if (tasks.length === 0) {
+        console.log(args.flags.all ? "no tasks" : "no open tasks (--all includes done/canceled)");
+    }
+    else {
+        table(tasks.map(taskRow));
+    }
+}
+function cmdShow(args) {
+    const ref = args.positional[0];
+    if (!ref)
+        fail("usage: task show <id>");
+    const store = openStore();
+    const number = store.parseId(ref);
+    const task = store.get(number);
+    if (!task)
+        fail(`no such task: ${store.displayId(number)}`);
+    const comments = store.comments(number);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ task, comments }, null, 2));
+        return;
+    }
+    console.log(`${task.id}  ${task.title}`);
+    console.log(`status    ${task.status}`);
+    if (task.needsHuman)
+        console.log(`needs     a human`);
+    if (task.tags.length)
+        console.log(`tags      ${task.tags.join(", ")}`);
+    if (task.milestone)
+        console.log(`milestone ${task.milestone}`);
+    console.log(`created   ${task.createdAt}`);
+    console.log(`updated   ${task.updatedAt}`);
+    if (task.description)
+        console.log(`\n${task.description}`);
+    if (comments.length) {
+        console.log(``);
+        for (const c of comments) {
+            console.log(`— ${c.author || "anonymous"} · ${c.createdAt}`);
+            console.log(`  ${c.body.split("\n").join("\n  ")}`);
+        }
+    }
+}
+function cmdUpdate(args, forcedStatus) {
+    const ref = args.positional[0];
+    if (!ref)
+        fail("usage: task update <id> [--status …] [--title …] …");
+    const store = openStore();
+    const patch = patchFromFlags(args.flags);
+    if (forcedStatus)
+        patch.status = forcedStatus;
+    if (Object.keys(patch).length === 0)
+        fail("nothing to update — pass at least one flag");
+    const task = store.update(store.parseId(ref), patch);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ task }, null, 2));
+    }
+    else {
+        printTask(task);
+    }
+}
+function cmdMove(args) {
+    const [ref, status] = args.positional;
+    if (!ref || !status)
+        fail("usage: task move <id> <status>");
+    cmdUpdate({ positional: [ref], flags: { ...args.flags, status } });
+}
+function cmdComment(args) {
+    const [ref, ...rest] = args.positional;
+    const body = rest.join(" ").trim();
+    if (!ref || !body)
+        fail(`usage: task comment <id> <text> [--author <who>]`);
+    const store = openStore();
+    const author = resolveAuthor(str(args.flags, "author")).name;
+    const comment = store.addComment(store.parseId(ref), body, author);
+    if (args.flags.json) {
+        console.log(JSON.stringify({ comment }, null, 2));
+    }
+    else {
+        console.log(`commented on ${comment.taskId}`);
+    }
+}
+const AUTHOR_SOURCE = {
+    flag: "--author",
+    env: "$TASK_AUTHOR",
+    git: "git config user.name",
+    fallback: "no name found — set git config user.name or $TASK_AUTHOR",
+};
+/** Deliberately never opens the store, so it answers outside a .task/ repo. */
+function cmdWhoami(args) {
+    const author = resolveAuthor(str(args.flags, "author"));
+    if (args.flags.json) {
+        console.log(JSON.stringify(author, null, 2));
+    }
+    else {
+        console.log(`${author.name}  (${AUTHOR_SOURCE[author.source]})`);
+    }
+}
+function cmdDelete(args) {
+    const ref = args.positional[0];
+    if (!ref)
+        fail("usage: task delete <id>");
+    const store = openStore();
+    const number = store.parseId(ref);
+    store.delete(number);
+    console.log(`deleted ${store.displayId(number)}`);
+}
+function cmdServe(args) {
+    // Serve is the one command that's monorepo-aware: anchor at the nearest
+    // board like every other command, but if there is none, serve whatever
+    // boards live *below* here instead of failing.
+    const serveRoot = findRoot(process.cwd()) ?? process.cwd();
+    const boards = findBoards(serveRoot);
+    if (boards.length === 0) {
+        fail("no .task directory found in this directory, any parent, or below — run `task init` first");
+    }
+    const port = Number(str(args.flags, "port") ?? DEFAULT_PORT);
+    if (!Number.isInteger(port) || port <= 0)
+        fail(`invalid port: ${str(args.flags, "port")}`);
+    const server = createTaskServer(serveRoot);
+    server.on("error", (error) => {
+        if (error.code === "EADDRINUSE")
+            fail(`port ${port} is in use — try --port <n>`);
+        fail(error.message);
+    });
+    server.listen(port, () => {
+        const boardName = (root) => JSON.parse(readFileSync(join(root, TASK_DIR, CONFIG_FILE), "utf8"))
+            .name;
+        if (boards.length === 1) {
+            console.log(`${boardName(boards[0].root)} · task board`);
+        }
+        else {
+            console.log(`${boards.length} boards · task board`);
+            for (const board of boards)
+                console.log(`  ${board.id}  ${boardName(board.root)}`);
+        }
+        console.log(`  http://localhost:${port}`);
+        console.log(`Live: edits from any terminal or agent show up as they happen. Ctrl-C to stop.`);
+    });
+}
+// ── Help + dispatch ──────────────────────────────────────────────────────────
+const HELP = `task — a task manager that lives in your repo
+
+State is a SQLite database in .task/ at the project root. Commit it: tasks and
+their status travel with the code they describe. Any command works from any
+subdirectory (it walks up to find .task/, like git).
+
+Usage
+  task init [--name <name>] [--prefix <PREFIX>]
+  task add <title> [--description <text>] [--status <s>] [--tags <a,b>]
+                   [--milestone <m>] [--needs-human]
+  task list [--status <s1,s2>] [--tag <a,b>] [--milestone <m>]
+            [--needs-human] [--all]
+  task show <id>
+  task update <id> [--title <t>] [--description <text>] [--status <s>]
+                   [--tags <a,b>] [--milestone <m>]
+                   [--needs-human | --no-needs-human]
+  task move <id> <status>       shorthand for update --status
+  task start <id>               → in_progress
+  task done <id>                → done
+  task comment <id> <text> [--author <who>]
+  task delete <id>
+  task whoami                   who your comments are attributed to
+  task serve [--port <n>]       board + table UI with live updates (default port ${DEFAULT_PORT});
+                                serves every board at or below here — in a
+                                monorepo the header becomes a board switcher
+
+Values
+  <id>          TASK-12, or just 12
+  status        ${STATUSES.join("  ")}
+  --tag a,b     matches a task carrying *either* tag
+  --needs-human this can't be finished by an agent alone
+  clearing      --tags "" drops all tags, --milestone "" clears it
+
+Comment authors resolve --author → $TASK_AUTHOR → git config user.name →
+anonymous, so there is nothing to set up. \`task whoami\` shows which one won.
+
+Every read/write command accepts --json for machine-readable output — that's
+the interface AI agents should use.
+`;
+function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    const args = parseArgs(rest);
+    if (!command || command === "help" || args.flags.help) {
+        console.log(HELP);
+        return;
+    }
+    if (command === "--version" || args.flags.version) {
+        console.log(VERSION);
+        return;
+    }
+    switch (command) {
+        case "init":
+            return cmdInit(args);
+        case "add":
+            return cmdAdd(args);
+        case "list":
+            return cmdList(args);
+        case "show":
+            return cmdShow(args);
+        case "update":
+            return cmdUpdate(args);
+        case "move":
+            return cmdMove(args);
+        case "start":
+            return cmdUpdate(args, "in_progress");
+        case "done":
+            return cmdUpdate(args, "done");
+        case "comment":
+            return cmdComment(args);
+        case "whoami":
+            return cmdWhoami(args);
+        case "delete":
+            return cmdDelete(args);
+        case "serve":
+            return cmdServe(args);
+        default:
+            fail(`unknown command "${command}" — run \`task help\``);
+    }
+}
+try {
+    main();
+}
+catch (error) {
+    fail(error instanceof Error ? error.message : String(error));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { TaskStore, findRoot, findBoards, initProject, derivePrefix, type BoardRef } from "./store.js";
+export { createTaskServer } from "./server.js";
+export { resolveAuthor, ANONYMOUS, type Author, type AuthorSource } from "./author.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AACtG,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AACtF,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Programmatic access to the same store the CLI and `task serve` use — for
+// scripts that want to read or write .task/ without shelling out.
+export { TaskStore, findRoot, findBoards, initProject, derivePrefix } from "./store.js";
+export { createTaskServer } from "./server.js";
+export { resolveAuthor, ANONYMOUS } from "./author.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,kEAAkE;AAClE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAA;AACtG,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAkC,MAAM,aAAa,CAAA;AACtF,cAAc,YAAY,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+import { type Server } from "node:http";
+/**
+ * `task serve` — one plain node:http server for the static UI, the JSON API,
+ * and an SSE stream that pings whenever anything writes to a `.task/` (the UI
+ * itself, another terminal, or an agent running the CLI). The UI refetches on
+ * every ping, so "realtime" is just fs.watch + a debounce — no sockets, no
+ * state to reconcile.
+ *
+ * Serves every board found at or below `serveRoot` (see `findBoards`): API
+ * requests pick one with `?board=<id>`, defaulting to the first. One board is
+ * the common case and behaves exactly as before.
+ */
+export declare function createTaskServer(serveRoot: string): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAA;AAsDhG;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAqP1D"}