@robbeverhelst/do 1.178.0 → 1.180.0

package/dist/do.js

@@ -19327,6 +19327,22 @@ var restAreaInputSchema = object({
   until: exports_iso.date(),
   habits: _enum2(["keep", "pause"]).default("keep")
 }).strict();
+var areaToProjectInputSchema = object({ projectId: ulidSchema, intoAreaId: ulidSchema.nullable() }).strict();
+var areaMovedSchema = object({
+  tasks: array(string2()),
+  projects: array(string2()),
+  habits: array(string2()),
+  routines: array(string2()),
+  notes: array(string2()),
+  collectionItems: array(string2())
+});
+var areaToProjectResultSchema = object({
+  areaId: string2(),
+  projectId: string2(),
+  intoAreaId: string2().nullable(),
+  moved: areaMovedSchema
+});
+var undoAreaToProjectInputSchema = object({ projectId: ulidSchema, moved: areaMovedSchema }).strict();
 
 // ../../packages/schema/src/presets/facets.ts
 var PANTRY_DISPLAY_KIND = "pantry";
@@ -21624,7 +21640,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.178.0";
+var VERSION = "1.180.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -23170,6 +23186,80 @@ var COMMAND_SPECS = [
     returns: "EchoThreadSummary",
     notes: "For later and Silent posts never push. The home thread and conversations start at all, a standing thread you add at needs_you."
   },
+  {
+    path: ["echo", "threads", "add"],
+    summary: "Add a standing thread of your own (Build, Business), pinned under the agent's.",
+    args: [{ name: "title", required: true, description: "Its name (`Build`)." }],
+    flags: [
+      {
+        name: "slug",
+        type: "string",
+        description: "What the agent and scripts address it by (default: from the title)."
+      },
+      { name: "areas", type: "string", description: "Area ids it covers, comma-separated." }
+    ],
+    scopes: ["agents:write"],
+    returns: "EchoThread",
+    notes: "A slug you already use is a 409; an archived thread's slug brings that thread back. The agent can post to it with `do echo post --thread <slug>`."
+  },
+  {
+    path: ["echo", "thread", "add"],
+    summary: "Same as `echo threads add`.",
+    args: [{ name: "title", required: true, description: "Its name (`Build`)." }],
+    flags: [
+      {
+        name: "slug",
+        type: "string",
+        description: "What the agent and scripts address it by (default: from the title)."
+      },
+      { name: "areas", type: "string", description: "Area ids it covers, comma-separated." }
+    ],
+    scopes: ["agents:write"],
+    returns: "EchoThread"
+  },
+  {
+    path: ["echo", "threads", "rename"],
+    summary: "Rename one of your agent threads.",
+    args: [
+      { name: "thread", required: true, description: "Its id, or a standing thread's slug." },
+      { name: "title", required: true, description: "The new name." }
+    ],
+    flags: [],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary"
+  },
+  {
+    path: ["echo", "threads", "link"],
+    summary: "Set the Areas a standing thread covers, so its brief knows where to look.",
+    args: [{ name: "thread", required: true, description: "Its id, or its slug." }],
+    flags: [
+      {
+        name: "areas",
+        type: "string",
+        description: "Area ids, comma-separated (replaces the list; '' unlinks them all)."
+      }
+    ],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary",
+    notes: "Links only: a thread never becomes an Area."
+  },
+  {
+    path: ["echo", "threads", "archive"],
+    summary: "Archive one of your agent threads.",
+    args: [{ name: "thread", required: true, description: "Its id, or a standing thread's slug." }],
+    flags: [],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary",
+    notes: "It leaves your list and its slug no longer reaches it. The home thread (the agent's) can't be archived."
+  },
+  {
+    path: ["echo", "threads", "restore"],
+    summary: "Bring an archived thread back.",
+    args: [{ name: "id", required: true, description: "Thread ULID." }],
+    flags: [],
+    scopes: ["agents:write"],
+    returns: "EchoThreadSummary"
+  },
   {
     path: ["settings", "get"],
     summary: "Show the caller's settings for the Space.",
@@ -23548,6 +23638,36 @@ var COMMAND_SPECS = [
     returns: "UserSettings",
     notes: "Reads then patches settings.pinnedAreaIds."
   },
+  {
+    path: ["areas", "make-project"],
+    summary: "Make an Area that finishes a Project (prints the receipt for undo).",
+    args: [{ name: "id", required: true, description: "Area ULID." }],
+    flags: [
+      {
+        name: "into",
+        type: "string",
+        description: "The Area to file the new Project under (none when left out)."
+      }
+    ],
+    scopes: ["areas:write", "projects:write"],
+    returns: "AreaToProjectResult",
+    notes: "POST /api/v1/areas/{id}/to-project (Areas 8). The Project takes the Area's title; its loose tasks go inside, its Projects, habits, routines and notes move beside it, and the Area is archived. An agent proposes this; only the member runs it."
+  },
+  {
+    path: ["areas", "undo-make-project"],
+    summary: "Undo `areas make-project` from its receipt.",
+    args: [{ name: "id", required: true, description: "Area ULID." }],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: "The receipt as JSON: { projectId, moved } from `areas make-project`."
+      }
+    ],
+    scopes: ["areas:write", "projects:write"],
+    returns: "AreaView",
+    notes: "POST /api/v1/areas/{id}/to-project/undo (Areas 8). Everything comes back; the Project goes."
+  },
   {
     path: ["places", "import"],
     summary: "Import the rooms of the house once from Gaard's house.json.",
@@ -25727,6 +25847,44 @@ var HANDLERS = {
     }),
     render: renderRecord
   }),
