@robbeverhelst/do 1.42.0 → 1.44.0

package/dist/do.js

@@ -20012,6 +20012,200 @@ var areaDetailSchema = areaViewSchema.extend({
   routines: exports_external.array(routineViewSchema),
   tasks: exports_external.array(taskViewSchema)
 });
+// ../../packages/schema/src/contracts/modules.ts
+var MODULE_KEYS = [
+  "tasks",
+  "habits",
+  "routines",
+  "challenges",
+  "projects",
+  "areas",
+  "notes",
+  "shopping",
+  "inventory",
+  "meals",
+  "library",
+  "watchlist",
+  "games",
+  "cellar",
+  "places",
+  "music",
+  "contacts",
+  "automations"
+];
+var moduleKeySchema = exports_external.enum(MODULE_KEYS);
+var FEATURE_MODULES = [
+  {
+    key: "today",
+    label: "Today",
+    description: "Your daily dashboard \u2014 always on.",
+    group: "System",
+    defaultEnabled: true,
+    system: true
+  },
+  {
+    key: "inbox",
+    label: "Inbox",
+    description: "Quick capture and triage \u2014 always on.",
+    group: "System",
+    defaultEnabled: true,
+    system: true
+  },
+  {
+    key: "settings",
+    label: "Settings",
+    description: "This screen \u2014 always on.",
+    group: "System",
+    defaultEnabled: true,
+    system: true
+  },
+  {
+    key: "tasks",
+    label: "Tasks",
+    description: "To-dos, due dates, and priorities.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "habits",
+    label: "Habits",
+    description: "Daily routines and streaks.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "routines",
+    label: "Routines",
+    description: "Repeatable checklists you run.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "challenges",
+    label: "Challenges",
+    description: "Time-boxed goals and competitions.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "projects",
+    label: "Projects",
+    description: "Multi-step work with milestones.",
+    group: "Organize",
+    defaultEnabled: true
+  },
+  {
+    key: "areas",
+    label: "Areas",
+    description: "Ongoing life domains (PARA areas).",
+    group: "Organize",
+    defaultEnabled: true
+  },
+  {
+    key: "notes",
+    label: "Notes",
+    description: "Quick notes and documents.",
+    group: "Organize",
+    defaultEnabled: true
+  },
+  {
+    key: "shopping",
+    label: "Shopping",
+    description: "Lists and groceries.",
+    group: "Household",
+    defaultEnabled: true
+  },
+  {
+    key: "inventory",
+    label: "Inventory",
+    description: "Things you own and stock.",
+    group: "Household",
+    defaultEnabled: true
+  },
+  {
+    key: "meals",
+    label: "Meals",
+    description: "Recipes and meal plans.",
+    group: "Household",
+    defaultEnabled: true
+  },
+  {
+    key: "library",
+    label: "Library",
+    description: "Books and things you catalog.",
+    group: "Collections",
+    defaultEnabled: true
+  },
+  {
+    key: "watchlist",
+    label: "Watchlist",
+    description: "Films and shows to watch.",
+    group: "Collections",
+    defaultEnabled: true
+  },
+  {
+    key: "games",
+    label: "Games",
+    description: "Games to play and backlog.",
+    group: "Collections",
+    defaultEnabled: true
+  },
+  {
+    key: "cellar",
+    label: "Cellar",
+    description: "Wines and bottles you keep.",
+    group: "Collections",
+    defaultEnabled: true
+  },
+  {
+    key: "places",
+    label: "Places",
+    description: "Spots to visit and remember.",
+    group: "Collections",
+    defaultEnabled: true
+  },
+  {
+    key: "music",
+    label: "Music",
+    description: "Albums and records to hear.",
+    group: "Collections",
+    defaultEnabled: true
+  },
+  {
+    key: "contacts",
+    label: "Contacts",
+    description: "People and relationships.",
+    group: "People",
+    defaultEnabled: true
+  },
+  {
+    key: "automations",
+    label: "Automations",
+    description: "Trigger \u2192 condition \u2192 action rules.",
+    group: "Manage",
+    defaultEnabled: true
+  }
+];
+var TOGGLEABLE_MODULES = FEATURE_MODULES.filter((m) => !m.system);
+function isModuleKey(value) {
+  return MODULE_KEYS.includes(value);
+}
+function normalizeEnabledModules(keys) {
+  const present = new Set(keys.filter(isModuleKey));
+  return MODULE_KEYS.filter((key) => present.has(key));
+}
+function effectiveEnabledModules(enabled) {
+  const known = normalizeEnabledModules(enabled ?? []);
+  return known.length > 0 ? known : [...MODULE_KEYS];
+}
+function setModuleEnabled(enabled, key, on) {
+  const next = new Set(effectiveEnabledModules(enabled));
+  if (on)
+    next.add(key);
+  else
+    next.delete(key);
+  return MODULE_KEYS.filter((candidate) => next.has(candidate));
+}
 // ../../packages/schema/src/contracts/settings.ts
 var settingsThemeSchema = exports_external.enum(settingsTheme.enumValues);
 var settingsDensitySchema = exports_external.enum(settingsDensity.enumValues);
