@hardlydifficult/task-list 1.0.0 → 1.0.2

package/README.md

@@ -13,27 +13,25 @@ npm install @hardlydifficult/task-list
 ```typescript
 import { createTaskListClient } from "@hardlydifficult/task-list";
 
-const client = createTaskListClient({ type: "trello" });
+// Trello
+const trello = createTaskListClient({ type: "trello" });
 
-// Get all boards with full state
-const state = await client.getBoards();
+// Linear
+const linear = createTaskListClient({
+  type: "linear",
+  teamId: "team-uuid",
+});
 
-// Chainable lookups
-const list = state.findBoard("My Project").findList("To Do");
-const label = state.findBoard("My Project").findLabel("Bug");
+// Find a project and create a task
+const project = await linear.findProject("Q1 Roadmap");
 
-// Create a task
-const task = await list.createTask("Fix login page", {
+const task = await project.createTask("Fix login", {
   description: "Users can't log in on mobile",
-  labels: [label],
+  labels: ["Bug"],
 });
 
 // Update a task
-await task.update({ name: "Fixed login page" });
-
-// Move to another list
-const doneList = state.findBoard("My Project").findList("Done");
-await task.update({ list: doneList });
+await task.update({ status: "Done" });
 ```
 
 ## API
@@ -46,83 +44,93 @@ Factory function — returns a `TaskListClient` based on config type.
 // Trello (uses TRELLO_API_KEY / TRELLO_API_TOKEN env vars by default)
 const client = createTaskListClient({ type: "trello" });
 
-// Explicit credentials
+// Trello with explicit credentials
 const client = createTaskListClient({
   type: "trello",
   apiKey: "your-key",
   token: "your-token",
 });
+
+// Linear (uses LINEAR_API_KEY env var by default)
+const client = createTaskListClient({
+  type: "linear",
+  teamId: "team-uuid",
+});
+
+// Linear with explicit API key
+const client = createTaskListClient({
+  type: "linear",
+  apiKey: "lin_xxx",
+  teamId: "team-uuid",
+});
 ```
 
 ### `TaskListClient`
 
 | Method | Returns | Description |
 |--------|---------|-------------|
-| `getBoards()` | `FullState` | All boards with lists, tasks, and labels |
-| `getBoard(boardId)` | `BoardState` | Single board with lists, tasks, and labels |
+| `getProjects()` | `FullState` | All projects with statuses, tasks, and labels |
+| `getProject(projectId)` | `Project` | Single project with statuses, tasks, and labels |
 | `getTask(taskId)` | `Task` | Single task by ID |
+| `findProject(name)` | `Project` | Find project by name (case-insensitive partial match) |
 
 ### `FullState`
 
+| Property | Type | Description |
+|----------|------|-------------|
+| `projects` | `Project[]` | All projects |
+
 | Method | Returns | Description |
 |--------|---------|-------------|
-| `findBoard(name)` | `BoardState` | Find by name (case-insensitive partial match) |
-| `findTask(taskId)` | `Task` | Find task by ID across all boards |
+| `findProject(name)` | `Project` | Find by name (case-insensitive partial match) |
+| `findTask(taskId)` | `Task` | Find task by ID across all projects |
 
-### `BoardState`
+### `Project`
 
 | Property | Type | Description |
 |----------|------|-------------|
-| `board` | `Board` | Board info (id, name, url) |
-| `lists` | `TaskList[]` | All lists on the board |
-| `tasks` | `Task[]` | All tasks on the board |
-| `labels` | `Label[]` | All labels on the board |
+| `id` | `string` | Project identifier |
+| `name` | `string` | Project name |
+| `url` | `string` | Project URL |
+| `statuses` | `string[]` | Available status names |
+| `labels` | `string[]` | Available label names |
+| `tasks` | `Task[]` | All tasks in the project |
 
 | Method | Returns | Description |
 |--------|---------|-------------|
-| `findList(name)` | `TaskList` | Find by name (case-insensitive partial match) |
+| `createTask(name, options?)` | `Task` | Create a task in this project |
 | `findTask(taskId)` | `Task` | Find task by ID |
-| `findLabel(name)` | `Label` | Find by name (case-insensitive partial match) |
 
-### `TaskList`
-
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `createTask(name, options?)` | `Task` | Create a task in this list |
-
-Options: `{ description?: string, labels?: Label[] }`
+Options: `{ description?: string, status?: string, labels?: string[] }`
 
 ### `Task`
 
-| Property | Type |
-|----------|------|
-| `id` | `string` |
-| `name` | `string` |
-| `description` | `string` |
-| `listId` | `string` |
-| `boardId` | `string` |
-| `labels` | `Label[]` |
-| `url` | `string` |
+| Property | Type | Description |
+|----------|------|-------------|
+| `id` | `string` | Task identifier |
+| `name` | `string` | Task name |
+| `description` | `string` | Task description |
+| `status` | `string` | Current status name |
+| `projectId` | `string` | Parent project ID |
+| `labels` | `string[]` | Label names |
+| `url` | `string` | Task URL |
 
 | Method | Returns | Description |
 |--------|---------|-------------|
 | `update(params)` | `Task` | Update and return new Task with server state |
 
-Params: `{ name?: string, description?: string, list?: TaskList, labels?: Label[] }`
+Params: `{ name?: string, description?: string, status?: string, labels?: string[] }`
 
-## Switching Providers
+## Concept Mapping
 
-Change the config — zero client code changes:
-
-```typescript
-// Before
-const client = createTaskListClient({ type: "trello" });
-
-// After
-const client = createTaskListClient({ type: "linear" });
-```
+| Abstraction | Trello | Linear |
+|---|---|---|
+| **Project** | Board | Project |
+| Status | List | WorkflowState |
+| **Task** | Card | Issue |
+| Label | Label | IssueLabel |
 
 ## Supported Providers
 
 - **Trello** — fully implemented
-- **Linear** — coming soon
+- **Linear** — fully implemented

package/dist/FullState.d.ts

@@ -1,32 +1,31 @@
-import type { BoardState } from "./BoardState.js";
+import type { Project } from "./Project.js";
 import type { Task } from "./Task.js";
 /**
- * Full state across all boards.
+ * Full state across all projects.
  * Provides chainable finder methods that throw on not found.
  *
  * @example
  * ```typescript
