@harborppm/cli 0.35.0 → 0.36.0

package/README.md

@@ -132,10 +132,14 @@ harbor note PROJECT ["NOTE"] [--opens DATE|--milestone NAME|--off-track]
 harbor limit PROJECT [COLUMN N|none]
 harbor handover PERSON [--to NAME] [--until DATE] [--note TEXT] [--keep ID,ID] [--confirm]
 harbor handback PERSON
+harbor agent [--agent NAME]
+harbor agent report TASK "WHAT YOU DID" [--start] [--agent NAME]
 ```
 
 `harbor handover Priya` lists everything Priya carries (open tasks, sign-offs waiting on her, risks and issues she owns, projects and programs she leads) and who should take each, from who has room this week. Nothing moves until you add `--confirm`. `--until DATE` is for time away: Priya shows as away on People, and `harbor handback Priya` gives back whatever is still with whoever took it. `--note` goes with each task and risk as a comment.
 
+Agents on the crew: put an AI app on People with Add an agent and assign it tasks like anyone else. An agent working through the CLI (Claude Code, say) runs `harbor agent` for its tasks, in progress first, with their notes, checklists and latest comments. When it's done, `harbor agent report RR-4 "Drafted 12 questions; two need Dana"` adds its note as the agent's comment and moves the task to In review for a person to check. An agent never marks its own work Done.
+
 `harbor limit RR` prints how many tasks each of a board's columns takes at once; `harbor limit RR doing 8` changes one (1 to 20, or `none` for no limit), if you own the harbor. `harbor projects --json` carries each board's `limits` too.
 
 `harbor premortem` runs a pre-mortem with your crew: `--start` asks everyone "it's after the end date and this project failed: what happened?", each person adds answers alone for five minutes, and then the answers show together on the project's Risks & issues tab, where each becomes a risk in one click. On its own it prints the question and the answers you can see. Once a project is Done, `harbor voyage` prints its voyage log (planned against actual dates, the biggest slips, the risks that came true, who closed the most, and the crew's lines) and adds yours. `harbor note` leaves a note for later on a project: it stays sealed (the crew sees only that it's there and who left it) until its day, until one of the program's milestones is reached, or until the project turns Off track, and then it opens at the top of the project and in the brief.

package/dist/app.mjs

@@ -10798,7 +10798,7 @@ function hierarchySlice({ get, write }) {
 			const name = rows.portfolios?.[0]?.name ?? rows.programs?.[0]?.name ?? rows.projects?.[0]?.name;
 			if (name) get().log(`put back “${name}”`);
 		},
-		importRows: (rows) => {
+		importRows: (rows, from = "a spreadsheet") => {
 			const state = get();
 			const have = (current) => new Set(current.map((r) => r.id));
 			const add = (current, more) => {
@@ -10809,10 +10809,11 @@ function hierarchySlice({ get, write }) {
 				programs: add(state.programs, rows.programs),
 				projects: add(state.projects, rows.projects),
 				tasks: add(state.tasks, rows.tasks),
-				people: add(state.people, rows.people)
+				people: add(state.people, rows.people),
+				raidItems: add(state.raidItems, rows.raidItems)
 			});
 			const n = rows.tasks?.length ?? 0;
-			get().log(`imported ${n} task${n === 1 ? "" : "s"} from a spreadsheet`);
+			get().log(`imported ${n} task${n === 1 ? "" : "s"} from ${from}`);
 		},
 		dropRows: (ids) => {
 			const state = get();
@@ -10820,7 +10821,8 @@ function hierarchySlice({ get, write }) {
 				programs: new Set(ids.programs ?? []),
 				projects: new Set(ids.projects ?? []),
 				tasks: new Set(ids.tasks ?? []),
-				people: new Set(ids.people ?? [])
+				people: new Set(ids.people ?? []),
+				raidItems: new Set(ids.raidItems ?? [])
 			};
 			const tasks = state.tasks.filter((r) => !gone.tasks.has(r.id));
 			if (gone.people.size) {
@@ -10831,6 +10833,7 @@ function hierarchySlice({ get, write }) {
 				projects: state.projects.filter((r) => !gone.projects.has(r.id)),
 				tasks,
 				people: gone.people.size ? state.people.filter((r) => !gone.people.has(r.id)) : state.people,
+				raidItems: gone.raidItems.size ? state.raidItems.filter((r) => !gone.raidItems.has(r.id)) : state.raidItems,
 				selectedTaskId: gone.tasks.has(state.selectedTaskId ?? "") ? null : state.selectedTaskId
 			});
 		},
@@ -11148,6 +11151,27 @@ function tasksSlice({ set, get, write }) {
 				else get().log(`commented on “${task.title}”`, `/projects/${task.projectId}`);
 			}
 		},
+		agentUpdate: (agentId, taskId, body, status, opts) => {
+			const task = get().tasks.find((t) => t.id === taskId);
+			const text = body.trim();
+			if (!task || !text) return;
+			if (task.status !== status) get().moveTask(taskId, status, { allowOverCap: opts?.allowOverCap });
+			const at = stamp();
+			write({
+				comments: [...get().comments, {
+					id: uid("c"),
+					taskId,
+					authorId: agentId,
+					body: text,
+					createdAt: at,
+					mentionedIds: parseMentions(text, get().people).filter((id) => id !== agentId)
+				}],
+				people: get().people.map((p) => p.id === agentId ? {
+					...p,
+					lastSeenAt: at
+				} : p)
+			});
+		},
 		updateComment: (id, body) => {
 			const comment = get().comments.find((c) => c.id === id);
 			if (!comment || comment.authorId !== get().currentUserId) return;
@@ -11238,6 +11262,13 @@ function tasksSlice({ set, get, write }) {
 			for (const id of ids) have.add(id);
 			set({ readPingIds: [...have] });
 		},
+		tickVoyage: (ids) => {
+			const tick = new Set(ids);
+			const ticked = get().tasks.filter((t) => tick.has(t.id) && t.status !== "done");
+			if (ticked.length === 0) return;
+			write({ tasks: get().tasks.map((t) => tick.has(t.id) && t.status !== "done" ? withStatus(t, "done") : t) });
+			for (const t of ticked) get().log(`ticked off “${t.title}” on First voyage`, `/projects/${t.projectId}`);
+		},
 		toggleFocus: (taskId) => {
 			const personId = get().currentUserId;
 			const date = todayISO();
@@ -11688,6 +11719,23 @@ function peopleSpendSlice({ set, get, write }) {
 			get().log(`handed ${person.name}’s work back`, "/people");
 			return applied.moved.length;
 		},
+		addAgent: (a) => {
+			const id = uid("p");
+			const row = {
+				id,
+				name: a.name.trim() || "Claude",
+				role: "Agent",
+				initials: "AI",
+				swatch: a.swatch,
+				location: "",
+				kind: "agent",
+				addedById: get().currentUserId,
+				lastSeenAt: null
+			};
+			set({ people: [...get().people, row] });
+			get().log(`put ${row.name} on the crew as an agent`, "/people");
+			return id;
+		},
 		updatePerson: (id, patch) => {
 			write({ people: get().people.map((p) => p.id === id ? {
 				...p,

package/lib/cli.mjs

@@ -29,6 +29,7 @@ import {
   notesText,
   voyageText,
   handoverText,
+  agentWorkText,
   raidList,
   programTree,
   projectList,
@@ -125,6 +126,11 @@ export const HELP = `harbor: Harbor from the terminal
                          [--keep ID,ID] [--confirm]
                                               hand someone's work to the crew
   harbor handback PERSON                      give it back after time away