@@ -20028,7 +20222,7 @@ var updateUserSettingsInputSchema = exports_external.object({
   theme: settingsThemeSchema.optional(),
   density: settingsDensitySchema.optional(),
   accent: settingsAccentSchema.optional(),
-  enabledModules: exports_external.array(exports_external.string().trim().min(1)).optional()
+  enabledModules: exports_external.array(exports_external.string().trim().min(1)).transform(normalizeEnabledModules).optional()
 }).strict();
 // ../../packages/schema/src/contracts/notifications.ts
 var notificationTypeSchema = exports_external.enum(["task_due", "occurrence_due"]);
@@ -23306,7 +23500,7 @@ function parseCapture2(input) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.42.0";
+var VERSION = "1.44.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -23596,6 +23790,102 @@ var ENTITIES = [
       canDelete: true
     }
   },
+  {
+    name: "library",
+    path: "/library",
+    readScope: "collections:read",
+    returns: "ShoppingList",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "collections:write",
+      createSchema: createShoppingListInputSchema,
+      createInput: "CreateShoppingListInput",
+      updateSchema: updateShoppingListInputSchema,
+      updateInput: "UpdateShoppingListInput",
+      canDelete: true
+    }
+  },
+  {
+    name: "watchlist",
+    path: "/watchlist",
+    readScope: "collections:read",
+    returns: "ShoppingList",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "collections:write",
+      createSchema: createShoppingListInputSchema,
+      createInput: "CreateShoppingListInput",
+      updateSchema: updateShoppingListInputSchema,
+      updateInput: "UpdateShoppingListInput",
+      canDelete: true
+    }
+  },
+  {
+    name: "games",
+    path: "/games",
+    readScope: "collections:read",
+    returns: "ShoppingList",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "collections:write",
+      createSchema: createShoppingListInputSchema,
+      createInput: "CreateShoppingListInput",
+      updateSchema: updateShoppingListInputSchema,
+      updateInput: "UpdateShoppingListInput",
+      canDelete: true
+    }
+  },
+  {
+    name: "cellar",
+    path: "/cellar",
+    readScope: "collections:read",
+    returns: "ShoppingList",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "collections:write",
+      createSchema: createShoppingListInputSchema,
+      createInput: "CreateShoppingListInput",
+      updateSchema: updateShoppingListInputSchema,
+      updateInput: "UpdateShoppingListInput",
+      canDelete: true
+    }
+  },
+  {
+    name: "places",
+    path: "/places",
+    readScope: "collections:read",
+    returns: "ShoppingList",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "collections:write",
+      createSchema: createShoppingListInputSchema,
+      createInput: "CreateShoppingListInput",
+      updateSchema: updateShoppingListInputSchema,
+      updateInput: "UpdateShoppingListInput",
+      canDelete: true
+    }
+  },
+  {
+    name: "music",
+    path: "/music",
+    readScope: "collections:read",
+    returns: "ShoppingList",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "collections:write",
+      createSchema: createShoppingListInputSchema,
+      createInput: "CreateShoppingListInput",
+      updateSchema: updateShoppingListInputSchema,
+      updateInput: "UpdateShoppingListInput",
+      canDelete: true
+    }
+  },
   {
     name: "inventory-items",
     path: "/inventory-items",
@@ -23786,6 +24076,57 @@ var COMMAND_SPECS = [
     scopes: ["settings:write"],
     returns: "UserSettings"
   },
+  {
+    path: ["modules", "list"],
+    summary: "List feature-modules and whether each is enabled for the caller.",
+    args: [],
+    flags: [],
+    scopes: ["settings:read"],
+    returns: "ModuleStatus",
+    notes: "Reads enabledModules from GET /api/v1/settings; an empty set means every module is on."
+  },
+  {
+    path: ["modules", "enable"],
+    summary: "Enable a feature-module (surfaces it in nav / quick-add / \u2318K).",
+    args: [{ name: "key", required: true, description: "Module key (see `do modules list`)." }],
+    flags: [],
+    scopes: ["settings:read", "settings:write"],
+    returns: "UserSettings",
+    notes: "Reads then patches settings; only the module visibility list changes."
+  },
+  {
+    path: ["modules", "disable"],
+    summary: "Disable a feature-module (hides its surfaces \u2014 nothing is deleted).",
+    args: [{ name: "key", required: true, description: "Module key (see `do modules list`)." }],
+    flags: [],
+    scopes: ["settings:read", "settings:write"],
+    returns: "UserSettings",
+    notes: "Reads then patches settings; only the module visibility list changes."
+  },
+  {
+    path: ["presets", "list"],
+    summary: "List the preset gallery (key \xB7 name \xB7 entity).",
+    args: [],
+    flags: [
+      {
+        name: "entity",
+        type: "string",
+        description: "Filter to one gallery facet (habit|list|library|watchlist|games|cellar|places|music|routine|area|project|recipe|contact|challenge|automation)."
+      }
+    ],
+    scopes: ["presets:read"],
+    returns: "Preset",
+    notes: "The catalog is code-defined; --entity filters it client-side."
+  },
+  {
+    path: ["presets", "install"],
+    summary: "Install a preset into the Space; prints the nodes it created.",
+    args: [{ name: "key", required: true, description: "Preset catalog key (kebab-case)." }],
+    flags: [],
+    scopes: ["presets:install"],
+    returns: "PresetInstallResult",
+    notes: "Authors content as the caller, so it needs a key minted while logged in."
+  },
   {
     path: ["invite", "create"],
     summary: "Create a Space invite (email/link/guest).",
@@ -24249,6 +24590,27 @@ function idOf(row) {
   }
   return;
 }
+function renderPresetList(data, mode) {
+  if (!Array.isArray(data))
+    return renderRecord(data, mode);
+  if (data.length === 0)
+    return paint(mode, "dim", "(no presets)");
+  const lines = data.map((p) => {
+    const key = paint(mode, "bold", p.key ?? "(no key)");
+    const facet = p.entity ? paint(mode, "dim", ` [${p.entity}]`) : "";
+    return `  ${key}  ${p.name ?? ""}${facet}`;
+  });
+  return [`${data.length} preset(s):`, ...lines].join(`
+`);
+}
+function renderPresetInstall(data, mode) {
+  const r = data;
+  const header = `installed ${paint(mode, "bold", r.key ?? "(preset)")} \u2014 ${r.nodeCount ?? 0} node(s) created`;
+  const facet = r.entity ? [`  entity: ${r.entity}`] : [];
+  const ids = (r.nodeIds ?? []).map((id) => `  ${paint(mode, "dim", id)}`);
+  return [header, ...facet, ...ids].join(`
+`);
+}
 function renderHelp(data, mode) {
   const m = data;
   const lines = [];
@@ -24492,6 +24854,35 @@ var HANDLERS = {
     const body = parseInput(updateUserSettingsInputSchema, readDataFlag(flags));
     return { data: await requireClient().patch("/settings", body), render: renderRecord };
   },
+  "modules list": async ({ requireClient }) => {
+    const settings2 = await requireClient().get("/settings");
+    const enabled = new Set(effectiveEnabledModules(settings2.enabledModules));
+    const rows = FEATURE_MODULES.map((module) => ({
+      key: module.key,
+      label: module.label,
+      group: module.group,
+      enabled: module.system ? true : enabled.has(module.key),
+      system: Boolean(module.system),
+      default: module.defaultEnabled
+    }));
+    return { data: rows, render: renderList };
+  },
+  "modules enable": async ({ args, requireClient }) => setModuleVisibility(args, requireClient, true),
+  "modules disable": async ({ args, requireClient }) => setModuleVisibility(args, requireClient, false),
+  "presets list": async ({ flags, requireClient }) => {
+    const entity = flagString(flags, "entity");
+    if (entity !== undefined && !presetEntitySchema.safeParse(entity).success) {
+      throw usageError(`--entity must be one of: ${presetEntitySchema.options.join(", ")}`);
+    }
+    const catalog2 = presetSchema.array().parse(await requireClient().get("/presets"));
+    const presets2 = entity ? catalog2.filter((p) => p.entity === entity) : catalog2;
+    return { data: presets2, render: renderPresetList };
+  },
+  "presets install": async ({ args, requireClient }) => {
+    const key = requireArg(args, 0, "preset key");
+    const result = presetInstallResultSchema.parse(await requireClient().post(`/presets/${encodeURIComponent(key)}/install`, undefined));
+    return { data: result, render: renderPresetInstall };
+  },
   "invite create": async ({ flags, requireClient }) => {
     const body = parseInput(createInviteInputSchema, { id: ulid3(), ...readDataFlag(flags) });
     return { data: await requireClient().post("/invites", body), render: renderRecord };
@@ -24666,6 +25057,17 @@ var HANDLERS = {
     render: () => `${CLI_NAME} ${VERSION}`
   })
 };
+async function setModuleVisibility(args, requireClient, on) {
+  const key = requireArg(args, 0, "module key");
+  if (!isModuleKey(key)) {
+    throw usageError(`unknown module \`${key}\` \u2014 valid keys: ${MODULE_KEYS.join(", ")}`);
+  }
+  const client = requireClient();
+  const settings2 = await client.get("/settings");
+  const enabledModules = setModuleEnabled(settings2.enabledModules, key, on);
+  const body = parseInput(updateUserSettingsInputSchema, { enabledModules });
+  return { data: await client.patch("/settings", body), render: renderRecord };
+}
 function requireArg(args, index2, name) {
   const value = args[index2];
   if (value === undefined || value.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.42.0",
+  "version": "1.44.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "type": "module",