- * const state = await client.getBoards();
- * const list = state.findBoard("Alpha").findList("To Do");
- * const task = await list.createTask("New task");
+ * const state = await client.getProjects();
+ * const project = state.findProject("Alpha");
+ * const task = await project.createTask("New task");
  * ```
  */
 export declare class FullState {
-    readonly boards: readonly BoardState[];
-    constructor(boards: readonly BoardState[]);
+    readonly projects: readonly Project[];
+    constructor(projects: readonly Project[]);
     /**
-     * Find a board by name (case-insensitive partial match).
-     * Returns a BoardState, enabling chaining: `state.findBoard("X").findList("Y")`
-     * @param name - Partial board name to search for
-     * @returns The matching BoardState
-     * @throws Error if no board matches
+     * Find a project by name (case-insensitive partial match).
+     * @param name - Partial project name to search for
+     * @returns The matching Project
+     * @throws Error if no project matches
      */
-    findBoard(name: string): BoardState;
+    findProject(name: string): Project;
     /**
-     * Find a task by ID across all boards
+     * Find a task by ID across all projects
      * @param taskId - Task ID to find
      * @returns The matching Task
-     * @throws Error if no task matches on any board
+     * @throws Error if no task matches on any project
      */
     findTask(taskId: string): Task;
 }

package/dist/FullState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FullState.d.ts","sourceRoot":"","sources":["../src/FullState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;gBAE3B,MAAM,EAAE,SAAS,UAAU,EAAE;IAIzC;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAWnC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAS/B"}
+{"version":3,"file":"FullState.d.ts","sourceRoot":"","sources":["../src/FullState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;gBAE1B,QAAQ,EAAE,SAAS,OAAO,EAAE;IAIxC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWlC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAS/B"}

package/dist/FullState.js

@@ -2,50 +2,49 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FullState = void 0;
 /**
- * Full state across all boards.
+ * Full state across all projects.
  * Provides chainable finder methods that throw on not found.
  *
  * @example
  * ```typescript