+  "echo threads add": echoThreadAdd,
+  "echo thread add": echoThreadAdd,
+  "echo threads rename": async ({ args, requireClient }) => {
+    const client = requireClient();
+    const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+    const title = args.slice(1).join(" ").trim();
+    if (!title)
+      throw usageError("missing required argument: <title>");
+    return { data: await client.patch(`/echo/threads/${id}`, { title }), render: renderRecord };
+  },
+  "echo threads link": async ({ args, flags, requireClient }) => {
+    const client = requireClient();
+    const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+    const areas = flagString(flags, "areas");
+    if (areas === undefined)
+      throw usageError("pass --areas <id,id> (--areas '' unlinks them all)");
+    const areaIds = splitList(areas);
+    return {
+      data: await client.patch(`/echo/threads/${id}`, { areaIds }),
+      render: renderRecord
+    };
+  },
+  "echo threads archive": async ({ args, requireClient }) => {
+    const client = requireClient();
+    const id = await echoThreadId(client, requireArg(args, 0, "thread"));
+    return {
+      data: await client.patch(`/echo/threads/${id}`, { archived: true }),
+      render: renderRecord
+    };
+  },
+  "echo threads restore": async ({ args, requireClient }) => {
+    const client = requireClient();
+    const id = requireArg(args, 0, "thread id");
+    return {
+      data: await client.patch(`/echo/threads/${id}`, { archived: false }),
+      render: renderRecord
+    };
+  },
   "settings get": async ({ requireClient }) => ({
     data: await requireClient().get("/settings"),
     render: renderRecord
@@ -25965,6 +26123,29 @@ var HANDLERS = {
   },
   "areas pin": async ({ args, requireClient }) => setAreaPinned(args, requireClient, true),
   "areas unpin": async ({ args, requireClient }) => setAreaPinned(args, requireClient, false),
+  "areas make-project": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "area id");
+    const input = parseInput(areaToProjectInputSchema, {
+      projectId: ulid3(),
+      intoAreaId: flagString(flags, "into") ?? null
+    });
+    return {
+      data: await requireClient().post(`/areas/${id}/to-project`, input),
+      render: renderRecord
+    };
+  },
+  "areas undo-make-project": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "area id");
+    const receipt = readDataFlag(flags);
+    const input = parseInput(undoAreaToProjectInputSchema, {
+      projectId: receipt.projectId,
+      moved: receipt.moved
+    });
+    return {
+      data: await requireClient().post(`/areas/${id}/to-project/undo`, input),
+      render: renderRecord
+    };
+  },
   "places import": async ({ args, flags, requireClient }) => {
     const path = requireArg(args, 0, "house.json path");
     let file;
@@ -26224,6 +26405,35 @@ function standardLink(flags) {
     return { kind: "metric", key: metric };
   return null;
 }
+async function echoThreadAdd({ args, flags, requireClient }) {
+  const title = args.join(" ").trim();
+  if (!title)
+    throw usageError("missing required argument: <title>");
+  const slug = flagString(flags, "slug");
+  const areas = flagString(flags, "areas");
+  return {
+    data: await requireClient().post("/echo/threads/standing", {
+      title,
+      ...slug ? { slug } : {},
+      ...areas === undefined ? {} : { areaIds: splitList(areas) }
+    }),
+    render: renderEchoThread
+  };
+}
+async function echoThreadId(client, ref) {
+  if (ULID.test(ref))
+    return ref;
+  const threads = await client.get("/echo/threads", {
+    query: { limit: "50" }
+  });
+  const found = threads.find((t) => t.slug === ref);
+  if (!found)
+    throw usageError(`no thread \`${ref}\` (see \`do echo threads list\`)`);
+  return found.id;
+}
+function splitList(value) {
+  return value.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
+}
 function requireArg(args, index, name) {
   const value = args[index];
   if (value === undefined || value.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.178.0",
+  "version": "1.180.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",