@nickmeriano/task 0.4.2 → 0.6.0

package/dist/types.d.ts

@@ -3,7 +3,7 @@
 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". */
+    /** Display id — `<prefix>-<number>`, e.g. "PHO-12". */
     id: string;
     number: number;
     title: string;
@@ -13,13 +13,33 @@ export interface Task {
     milestone: string | null;
     /** This ticket can't be finished by an agent alone. */
     needsHuman: boolean;
+    /**
+     * Task numbers this one blocks / is blocked by. One relation, two views:
+     * a single `(blocker, blocked)` row shows up in the blocker's `blocks` and
+     * the blocked task's `blockedBy`, so the mirror can never drift.
+     */
+    blocks: number[];
+    blockedBy: number[];
+    /** Pull request URLs attached to this task. */
+    prs: string[];
     /** Sort key within a status column; smaller sorts first. */
     position: number;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Set (to true) only on tickets living in `.task/archive/` — finished work
+     * moved out of the board's hot path. Absent on live tickets, so the board
+     * payloads stay byte-identical to what they always were.
+     */
+    archived?: boolean;
 }
 export interface Comment {
-    id: number;
+    /**
+     * Stable opaque id. On file-backed boards it's the comment's filename stem
+     * (e.g. "2026-08-15T165943-claude"); on legacy SQLite boards, the rowid as a
+     * string.
+     */
+    id: string;
     taskId: string;
     author: string;
     body: string;
@@ -27,7 +47,7 @@ export interface Comment {
 }
 export interface ProjectConfig {
     name: string;
-    /** Uppercase id prefix, e.g. "PHONE" → PHONE-1, PHONE-2, … */
+    /** Uppercase id prefix, e.g. "PHO" → PHO-1, PHO-2, … */
     prefix: string;
     version: number;
 }
@@ -38,6 +58,8 @@ export interface TaskFilter {
     milestone?: string;
     /** undefined = don't filter on it at all. */
     needsHuman?: boolean;
+    /** true = list the archive instead of the board. */
+    archived?: boolean;
 }
 export interface TaskInput {
     title: string;
@@ -46,6 +68,9 @@ export interface TaskInput {
     tags?: string[];
     milestone?: string | null;
     needsHuman?: boolean;
+    blocks?: number[];
+    blockedBy?: number[];
+    prs?: string[];
 }
 export interface TaskPatch {
     title?: string;
@@ -54,6 +79,13 @@ export interface TaskPatch {
     tags?: string[];
     milestone?: string | null;
     needsHuman?: boolean;
+    /**
+     * Full replacement, like `tags` — the store reconciles the relation table
+     * to match. Writing either side updates the other task's mirror view.
+     */
+    blocks?: number[];
+    blockedBy?: number[];
+    prs?: string[];
     /** Explicit board position (used by drag-and-drop in the UI). */
     position?: number;
 }

package/dist/types.d.ts.map

@@ -1 +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"}
+{"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,uDAAuD;IACvD,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;;;;OAIG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,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,wDAAwD;IACxD,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;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;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;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;CACf;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;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEvD"}

package/dist/types.js.map

@@ -1 +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"}
+{"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;AAgGV,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAQ,QAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxD,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@nickmeriano/task",
-  "version": "0.4.2",
+  "version": "0.6.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`.",
+  "description": "A task manager that lives in your repo — plain-text tickets 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": {
@@ -25,7 +25,7 @@
     "todo",
     "kanban",
     "cli",
-    "sqlite",
+    "markdown",
     "agents",
     "local-first",
     "monorepo"
@@ -44,7 +44,7 @@
     "prepack": "pnpm build",
     "dev": "vite ui",
     "lint": "eslint .",
-    "test": "node --test --experimental-strip-types ui/src/*.test.ts",
+    "test": "node --test --experimental-strip-types src/*.test.ts ui/src/*.test.ts",
     "typecheck": "tsc --noEmit && tsc --noEmit -p ui && tsc --noEmit -p ui/tsconfig.test.json"
   },
   "engines": {

package/skill/SKILL.md

@@ -2,7 +2,7 @@
 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
+  directory of plain-text tickets, 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
@@ -13,11 +13,14 @@ description: >-
 
 # 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.
+This repository tracks its work in `.task/` at the project root: one markdown
+file per ticket under `.task/tickets/`, 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, travels with
+branches, and shows up as readable diffs in PRs. Always write through the CLI
+rather than editing ticket files by hand — it keeps numbering, positions and
+relations consistent.
 
 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.
@@ -40,8 +43,15 @@ task update <id> [--title t] [--description text] [--status s] [--tags a,b]
 task start <id>                        # → in_progress
 task done <id>                         # → done
 task move <id> <status>                # any status change
+task link <id> --blocked-by <id>       # mark a dependency (or --blocks)
+task unlink <id> --blocked-by <id>     # remove one (or --blocks)
+task update <id> --pr <url>            # attach a pull request (appends)
 task comment <id> "text" --author claude
 task delete <id>
+task boards --json                     # every board in the repo, with prefixes
+task archive <id> --json               # done/canceled ticket -> .task/archive/
+task archive --all --json              # archive everything done or canceled
+task unarchive <id> --json             # put one back on the board
 task whoami                            # who comments are attributed to
 ```
 
@@ -50,11 +60,32 @@ the user can read it from a phone, and take it away again. Both open a browser
 and wait for a human, so **never run either on your own initiative**; suggest
 `task publish` if the user wants to see the board remotely.
 
-- `<id>` is `PREFIX-12` or just `12`.
+- `<id>` is `PREFIX-12` or just `12`. A bare number means the nearest board;
+  a prefixed id routes to whichever board in the repo owns that prefix, so
+  `TAS-12` works from any directory. `task boards --json` lists them all.
 - 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.
+- Clear a field by passing it empty: `--tags ""`, `--milestone ""`, `--prs ""`.
+- `task list` hides done/canceled by default; `--all` shows everything, and
+  `--archived` lists the archive instead of the board.
+- Archiving is history, not deletion: only done/canceled tickets qualify,
+  their numbers stay reserved, and `task show` still reads them. Archived
+  tickets refuse edits until unarchived. Don't archive on your own
+  initiative — suggest `task archive --all` when finished work is piling up,
+  and let the user decide.
+
+**Dependencies.** `task link A --blocked-by B` and `task link B --blocks A`
+write the same relation — each task's `task show` lists both its `blocked`
+and `blocks` sides, with the other task's current status. Before starting a
+task, check it isn't blocked by something still open; when you discover an
+ordering ("this can't land until X does"), record it with `task link` instead
+of prose in a comment. Blocked tasks wear a red "Blocked" badge on the board
+until every blocker is done or canceled.
+
+**Pull requests.** When you open a PR for a task, attach it:
+`task update <id> --pr <url>`. Put the task id in the PR title too (e.g.
+`[TAS-6] Fix retry loop`) so the two reference each other from both sides.
+`--pr` appends one URL; `--prs url1,url2` replaces the whole list.
 
 ## How to work with the board