- * const state = await client.getBoards();
- * const list = state.findBoard("Alpha").findList("To Do");
- * const task = await list.createTask("New task");
+ * const state = await client.getProjects();
+ * const project = state.findProject("Alpha");
+ * const task = await project.createTask("New task");
  * ```
  */
 class FullState {
-    boards;
-    constructor(boards) {
-        this.boards = boards;
+    projects;
+    constructor(projects) {
+        this.projects = projects;
     }
     /**
-     * Find a board by name (case-insensitive partial match).
-     * Returns a BoardState, enabling chaining: `state.findBoard("X").findList("Y")`
-     * @param name - Partial board name to search for
-     * @returns The matching BoardState
-     * @throws Error if no board matches
+     * Find a project by name (case-insensitive partial match).
+     * @param name - Partial project name to search for
+     * @returns The matching Project
+     * @throws Error if no project matches
      */
-    findBoard(name) {
+    findProject(name) {
         const lower = name.toLowerCase();
-        const board = this.boards.find((b) => b.board.name.toLowerCase().includes(lower));
-        if (!board) {
-            throw new Error(`Board "${name}" not found`);
+        const project = this.projects.find((p) => p.name.toLowerCase().includes(lower));
+        if (!project) {
+            throw new Error(`Project "${name}" not found`);
         }
-        return board;
+        return project;
     }
     /**
-     * Find a task by ID across all boards
+     * Find a task by ID across all projects
      * @param taskId - Task ID to find
      * @returns The matching Task
-     * @throws Error if no task matches on any board
+     * @throws Error if no task matches on any project
      */
     findTask(taskId) {
-        for (const boardState of this.boards) {
-            const task = boardState.tasks.find((t) => t.id === taskId);
+        for (const project of this.projects) {
+            const task = project.tasks.find((t) => t.id === taskId);
             if (task) {
                 return task;
             }
         }
-        throw new Error(`Task "${taskId}" not found on any board`);
+        throw new Error(`Task "${taskId}" not found in any project`);
     }
 }
 exports.FullState = FullState;

package/dist/FullState.js.map

@@ -1 +1 @@
-{"version":3,"file":"FullState.js","sourceRoot":"","sources":["../src/FullState.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;GAUG;AACH,MAAa,SAAS;IACX,MAAM,CAAwB;IAEvC,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,IAAY;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3C,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAc;QACrB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;YAC3D,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,0BAA0B,CAAC,CAAC;IAC7D,CAAC;CACF;AAxCD,8BAwCC"}
+{"version":3,"file":"FullState.js","sourceRoot":"","sources":["../src/FullState.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;GAUG;AACH,MAAa,SAAS;IACX,QAAQ,CAAqB;IAEtC,YAAY,QAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACvC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CACrC,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,aAAa,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAc;QACrB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;YACxD,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,4BAA4B,CAAC,CAAC;IAC/D,CAAC;CACF;AAvCD,8BAuCC"}

package/dist/Project.d.ts

@@ -0,0 +1,42 @@
+import { Task } from "./Task.js";
+import type { CreateTaskOptions, TaskContext } from "./types.js";
+/**
+ * A project (Trello Board, Linear Project) with task creation capability.
+ * Statuses and labels are exposed as human-readable name arrays.
+ */
+export declare class Project {
+    readonly id: string;
+    readonly name: string;
+    readonly url: string;
+    readonly statuses: readonly string[];
+    readonly labels: readonly string[];
+    readonly tasks: readonly Task[];
+    private readonly context;
+    private readonly defaultStatusId;
+    constructor(info: {
+        id: string;
+        name: string;
+        url: string;
+    }, statusEntries: readonly {
+        id: string;
+        name: string;
+    }[], tasks: readonly Task[], labelEntries: readonly {
+        id: string;
+        name: string;
+    }[], context: TaskContext);
+    /**
+     * Create a new task in this project.
+     * @param name - Task name/title
+     * @param options - Optional description, labels (by name), and status (by name)
+     * @returns The created Task
+     */
+    createTask(name: string, options?: CreateTaskOptions): Promise<Task>;
+    /**
+     * Find a task by ID
+     * @param taskId - Task ID to find
+     * @returns The matching Task
+     * @throws Error if no task matches
+     */
+    findTask(taskId: string): Task;
+}
+//# sourceMappingURL=Project.d.ts.map

package/dist/Project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../src/Project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;GAGG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAGvC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAC/C,aAAa,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,EACtD,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,YAAY,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,EACrD,OAAO,EAAE,WAAW;IAYtB;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1E;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAO/B"}

package/dist/Project.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Project = void 0;
+const Task_js_1 = require("./Task.js");
+/**
+ * A project (Trello Board, Linear Project) with task creation capability.
+ * Statuses and labels are exposed as human-readable name arrays.
+ */
+class Project {
+    id;
+    name;
+    url;
+    statuses;
+    labels;
+    tasks;
+    context;
+    defaultStatusId;
+    constructor(info, statusEntries, tasks, labelEntries, context) {
+        this.id = info.id;
+        this.name = info.name;
+        this.url = info.url;
+        this.statuses = statusEntries.map((s) => s.name);
+        this.labels = labelEntries.map((l) => l.name);
+        this.tasks = tasks;
+        this.context = context;
+        this.defaultStatusId = statusEntries[0]?.id ?? "";
+    }
+    /**
+     * Create a new task in this project.
+     * @param name - Task name/title
+     * @param options - Optional description, labels (by name), and status (by name)
+     * @returns The created Task
+     */
+    async createTask(name, options) {
+        const statusId = options?.status !== undefined && options.status !== ""
+            ? this.context.resolveStatusId(options.status)
+            : this.defaultStatusId;
+        const labelIds = options?.labels
+            ? options.labels.map((n) => this.context.resolveLabelId(n))
+            : undefined;
+        const data = await this.context.createTask({
+            statusId,
+            projectId: this.id,
+            name,
+            description: options?.description,
+            labelIds,
+        });
+        return new Task_js_1.Task(data, this.context);
+    }
+    /**
+     * Find a task by ID
+     * @param taskId - Task ID to find
+     * @returns The matching Task
+     * @throws Error if no task matches
+     */
+    findTask(taskId) {
+        const task = this.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            throw new Error(`Task "${taskId}" not found in project "${this.name}"`);
+        }
+        return task;
+    }
+}
+exports.Project = Project;
+//# sourceMappingURL=Project.js.map

package/dist/Project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Project.js","sourceRoot":"","sources":["../src/Project.ts"],"names":[],"mappings":";;;AAAA,uCAAiC;AAGjC;;;GAGG;AACH,MAAa,OAAO;IACT,EAAE,CAAS;IACX,IAAI,CAAS;IACb,GAAG,CAAS;IACZ,QAAQ,CAAoB;IAC5B,MAAM,CAAoB;IAC1B,KAAK,CAAkB;IAEf,OAAO,CAAc;IACrB,eAAe,CAAS;IAEzC,YACE,IAA+C,EAC/C,aAAsD,EACtD,KAAsB,EACtB,YAAqD,EACrD,OAAoB;QAEpB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAA2B;QACxD,MAAM,QAAQ,GACZ,OAAO,EAAE,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;YACpD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QAE3B,MAAM,QAAQ,GAAG,OAAO,EAAE,MAAM;YAC9B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACzC,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,IAAI;YACJ,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,IAAI,cAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAc;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,2BAA2B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAnED,0BAmEC"}

package/dist/Task.d.ts

@@ -1,20 +1,21 @@
-import type { Label, TaskData, TaskOperations, UpdateTaskParams } from "./types.js";
+import type { TaskContext, TaskData, UpdateTaskParams } from "./types.js";
 /**
- * A task (Trello Card, Linear Issue) with update capability
+ * A task (Trello Card, Linear Issue) with update capability.
+ * Status and labels are exposed as human-readable names.
  */
 export declare class Task {
     readonly id: string;
     readonly name: string;
     readonly description: string;
-    readonly listId: string;
-    readonly boardId: string;
-    readonly labels: readonly Label[];
+    readonly status: string;
+    readonly projectId: string;
+    readonly labels: readonly string[];
     readonly url: string;
-    private readonly operations;
-    constructor(data: TaskData, operations: TaskOperations);
+    private readonly context;
+    constructor(data: TaskData, context: TaskContext);
     /**
      * Update this task. Returns a new Task with the updated data.
-     * @param params - Fields to update
+     * @param params - Fields to update. Status and labels are referenced by name.
      * @returns New Task reflecting the server state after update
      */
     update(params: UpdateTaskParams): Promise<Task>;

package/dist/Task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../src/Task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,QAAQ,EACR,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;gBAEhC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc;IAWtD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtD"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../src/Task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;GAGG;AACH,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW;IAWhD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAetD"}

package/dist/Task.js

@@ -2,35 +2,46 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Task = void 0;
 /**
- * A task (Trello Card, Linear Issue) with update capability
+ * A task (Trello Card, Linear Issue) with update capability.
+ * Status and labels are exposed as human-readable names.
  */
 class Task {
     id;
     name;
     description;
-    listId;
-    boardId;
+    status;
+    projectId;
     labels;
     url;
-    operations;
-    constructor(data, operations) {
+    context;
+    constructor(data, context) {
         this.id = data.id;
         this.name = data.name;
         this.description = data.description;
-        this.listId = data.listId;
-        this.boardId = data.boardId;
-        this.labels = data.labels;
+        this.status = context.resolveStatusName(data.statusId);
+        this.projectId = data.projectId;
+        this.labels = data.labels.map((l) => l.name);
         this.url = data.url;
-        this.operations = operations;
+        this.context = context;
     }
     /**
      * Update this task. Returns a new Task with the updated data.
-     * @param params - Fields to update
+     * @param params - Fields to update. Status and labels are referenced by name.
      * @returns New Task reflecting the server state after update
      */
     async update(params) {
-        const data = await this.operations.updateTask(this.id, params.name, params.description, params.list?.id, params.labels?.map((l) => l.id));
-        return new Task(data, this.operations);
+        const data = await this.context.updateTask({
+            taskId: this.id,
+            name: params.name,
+            description: params.description,
+            statusId: params.status !== undefined && params.status !== ""
+                ? this.context.resolveStatusId(params.status)
+                : undefined,
+            labelIds: params.labels
+                ? params.labels.map((n) => this.context.resolveLabelId(n))
+                : undefined,
+        });
+        return new Task(data, this.context);
     }
 }
 exports.Task = Task;

package/dist/Task.js.map

@@ -1 +1 @@
-{"version":3,"file":"Task.js","sourceRoot":"","sources":["../src/Task.ts"],"names":[],"mappings":";;;AAOA;;GAEG;AACH,MAAa,IAAI;IACN,EAAE,CAAS;IACX,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,MAAM,CAAmB;IACzB,GAAG,CAAS;IAEJ,UAAU,CAAiB;IAE5C,YAAY,IAAc,EAAE,UAA0B;QACpD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAC3C,IAAI,CAAC,EAAE,EACP,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,IAAI,EAAE,EAAE,EACf,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChC,CAAC;QACF,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;CACF;AArCD,oBAqCC"}
+{"version":3,"file":"Task.js","sourceRoot":"","sources":["../src/Task.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,IAAI;IACN,EAAE,CAAS;IACX,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,MAAM,CAAoB;IAC1B,GAAG,CAAS;IAEJ,OAAO,CAAc;IAEtC,YAAY,IAAc,EAAE,OAAoB;QAC9C,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACzC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EACN,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;gBACjD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC7C,CAAC,CAAC,SAAS;YACf,QAAQ,EAAE,MAAM,CAAC,MAAM;gBACrB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;gBAC1D,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AA1CD,oBA0CC"}

package/dist/TaskListClient.d.ts

@@ -1,5 +1,5 @@
-import type { BoardState } from "./BoardState.js";
 import type { FullState } from "./FullState.js";
+import type { Project } from "./Project.js";
 import type { Task } from "./Task.js";
 import type { TaskListConfig } from "./types.js";
 /**
@@ -10,21 +10,29 @@ export declare abstract class TaskListClient {
     protected readonly config: TaskListConfig;
     constructor(config: TaskListConfig);
     /**
-     * Get full state for all boards (boards, lists, tasks, labels)
+     * Get all projects with full state (statuses, tasks, labels)
      * @returns FullState with chainable finders
      */
-    abstract getBoards(): Promise<FullState>;
+    abstract getProjects(): Promise<FullState>;
     /**
-     * Get full state for a single board (lists, tasks, labels)
-     * @param boardId - Board identifier
-     * @returns BoardState with chainable finders
+     * Get a single project with full state
+     * @param projectId - Project identifier
+     * @returns Project with task creation and lookup
      */
-    abstract getBoard(boardId: string): Promise<BoardState>;
+    abstract getProject(projectId: string): Promise<Project>;
     /**
      * Get a single task by ID
      * @param taskId - Task identifier
      * @returns Task with update capability
      */
     abstract getTask(taskId: string): Promise<Task>;
+    /**
+     * Find a project by name (case-insensitive partial match).
+     * Convenience method that fetches all projects then finds by name.
+     * @param name - Partial project name to search for
+     * @returns The matching Project
+     * @throws Error if no project matches
+     */
+    findProject(name: string): Promise<Project>;
 }
 //# sourceMappingURL=TaskListClient.d.ts.map

package/dist/TaskListClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TaskListClient.d.ts","sourceRoot":"","sources":["../src/TaskListClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,8BAAsB,cAAc;IACtB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc;gBAAtB,MAAM,EAAE,cAAc;IAErD;;;OAGG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAEvD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD"}
+{"version":3,"file":"TaskListClient.d.ts","sourceRoot":"","sources":["../src/TaskListClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,8BAAsB,cAAc;IACtB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc;gBAAtB,MAAM,EAAE,cAAc;IAErD;;;OAGG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAExD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIlD"}

package/dist/TaskListClient.js

@@ -10,6 +10,17 @@ class TaskListClient {
     constructor(config) {
         this.config = config;
     }
+    /**
+     * Find a project by name (case-insensitive partial match).
+     * Convenience method that fetches all projects then finds by name.
+     * @param name - Partial project name to search for
+     * @returns The matching Project
+     * @throws Error if no project matches
+     */
+    async findProject(name) {
+        const state = await this.getProjects();
+        return state.findProject(name);
+    }
 }
 exports.TaskListClient = TaskListClient;
 //# sourceMappingURL=TaskListClient.js.map

package/dist/TaskListClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskListClient.js","sourceRoot":"","sources":["../src/TaskListClient.ts"],"names":[],"mappings":";;;AAKA;;;GAGG;AACH,MAAsB,cAAc;IACH;IAA/B,YAA+B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;CAqB1D;AAtBD,wCAsBC"}
+{"version":3,"file":"TaskListClient.js","sourceRoot":"","sources":["../src/TaskListClient.ts"],"names":[],"mappings":";;;AAKA;;;GAGG;AACH,MAAsB,cAAc;IACH;IAA/B,YAA+B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAsBzD;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAlCD,wCAkCC"}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export { type Board, type Label, type CreateTaskOptions, type UpdateTaskParams, type TrelloConfig, type LinearConfig, type TaskListConfig, type Provider, } from "./types.js";
+export { type CreateTaskOptions, type UpdateTaskParams, type TrelloConfig, type LinearConfig, type TaskListConfig, type Provider, } from "./types.js";
 export { TaskListClient } from "./TaskListClient.js";
 export { Task } from "./Task.js";
-export { TaskList } from "./TaskList.js";
-export { BoardState } from "./BoardState.js";
+export { Project } from "./Project.js";
 export { FullState } from "./FullState.js";
 export { TrelloTaskListClient } from "./trello";
+export { LinearTaskListClient } from "./linear";
 import type { TaskListClient } from "./TaskListClient.js";
 import type { TaskListConfig } from "./types.js";
 /**
@@ -15,11 +15,13 @@ import type { TaskListConfig } from "./types.js";
  * // Trello (uses env vars by default)
  * const client = createTaskListClient({ type: 'trello' });
  *
+ * // Linear (team-scoped)
+ * const client = createTaskListClient({ type: 'linear', teamId: 'team-uuid' });
+ *
  * // Usage
- * const state = await client.getBoards();
- * const list = state.findBoard("My Board").findList("To Do");
- * const task = await list.createTask("New task");
- * await task.update({ name: "Updated task" });
+ * const project = await client.findProject("My Project");
+ * const task = await project.createTask("New task");
+ * await task.update({ status: "done" });
  * ```
  */
 export declare function createTaskListClient(config: TaskListConfig): TaskListClient;