syntaur 0.44.1 → 0.45.0

package/dist/index.js

@@ -2435,7 +2435,11 @@ var init_fields = __esm({
       tags: { kind: "list" },
       archived: { kind: "bool" },
       title: { kind: "substring" },
-      search: { kind: "substring", get: (i) => i["title"] },
+      // `search` reads a dedicated `searchText` haystack when the item provides one
+      // (so the dashboard can match title + slug + project like its filter box),
+      // falling back to `title` when absent. Backward-compatible: title-only when no
+      // searchText. The `title` field stays title-only.
+      search: { kind: "substring", get: (i) => i["searchText"] ?? i["title"] },
       created: { kind: "timestamp" },
       updated: { kind: "timestamp" },
       completedat: { kind: "timestamp", get: (i) => i["completedAt"] },
@@ -3069,6 +3073,9 @@ function compileQuery(input4, registry = ASSIGNMENT_FIELDS) {
     throw err2;
   }
 }
+function validateQuery(input4, registry = ASSIGNMENT_FIELDS) {
+  return compileQuery(input4, registry).errors;
+}
 var init_query = __esm({
   "src/utils/query/index.ts"() {
     "use strict";
@@ -3081,17 +3088,7 @@ var init_query = __esm({
   }
 });
 
-// src/lifecycle/derive.ts
-var derive_exports = {};
-__export(derive_exports, {
-  DERIVE_FIELDS: () => DERIVE_FIELDS,
-  acceptFactDeclarations: () => acceptFactDeclarations,
-  buildDeriveRegistry: () => buildDeriveRegistry,
-  buildQueryRegistry: () => buildQueryRegistry,
-  deriveDimensions: () => deriveDimensions,
-  factFieldNames: () => factFieldNames,
-  validateDeriveCondition: () => validateDeriveCondition
-});
+// src/utils/fact-registry.ts
 function factFieldNames(decl) {
   const name = decl.name;
   const exportNames = {
@@ -3158,85 +3155,63 @@ function buildQueryRegistry(accepted) {
   for (const decl of accepted) addFactFields(registry, decl);
   return registry;
 }
-function validateDeriveCondition(when, registry = DERIVE_FIELDS) {
-  if (when === "*") return null;
-  const parsed = parseQuery(when);
-  if (!parsed.ast) return parsed.errors[0]?.message ?? "unparseable condition";
-  try {
-    compileNode(parsed.ast, registry);
-    return null;
-  } catch (err2) {
-    if (err2 instanceof CompileError) return err2.errors[0]?.message ?? "invalid condition";
-    throw err2;
-  }
-}
-function compiledWhen(registry, when) {
-  let cache2 = conditionCache.get(registry);
-  if (!cache2) {
-    cache2 = /* @__PURE__ */ new Map();
-    conditionCache.set(registry, cache2);
-  }
-  let pred = cache2.get(when);
-  if (!pred) {
-    if (when === "*") {
-      pred = () => true;
+function queryFieldNames(declarations) {
+  const builtins = [
+    "status",
+    "priority",
+    "type",
+    "assignee",
+    "project",
+    "tag",
+    "tags",
+    "archived",
+    "title",
+    "search",
+    "created",
+    "updated",
+    "completedAt",
+    "statusAge",
+    "phase",
+    "disposition",
+    "phaseAge",
+    "hasRealObjective",
+    "acRealTotal",
+    "acRealChecked",
+    "acAllChecked",
+    "planExists",
+    "planApproved",
+    "workspaceSet",
+    "implementationStarted",
+    "depsSatisfied",
+    "unresolvedQuestions",
+    "progressStaleDays",
+    "blocked",
+    "parked",
+    "reviewRequested",
+    "pinned"
+  ];
+  const custom = [];
+  for (const decl of declarations) {
+    const names = factFieldNames(decl);
+    if (decl.type === "attestation") {
+      custom.push(
+        names.exports.fact,
+        names.exports.approved,
+        names.exports.changesRequested,
+        names.exports.by,
+        names.exports.approvedBy
+      );
     } else {
-      const parsed = parseQuery(when);
-      if (!parsed.ast) {
-        throw new CompileError(parsed.errors);
-      }
-      pred = compileNode(parsed.ast, registry);
+      custom.push(names.exports.fact);
     }
-    cache2.set(when, pred);
   }
-  return pred;
+  return [...builtins, ...custom];
 }
-function deriveDimensions(input4) {
-  const { facts, derive, currentStatus, terminalStatuses: terminalStatuses3, knownStatusIds, override } = input4;
-  const registry = input4.registry ?? DERIVE_FIELDS;
-  if (terminalStatuses3.has(currentStatus)) return null;
-  const ctx = { now: 0 };
-  const item = facts;
-  let phase = derive.phaseLadder[0]?.phase ?? currentStatus;
-  let nextAction = derive.phaseLadder[0]?.next ?? null;
-  for (let i = derive.phaseLadder.length - 1; i >= 0; i--) {
-    const rung = derive.phaseLadder[i];
-    if (compiledWhen(registry, rung.when)(item, ctx)) {
-      phase = rung.phase;
-      nextAction = rung.next ?? null;
-      break;
-    }
-  }
-  let disposition = "active";
-  for (const rule of derive.disposition) {
-    if (rule.when === null || compiledWhen(registry, rule.when)(item, ctx)) {
-      disposition = rule.is;
-      break;
-    }
-  }
-  let derivedStatus;
-  switch (disposition) {
-    case "parked":
-      derivedStatus = knownStatusIds.has(derive.headline.parked) ? derive.headline.parked : phase;
-      break;
-    case "blocked":
-      derivedStatus = knownStatusIds.has(derive.headline.blocked) ? derive.headline.blocked : phase;
-      break;
-    default:
-      derivedStatus = phase;
-  }
-  let status = derivedStatus;
-  if (override && override.status && !terminalStatuses3.has(override.status) && knownStatusIds.has(override.status)) {
-    status = override.status;
-  }
-  return { phase, disposition, derivedStatus, status, nextAction };
-}
-var DERIVE_FIELDS, conditionCache;
-var init_derive = __esm({
-  "src/lifecycle/derive.ts"() {
+var DERIVE_FIELDS;
+var init_fact_registry = __esm({
+  "src/utils/fact-registry.ts"() {
     "use strict";
     init_query();
-    init_query();
     DERIVE_FIELDS = {
       hasrealobjective: { kind: "bool", get: (i) => i["hasRealObjective"] },
       acrealtotal: { kind: "number", get: (i) => i["acRealTotal"] },
@@ -3253,7 +3228,6 @@ var init_derive = __esm({
       reviewrequested: { kind: "bool", get: (i) => i["reviewRequested"] },
       pinned: { kind: "bool" }
     };
-    conditionCache = /* @__PURE__ */ new WeakMap();
   }
 });
 
@@ -4913,7 +4887,7 @@ var init_config2 = __esm({
     init_hotkeysCatalog();
     init_agents_schema();
     init_slug();
-    init_derive();
+    init_fact_registry();
     init_query();
     init_terminal_schema();
     init_workspace_visibility_schema();
@@ -6383,6 +6357,103 @@ var init_create_assignment = __esm({
   }
 });
 
+// src/lifecycle/derive.ts
+var derive_exports = {};
+__export(derive_exports, {
+  DERIVE_FIELDS: () => DERIVE_FIELDS,
+  acceptFactDeclarations: () => acceptFactDeclarations,
+  addFactFields: () => addFactFields,
+  buildDeriveRegistry: () => buildDeriveRegistry,
+  buildQueryRegistry: () => buildQueryRegistry,
+  deriveDimensions: () => deriveDimensions,
+  factFieldNames: () => factFieldNames,
+  queryFieldNames: () => queryFieldNames,
+  validateDeriveCondition: () => validateDeriveCondition
+});
+function validateDeriveCondition(when, registry = DERIVE_FIELDS) {
+  if (when === "*") return null;
+  const parsed = parseQuery(when);
+  if (!parsed.ast) return parsed.errors[0]?.message ?? "unparseable condition";
+  try {
+    compileNode(parsed.ast, registry);
+    return null;
+  } catch (err2) {
+    if (err2 instanceof CompileError) return err2.errors[0]?.message ?? "invalid condition";
+    throw err2;
+  }
+}
+function compiledWhen(registry, when) {
+  let cache2 = conditionCache.get(registry);
+  if (!cache2) {
+    cache2 = /* @__PURE__ */ new Map();
+    conditionCache.set(registry, cache2);
+  }
+  let pred = cache2.get(when);
+  if (!pred) {
+    if (when === "*") {
+      pred = () => true;
+    } else {
+      const parsed = parseQuery(when);
+      if (!parsed.ast) {
+        throw new CompileError(parsed.errors);
+      }
+      pred = compileNode(parsed.ast, registry);
+    }
+    cache2.set(when, pred);
+  }
+  return pred;
+}
+function deriveDimensions(input4) {
+  const { facts, derive, currentStatus, terminalStatuses: terminalStatuses3, knownStatusIds, override } = input4;
+  const registry = input4.registry ?? DERIVE_FIELDS;
+  if (terminalStatuses3.has(currentStatus)) return null;
+  const ctx = { now: 0 };
+  const item = facts;
+  let phase = derive.phaseLadder[0]?.phase ?? currentStatus;
+  let nextAction = derive.phaseLadder[0]?.next ?? null;
+  for (let i = derive.phaseLadder.length - 1; i >= 0; i--) {
+    const rung = derive.phaseLadder[i];
+    if (compiledWhen(registry, rung.when)(item, ctx)) {
+      phase = rung.phase;
+      nextAction = rung.next ?? null;
+      break;
+    }
+  }
+  let disposition = "active";
+  for (const rule of derive.disposition) {
+    if (rule.when === null || compiledWhen(registry, rule.when)(item, ctx)) {
+      disposition = rule.is;
+      break;
+    }
+  }
+  let derivedStatus;
+  switch (disposition) {
+    case "parked":
+      derivedStatus = knownStatusIds.has(derive.headline.parked) ? derive.headline.parked : phase;
+      break;
+    case "blocked":
+      derivedStatus = knownStatusIds.has(derive.headline.blocked) ? derive.headline.blocked : phase;
+      break;
+    default:
+      derivedStatus = phase;
+  }
+  let status = derivedStatus;
+  if (override && override.status && !terminalStatuses3.has(override.status) && knownStatusIds.has(override.status)) {
+    status = override.status;
+  }
+  return { phase, disposition, derivedStatus, status, nextAction };
+}
+var conditionCache;
+var init_derive = __esm({
+  "src/lifecycle/derive.ts"() {
+    "use strict";
+    init_query();
+    init_fact_registry();
+    init_fact_registry();
+    conditionCache = /* @__PURE__ */ new WeakMap();
+  }
+});
+
 // src/utils/assignment-resolver.ts
 import { resolve as resolve11 } from "path";
 import { readdir as readdir5, readFile as readFile8 } from "fs/promises";
@@ -8666,7 +8737,8 @@ async function getStatusConfig() {
       derive: config.statuses.derive ?? null,
       facts: config.statuses.facts ?? null,
       factDeclarations: accepted,
-      deriveRegistry: buildDeriveRegistry(accepted)
+      deriveRegistry: buildDeriveRegistry(accepted),
+      queryRegistry: buildQueryRegistry(accepted)
     };
   } else {
     const def = buildDefaultStatusConfig();
@@ -8680,7 +8752,8 @@ async function getStatusConfig() {
       derive: null,
       facts: null,
       factDeclarations: [],
-      deriveRegistry: buildDeriveRegistry([])
+      deriveRegistry: buildDeriveRegistry([]),
+      queryRegistry: buildQueryRegistry([])
     };
   }
   return _cachedConfig;
@@ -8989,14 +9062,30 @@ async function listArchived(projectsDir2, assignmentsDir2) {
   return { projects, assignments: individuallyArchived };
 }
 async function toStandaloneBoardItem(sr) {
-  const { terminalStatuses: terminalStatuses3 } = await getStatusConfig();
+  const config = await getStatusConfig();
+  const { terminalStatuses: terminalStatuses3 } = config;
+  let facts;
+  try {
+    const { computeFacts: computeFacts2 } = await Promise.resolve().then(() => (init_facts(), facts_exports));
+    facts = await computeFacts2({
+      assignmentDir: sr.assignmentDir,
+      frontmatter: sr.record,
+      body: sr.record.body,
+      projectDir: null,
+      terminalStatuses: terminalStatuses3,
+      declarations: config.factDeclarations
+    });
+  } catch (err2) {
+    console.warn(`toStandaloneBoardItem: computeFacts failed for ${sr.assignmentDir}:`, err2);
+  }
   return {
     ...toAssignmentSummary(sr.record, terminalStatuses3),
     projectSlug: null,
     projectTitle: null,
     blockedReason: sr.record.blockedReason,
     projectWorkspace: sr.record.workspaceGroup ?? null,
-    availableTransitions: await getStandaloneAvailableTransitions(sr.record)
+    availableTransitions: await getStandaloneAvailableTransitions(sr.record),
+    facts
   };
 }
 async function getStandaloneAvailableTransitions(assignment) {
@@ -9883,7 +9972,24 @@ function toAssignmentSummary(assignment, terminalStatuses3) {
   };
 }
 async function toAssignmentBoardItem(projectsDir2, projectRecord, assignment) {
-  const { terminalStatuses: terminalStatuses3 } = await getStatusConfig();
+  const config = await getStatusConfig();
+  const { terminalStatuses: terminalStatuses3 } = config;
+  const assignmentDir = resolve17(projectRecord.projectPath, "assignments", assignment.slug);
+  const projectDir = projectRecord.projectPath;
+  let facts;
+  try {
+    const { computeFacts: computeFacts2 } = await Promise.resolve().then(() => (init_facts(), facts_exports));
+    facts = await computeFacts2({
+      assignmentDir,
+      frontmatter: assignment,
+      body: assignment.body,
+      projectDir,
+      terminalStatuses: terminalStatuses3,
+      declarations: config.factDeclarations
+    });
+  } catch (err2) {
+    console.warn(`toAssignmentBoardItem: computeFacts failed for ${assignmentDir}:`, err2);
+  }
   return {
     ...toAssignmentSummary(assignment, terminalStatuses3),
     projectSlug: projectRecord.summary.slug,
@@ -9895,7 +10001,8 @@ async function toAssignmentBoardItem(projectsDir2, projectRecord, assignment) {
       projectRecord.summary.slug,
       assignment.slug,
       assignment
-    )
+    ),
+    facts
   };
 }
 function buildDependencyGraph(assignments) {
@@ -12858,6 +12965,9 @@ function isViewPrefsDefaults(file) {
 // src/dashboard/api-saved-views.ts
 import { Router } from "express";
 
+// src/utils/view-filters-query.ts
+init_query();
+
 // src/utils/saved-views-schema.ts
 var TABLE_COLUMN_IDS = [
   "title",
@@ -12951,6 +13061,7 @@ function isViewFilters(value) {
   if (obj.activity !== void 0 && !isActivity(obj.activity)) return false;
   if (obj.dateRange !== void 0 && !isDateRange(obj.dateRange)) return false;
   if (obj.search !== void 0 && typeof obj.search !== "string") return false;
+  if (obj.query !== void 0 && typeof obj.query !== "string") return false;
   return true;
 }
 function isSavedViewConfig(value) {
@@ -13136,6 +13247,8 @@ function withTwoLocks(keyA, keyB, fn) {
 }
 
 // src/dashboard/api-saved-views.ts
+init_api();
+init_query();
 var SAVED_VIEWS_LOCK = "sv:global";
 function validateCreateBody(body) {
   if (!body || typeof body !== "object" || Array.isArray(body)) {
@@ -13222,6 +13335,15 @@ function createSavedViewsRouter() {
       res.status(400).json({ error: result.error });
       return;
     }
+    const queryStr = result.value.config.filters.query;
+    if (typeof queryStr === "string" && queryStr.length > 0) {
+      const statusConfig = await getStatusConfig();
+      const queryErrors = validateQuery(queryStr, statusConfig.queryRegistry);
+      if (queryErrors.length > 0) {
+        res.status(400).json({ errors: queryErrors });
+        return;
+      }
+    }
     try {
       const file = await withLock(SAVED_VIEWS_LOCK, async () => {
         const current = await readSavedViewsFile();
@@ -13246,6 +13368,15 @@ function createSavedViewsRouter() {
       res.status(400).json({ error: result.error });
       return;
     }
+    const patchQueryStr = result.value.config?.filters.query;
+    if (typeof patchQueryStr === "string" && patchQueryStr.length > 0) {
+      const statusConfig = await getStatusConfig();
+      const queryErrors = validateQuery(patchQueryStr, statusConfig.queryRegistry);
+      if (queryErrors.length > 0) {
+        res.status(400).json({ errors: queryErrors });
+        return;
+      }
+    }
     try {
       const outcome = await withLock(SAVED_VIEWS_LOCK, async () => {
         const current = await readSavedViewsFile();
@@ -17204,12 +17335,6 @@ function parseOpenUrl(input4) {
   let prompt;
   if (promptVals.length === 1) {
     const value = promptVals[0];
-    if (/[\r\n]/.test(value)) {
-      throw new OpenUrlError(
-        "invalid-prompt",
-        "`prompt` query param must be a single line (no newlines)"
-      );
-    }
     if (value.length > MAX_OPEN_PROMPT_LENGTH) {
       throw new OpenUrlError(
         "invalid-prompt",
@@ -18523,7 +18648,8 @@ function createStatusConfigRouter(projectsDir2, assignmentsDir2) {
         statuses: config.statuses,
         order: config.order,
         transitions: config.transitions,
-        custom: config.custom
+        custom: config.custom,
+        factDeclarations: config.factDeclarations
       });
     } catch (error) {
       console.error("Error getting status config:", error);
@@ -37599,7 +37725,11 @@ async function loadQueryItem(item, terminalStatuses3, now, declarations) {
       updated: fm.updated,
       completedAt,
       statusAge,
-      phaseAge
+      phaseAge,
+      // Mirror the dashboard haystack (queryFilter.ts boardItemToQueryItem) so
+      // `search:` behaves identically on the CLI and the dashboard. The shared
+      // `search` field reads `searchText ?? title`; `title:` stays title-only.
+      searchText: `${item.title ?? ""} ${item.slug ?? ""} ${item.projectTitle ?? "standalone"} ${item.projectSlug ?? ""}`
     };
   } catch {
     return null;
@@ -37659,7 +37789,8 @@ var KNOWN_FILTER_KEYS = /* @__PURE__ */ new Set([
   "tags",
   "activity",
   "dateRange",
-  "search"
+  "search",
+  "query"
 ]);
 function preserveUnknownFilterKeys(existing, built) {
   const out = {};
@@ -37702,6 +37833,8 @@ function minimizeFilters(filters, forcedProject) {
   if (filters.dateRange) minimal.dateRange = filters.dateRange;
   const search = filters.search?.trim();
   if (search) minimal.search = search;
+  const query = filters.query?.trim();
+  if (query) minimal.query = query;
   return minimal;
 }
 function captureCurrentView(input4) {
@@ -37728,6 +37861,9 @@ var DEFAULT_CREATE_VIEW_STATE = {
 };
 
 // src/commands/views.ts
+init_derive();
+init_recompute();
+init_query();
 var YMD_RE2 = /^\d{4}-\d{2}-\d{2}$/;
 function fail2(error) {
   console.error("Error:", error instanceof Error ? error.message : String(error));
@@ -37797,7 +37933,7 @@ function buildDateRange(opts) {
   return dr;
 }
 function hasConfigFlag(opts) {
-  return opts.viewMode !== void 0 || opts.sortField !== void 0 || opts.sortDirection !== void 0 || opts.status !== void 0 || opts.type !== void 0 || opts.priority !== void 0 || opts.assignee !== void 0 || opts.projectFilter !== void 0 || opts.tags !== void 0 || opts.activity !== void 0 || opts.search !== void 0 || opts.dateRangeField !== void 0 || opts.dateRangePreset !== void 0 || opts.dateFrom !== void 0 || opts.dateTo !== void 0 || opts.clearDateRange === true || opts.collapsed !== void 0 || opts.kanbanHidden !== void 0 || opts.tableHidden !== void 0;
+  return opts.viewMode !== void 0 || opts.sortField !== void 0 || opts.sortDirection !== void 0 || opts.status !== void 0 || opts.type !== void 0 || opts.priority !== void 0 || opts.assignee !== void 0 || opts.projectFilter !== void 0 || opts.tags !== void 0 || opts.activity !== void 0 || opts.search !== void 0 || opts.dateRangeField !== void 0 || opts.dateRangePreset !== void 0 || opts.dateFrom !== void 0 || opts.dateTo !== void 0 || opts.clearDateRange === true || opts.collapsed !== void 0 || opts.kanbanHidden !== void 0 || opts.tableHidden !== void 0 || opts.query !== void 0;
 }
 function emptyVisibilityState() {
   return {
@@ -37826,7 +37962,7 @@ function baseStateFromConfig(config) {
     tableColumnVisibility: { hidden: [...config.tableColumnVisibility.hidden] }
   };
 }
-function applyFlagsToState(state, opts) {
+async function applyFlagsToState(state, opts) {
   if (opts.viewMode !== void 0) state.viewMode = validateEnum(opts.viewMode, VIEW_MODES, "--view-mode");
   if (opts.sortField !== void 0) state.sortField = validateEnum(opts.sortField, SORT_FIELDS, "--sort-field");
   if (opts.sortDirection !== void 0) {
@@ -37862,13 +37998,28 @@ function applyFlagsToState(state, opts) {
     }
     state.tableColumnVisibility = { hidden: ids };
   }
+  if (opts.query !== void 0) {
+    if (opts.query === "") {
+      delete state.filters.query;
+    } else {
+      const context = await resolveDeriveContext();
+      const { query, errors } = compileQuery(opts.query, buildQueryRegistry(context.factDeclarations));
+      if (!query) {
+        throw new Error(
+          `Invalid --query:
+${errors.map((e) => `  at ${e.pos}: ${e.message}`).join("\n")}`
+        );
+      }
+      state.filters.query = opts.query;
+    }
+  }
 }
 async function runViewsAdd(opts) {
   if (opts.name === void 0) throw new Error("--name is required");
   const name = validateName(opts.name);
   const { value: workspace } = resolveWorkspaceFlag(opts);
   const state = baseStateForAdd();
-  applyFlagsToState(state, opts);
+  await applyFlagsToState(state, opts);
   const { config } = captureCurrentView({ name, context: { workspace, projectSlug: null }, state });
   if (!isSavedViewConfig(config)) throw new Error("assembled an invalid SavedViewConfig");
   const file = await readSavedViewsFile();
@@ -37916,7 +38067,7 @@ async function runViewsUpdate(id, opts) {
   if (ws.provided) patch.workspace = ws.value;
   if (hasConfigFlag(opts)) {
     const state = baseStateFromConfig(existing.config);
-    applyFlagsToState(state, opts);
+    await applyFlagsToState(state, opts);
     const built = captureCurrentView({ name: "", context: { workspace: null, projectSlug: null }, state }).config;
     const merged = mergeUpdatedConfig(existing.config, built, {
       listSectionVisibility: state.listSectionVisibility,
@@ -37941,7 +38092,7 @@ async function runViewsDelete(id) {
   await writeSavedViewsFile(result.file);
 }
 function addConfigFlags(cmd) {
-  return cmd.option("--workspace <ws>", "Scope the view to a workspace (default: global)").option("--global", "Make the view global (workspace = null)").option("--view-mode <mode>", `View mode (${VIEW_MODES.join("|")})`).option("--sort-field <field>", `Sort field (${SORT_FIELDS.join("|")})`).option("--sort-direction <dir>", `Sort direction (${SORT_DIRECTIONS.join("|")})`).option("--status <vals>", 'Status filter, comma-separated ("all"/"" clears)').option("--type <vals>", 'Type filter, comma-separated ("all"/"" clears)').option("--priority <vals>", 'Priority filter, comma-separated ("all"/"" clears)').option("--assignee <vals>", 'Assignee filter, comma-separated ("all"/"" clears)').option("--project-filter <vals>", 'Project filter, comma-separated ("all"/"" clears)').option("--tags <vals>", 'Tags filter, comma-separated ("all"/"" clears)').option("--activity <val>", `Activity filter (${ACTIVITIES.join("|")}; "all" clears)`).option("--date-range-field <field>", `Date range field (${DATE_RANGE_FIELDS.join("|")})`).option("--date-range-preset <preset>", `Date range preset (${DATE_RANGE_PRESETS.join("|")})`).option("--date-from <YYYY-MM-DD>", "Date range start (exclusive with --date-range-preset)").option("--date-to <YYYY-MM-DD>", "Date range end (exclusive with --date-range-preset)").option("--clear-date-range", "Remove the date-range filter").option("--search <text>", 'Search text filter ("" clears)').option("--collapsed <vals>", "List-view collapsed section ids, comma-separated").option("--kanban-hidden <vals>", "Kanban hidden column ids, comma-separated").option("--table-hidden <vals>", `Table hidden column ids (${TABLE_COLUMN_IDS.join("|")}), comma-separated`).option("--json", "Output the resulting view as JSON");
+  return cmd.option("--workspace <ws>", "Scope the view to a workspace (default: global)").option("--global", "Make the view global (workspace = null)").option("--view-mode <mode>", `View mode (${VIEW_MODES.join("|")})`).option("--sort-field <field>", `Sort field (${SORT_FIELDS.join("|")})`).option("--sort-direction <dir>", `Sort direction (${SORT_DIRECTIONS.join("|")})`).option("--status <vals>", 'Status filter, comma-separated ("all"/"" clears)').option("--type <vals>", 'Type filter, comma-separated ("all"/"" clears)').option("--priority <vals>", 'Priority filter, comma-separated ("all"/"" clears)').option("--assignee <vals>", 'Assignee filter, comma-separated ("all"/"" clears)').option("--project-filter <vals>", 'Project filter, comma-separated ("all"/"" clears)').option("--tags <vals>", 'Tags filter, comma-separated ("all"/"" clears)').option("--activity <val>", `Activity filter (${ACTIVITIES.join("|")}; "all" clears)`).option("--date-range-field <field>", `Date range field (${DATE_RANGE_FIELDS.join("|")})`).option("--date-range-preset <preset>", `Date range preset (${DATE_RANGE_PRESETS.join("|")})`).option("--date-from <YYYY-MM-DD>", "Date range start (exclusive with --date-range-preset)").option("--date-to <YYYY-MM-DD>", "Date range end (exclusive with --date-range-preset)").option("--clear-date-range", "Remove the date-range filter").option("--search <text>", 'Search text filter ("" clears)').option("--query <expr>", 'AQL filter query ("" clears)').option("--collapsed <vals>", "List-view collapsed section ids, comma-separated").option("--kanban-hidden <vals>", "Kanban hidden column ids, comma-separated").option("--table-hidden <vals>", `Table hidden column ids (${TABLE_COLUMN_IDS.join("|")}), comma-separated`).option("--json", "Output the resulting view as JSON");
 }
 var viewsCommand = new Command15("views").description(
   "Manage saved views (~/.syntaur/saved-views.json)"