+  harbor agent [--agent NAME]                 the tasks given to an AI agent on
+                                              the crew, in the order to do them
+  harbor agent report TASK "WHAT YOU DID" [--start] [--agent NAME]
+                                              the agent's note; moves the task
+                                              to In review (--start: doing)
 
   Every command takes --json, and --harbor NAME when you're in more than one
   harbor (or set one with harbor use). harbor help COMMAND shows just that one.
@@ -434,6 +440,33 @@ const DETAIL = {
     "",
     '  PERSON is a name, an id, or "me".',
   ],
+  handback: [
+    "  harbor handback PERSON                 writes, straight away: gives back",
+    "                                         what was handed over for their time",
+    "                                         away and is still with whoever took",
+    "                                         it, and stops showing them as away",
+    "",
+    "  Anything someone else has since taken, finished or closed stays where it",
+    "  is. If PERSON isn't marked away, it says so and changes nothing.",
+    "  harbor handover PERSON --until DATE is what marks someone away.",
+    "",
+    '  PERSON is a name, an id, or "me".',
+  ],
+  agent: [
+    "  harbor agent                           reads the tasks people gave the crew's",
+    "                                         agent (an AI crew member on People),",
+    "                                         in progress first, with their notes",
+    '  harbor agent report TASK "TEXT"        writes: the agent\'s note on the task,',
+    "                                         and moves it to In review for a person",
+    "                                         to check",
+    '  harbor agent report TASK "TEXT" --start',
+    "                                         writes: the note, and moves it to",
+    "                                         In progress",
+    "",
+    "  --agent NAME picks the agent when the crew has more than one. An agent",
+    "  never marks its own work Done; a person does, on the website or in the",
+    "  terminal app.",
+  ],
   voyage: [
     "  harbor voyage PROJECT                  reads a Done project's voyage log",
     '  harbor voyage PROJECT "YOUR LINE"      writes: adds or changes your line in it',
@@ -1461,6 +1494,25 @@ export async function run(argv, io = {}) {
         },
       );
     }
