@webappwiz/arbor 0.0.29 → 0.0.31

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webappwiz/arbor",
-	"version": "0.0.29",
+	"version": "0.0.31",
 	"description": "Runs several AI coding agents on one repository at once, each in its own git worktree",
 	"license": "MIT",
 	"author": "Jared Johnson",
@@ -20,7 +20,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"webappwiz": "^0.0.29",
+		"webappwiz": "^0.0.31",
 		"zod": "^4.4.3"
 	},
 	"main": "./index.js",

package/snapshot.d.ts

@@ -9,6 +9,8 @@ import type { WorktreeService } from "./worktree-service.js";
 export interface Snapshot {
     /** The repository's directory name, so a page among many says whose it is. */
     repo: string;
+    /** Where the repository sits, with the home directory as `~`. */
+    path: string;
     /** Past this age a todo is offered for removal rather than recommended. */
     todoStalenessMs: number;
     todos: TodoState[];
@@ -18,10 +20,12 @@ export interface Snapshot {
  * Reads the whole repo the way the CLI's read commands do. Takes no lease, so
  * the page can sit open on a live tree without disturbing the agent in it.
  */
-export declare function snapshot({ service, todos, fs, }: {
+export declare function snapshot({ service, todos, fs, home, }: {
     service: WorktreeService;
     todos: Todos;
     fs: Fs;
+    /** The home directory to show as `~`, when there is one. */
+    home?: string;
 }): Promise<Snapshot>;
 /**
  * What the page is actually showing, minus the fields that move on their own.

package/todo.d.ts

@@ -18,7 +18,16 @@ export interface TodoState {
     takenBy: string | null;
     /** Absolute paths of the files attached, in `todos/<id>/`. */
     files: string[];
+    /** What it belongs to, sorted: the areas or goals it adds up to with others. */
+    tags: string[];
 }
+/** A tag in use, with how many todos have it. */
+export interface TagState {
+    tag: string;
+    todos: number;
+}
+/** `tags` deduped and sorted, refusing any not written the one way. */
+export declare function tagList(tags: string[]): string[];
 /** A todo's words, place or files changed: new ones added, some of the old kept. */
 export interface TodoChange {
     /** A new line; the old one stays when this is absent. */
@@ -31,6 +40,8 @@ export interface TodoChange {
     files?: Attachment[];
     /** The paths of the files it has now to keep; absent keeps them all. */
     keep?: string[];
+    /** Its tags from now on; the old stay when this is absent. */
+    tags?: string[];
 }
 /** What a new todo has besides its subject, all of it optional. */
 export interface TodoNew {
@@ -39,6 +50,7 @@ export interface TodoNew {
     files?: Attachment[];
     /** Where it goes in the list, pushing those from there down; the bottom by default. */
     position?: number;
+    tags?: string[];
 }
 /**
  * Work deferred for later: what an agent notes when something outside its
@@ -64,12 +76,13 @@ export declare class Todo {
     /** Puts it back on the list, as when the task that took it is removed. */
     release(): Promise<Todo>;
     get files(): string[];
+    get tags(): string[];
     get attachments(): Attachments;
     /**
      * Says what is left to do in other words, with other files, or higher or
      * lower in the list, keeping its id and history.
      */
-    update({ subject, text, position, files, keep, }: TodoChange): Promise<Todo>;
+    update({ subject, text, position, files, keep, tags, }: TodoChange): Promise<Todo>;
     remove(): Promise<void>;
 }
 /** What `Todos` is stored through; the real filesystem by default. */
@@ -100,7 +113,7 @@ export declare class Todos {
     attachments(id: number): Attachments;
     /** Whether `path` is a file some todo holds, and not a way out of here. */
     owns(path: string): boolean;
-    add(subject: string, from: string | null, { text, files, position }?: TodoNew): Promise<Todo>;
+    add(subject: string, from: string | null, { text, files, position, tags }?: TodoNew): Promise<Todo>;
     /**
      * Top of the list first. A file that will not parse is skipped rather than
      * fatal, and positions are counted again from 1 as they are read, so a
@@ -109,6 +122,8 @@ export declare class Todos {
      */
     all(): Promise<Todo[]>;
     find(id: number): Promise<Todo>;
+    /** Every tag a todo on the list has, by name, with how many have it. */
+    tags(): Promise<TagState[]>;
     /** The todos `task` has taken; what a merge or remove settles. */
     takenBy(task: string): Promise<Todo[]>;
     /**
@@ -150,16 +165,21 @@ export interface Recommendation {
 }
 /**
  * Which todo to take up after `task`: one that came up in it first, since
- * whoever just finished it knows that context best, then the open one highest
+ * whoever just finished it knows that context best, then one sharing a tag
+ * in `settled`, those of the todos it finished, the same area of work, then the open one highest
  * on the list, which is how whoever keeps the list says what matters most.
  * Todos past `staleness` are never recommended, only offered for removal.
  */
-export declare function recommend(todos: Todos, task: string | null, staleness: number): Promise<Recommendation>;
+export declare function recommend(todos: Todos, task: string | null, staleness: number, settled?: string[]): Promise<Recommendation>;
 /** The lines `merge` ends with, or none when there is nothing to say. */
 export declare function recommendation({ next, stale }: Recommendation): string[];
 export interface TodoListOptions {
     /** Print the todos as JSON instead of a table. */
     json?: boolean;
+    /** Only those no task has taken: the ones free to pick up. */
+    open?: boolean;
+    /** Only those with this tag. */
+    tag?: string;
 }
 export interface TodoFileOptions {
     /** Files to attach, relative to the current directory or absolute. */
@@ -170,17 +190,18 @@ export interface TodoAddOptions extends TodoFileOptions {
     text?: string;
     /** Where it goes in the list, 1 at the top; the bottom by default. */
     position?: number;
+    tags?: string[];
 }
 export declare function todoAdd(deps: {
     todos: Todos;
     log: Logger;
     fs: Fs;
     ps: Ps;
-}, subject: string, from: string | null, { text, files, position }?: TodoAddOptions): Promise<Todo>;
+}, subject: string, from: string | null, { text, files, position, tags }?: TodoAddOptions): Promise<Todo>;
 export declare function todoList({ todos, log }: {
     todos: Todos;
     log: Logger;
-}, { json }?: TodoListOptions): Promise<void>;
+}, { json, open, tag }?: TodoListOptions): Promise<void>;
 export interface TodoShowOptions {
     /** Print the todo as JSON instead of prose. */
     json?: boolean;
@@ -199,13 +220,17 @@ export interface TodoUpdateOptions extends TodoFileOptions {
     position?: number;
     /** Attached files to drop, by path or by the name they were stored under. */
     removeFiles?: string[];
+    /** Tags to add. */
+    tags?: string[];
+    /** Tags to drop. */
+    removeTags?: string[];
 }
 export declare function todoUpdate(deps: {
     todos: Todos;
     log: Logger;
     fs: Fs;
     ps: Ps;
-}, id: number, { subject, text, position, files, removeFiles, }?: TodoUpdateOptions): Promise<Todo>;
+}, id: number, { subject, text, position, files, removeFiles, tags, removeTags, }?: TodoUpdateOptions): Promise<Todo>;
 /**
  * Takes up todos for `task` after it started, as when one turns out to be
  * part of the work. Every id is checked before any is taken, so one that is
@@ -228,3 +253,12 @@ export declare function todoRemove({ todos, log }: {
     todos: Todos;
     log: Logger;
 }, id: number): Promise<void>;
+export interface TodoTagsOptions {
+    /** Print the tags as JSON instead of a table. */
+    json?: boolean;
+}
+/** Every tag in use, with how many todos have it: the names to reuse first. */
+export declare function todoTags({ todos, log }: {
+    todos: Todos;
+    log: Logger;
+}, { json }?: TodoTagsOptions): Promise<void>;