+    case "agent": {
+      const { positionals, values, harbor } = parse(spec(["start"], ["agent"]));
+      if (positionals[0] !== "report") {
+        none(positionals);
+        return call("agent_work", { harbor, agent: values.agent }, agentWorkText);
+      }
+      const [, task, ...words] = positionals;
+      const note = words.join(" ").trim();
+      if (!task || !note)
+        throw new HarborError(
+          'Give the task and what the agent did: harbor agent report RR-4 "Drafted it".',
+        );
+      return call(
+        "agent_update",
+        { harbor, task, note, status: values.start ? "doing" : "review", agent: values.agent },
+        (r) =>
+          `${r.updated.key ?? r.updated.title} is ${r.updated.status === "review" ? "in review for a person to check" : "in progress"}, with ${r.commentedAs}'s note.`,
+      );
+    }
     case "handback": {
       const { positionals, harbor } = parse(spec());
       const person = positionals.join(" ").trim();

package/lib/format.mjs

@@ -412,9 +412,19 @@ export function handoverText(r, { confirmHint = true } = {}) {
       group = i.group;
       lines.push("", `${group}:`);
     }
+    const due = i.due && i.kind !== "project" && i.kind !== "program" ? ` (${i.due})` : "";
+    lines.push(`  ${i.what}${due}${i.to ? `  → ${i.to}` : ""}`);
+  }
+  if (r.nobodyToTake) {
     lines.push(
-      `  ${i.what}${i.due && i.kind !== "project" && i.kind !== "program" ? ` (${i.due})` : ""}  → ${i.to ?? "nobody yet"}`,
+      "",
+      `${r.nobodyToTake} Invite someone with harbor invite EMAIL, then run this again.`,
     );
+    if (confirmHint)
+      lines.push(
+        `Until then, --confirm moves nothing; with --until DATE it only marks ${r.person} as away.`,
+      );
+    return lines.join("\n");
   }
   const room = (r.takers ?? []).filter((t) => t.note).map((t) => `${t.who} ${t.note}`);
   if (room.length) lines.push("", `This week: ${room.join(", ")}.`);
@@ -425,3 +435,32 @@ export function handoverText(r, { confirmHint = true } = {}) {
     );
   return lines.join("\n");
 }
+
+/** agent_work: the agent's tasks in the order to do them, then what waits on a person. */
+export function agentWorkText(r) {
+  if (!r.agent) return r.note;
+  const lines = [`Work for ${r.agent}${r.addedBy ? ` (added by ${r.addedBy})` : ""}`];
+  if (!r.tasks?.length) lines.push("", "Nothing to do: no open tasks are assigned to it.");
+  for (const t of r.tasks ?? []) {
+    const bits = [t.status === "doing" ? "in progress" : t.status, t.priority];
+    if (t.due) bits.push(`due ${t.due}`);
+    lines.push(
+      "",
+      `${t.key ?? t.id}  ${t.title}  (${bits.join(", ")}${t.project ? `, ${t.project}` : ""})`,
+    );
+    if (t.notes) lines.push(...t.notes.split("\n").map((l) => `    ${l}`));
+    for (const c of t.checklist ?? []) lines.push(`    [${c.done ? "x" : " "}] ${c.step}`);
+    for (const c of t.comments ?? []) lines.push(`    ${c.author ?? "Someone"}: ${c.body}`);
+  }
+  if (r.total > (r.tasks ?? []).length) lines.push("", `…and ${r.total - r.tasks.length} more.`);
+  if (r.forReview?.length)
+    lines.push(
+      "",
+      `Waiting for a person to check: ${r.forReview.map((t) => t.key ?? t.title).join(", ")}.`,
+    );
+  lines.push(
+    "",
+    'When a task is done, harbor agent report TASK "WHAT YOU DID" moves it to In review for a person to check.',
+  );
+  return lines.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborppm/cli",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Harbor from the terminal: a full-screen app with everything, plus commands for scripts and agents.",
   "keywords": [
     "harbor",