@zeyos/cli 0.1.1 → 0.3.0

package/commands/get.mjs

@@ -17,11 +17,12 @@
 import { loadConfig }                    from '../lib/config.mjs';
 import { canonicalName }                 from '../lib/resources.mjs';
 import { getGetFields, getGetParams }    from '../lib/resource-config.mjs';
-import { outputMode, printJson, printYaml, printRecord, buildDateFormatters } from '../lib/output.mjs';
+import { outputMode, printJson, printYaml, printRecord, buildDateFormatters, buildEnumFormatters } from '../lib/output.mjs';
 import {
   buildCliClient,
   callApi,
   fail,
+  maybeDryRun,
   requireRecordId,
   requireResource
 } from '../lib/command.mjs';
@@ -44,6 +45,7 @@ Options:
   --all               Fetch all data (extdata + tags + all fields)
   --json              Output as JSON
   --yaml              Output as YAML
+  --query             Print the request route + JSON body without sending it
   -h, --help          Show this help
 
 Fields format:
@@ -66,7 +68,7 @@ export async function run(values, positional) {
   requireRecordId(id, 'zeyos get <resource> <id>');
 
   const resName = canonicalName(resourceName);
-  const clientState = buildCliClient();
+  const clientState = buildCliClient(values);
 
   // ── Build params ───────────────────────────────────────────────────────────
   // GET endpoints use query parameters like ?extdata=1&tags=1 to include
@@ -98,6 +100,8 @@ export async function run(values, positional) {
   }
 
   // ── Call API ───────────────────────────────────────────────────────────────
+  if (await maybeDryRun(clientState, res.get, params, values)) return;
+
   const record = await callApi(clientState, res.get, params, {
     notFoundMessage: `${resourceName} #${id} not found.`
   });
@@ -121,7 +125,16 @@ export async function run(values, positional) {
     const cfg = loadConfig();
     const dateFormat = cfg.dateFormat ?? 'YYYY-MM-DD';
     const displayKeys = fields ?? Object.keys(record);
-    const formatters = buildDateFormatters(displayKeys, dateFormat);
-    printRecord(record, displayKeys, fieldLabels, formatters);
+    const dateFormatters = buildDateFormatters(displayKeys, dateFormat);
+
+    // QW-3: schema-driven enum/ID coloring in the single-record view too.
+    // Enum values are colored by their resolved label keyword; ID/FK fields are
+    // dimmed. Date formatters win for date columns. No-op when color is off.
+    const schema = clientState.client.schema;
+    const schemaKey = schema?.resourceForOperation?.(res.get);
+    const fieldDefs = schemaKey ? schema.describe(schemaKey)?.fields : undefined;
+    const enumFormatters = fieldDefs ? buildEnumFormatters(displayKeys, fieldDefs) : {};
+
+    printRecord(record, displayKeys, fieldLabels, { ...enumFormatters, ...dateFormatters });
   }
 }

package/commands/list.mjs

@@ -6,6 +6,7 @@
  * Options:
  *   --fields <list>        Field selection (comma-separated or JSON object)
  *   --filter <json>        JSON filter object  e.g. '{"status":1}'
+ *   --filter-file <path>   Read JSON filter object from a file
  *   --sort <field>         Sort field, prefix with - for descending  e.g. '-lastmodified'
  *   --limit <n>            Max records to fetch  (default: 50)
  *   --offset <n>           Skip first N records  (default: 0)
@@ -19,12 +20,13 @@ import { normalizeListResult }            from '@zeyos/client';
 import { loadConfig }                    from '../lib/config.mjs';
 import { canonicalName }                 from '../lib/resources.mjs';
 import { getListFields }                 from '../lib/resource-config.mjs';
-import { outputMode, printJson, printYaml, printTable, buildDateFormatters, warn, info } from '../lib/output.mjs';
+import { outputMode, printJson, printYaml, printTable, buildDateFormatters, buildEnumFormatters, info } from '../lib/output.mjs';
 import {
   buildCliClient,
   callApi,
   fail,
-  parseJsonOption,
+  maybeDryRun,
+  parseJsonOptionOrFile,
   requireApiMethod,
   requireResource
 } from '../lib/command.mjs';
@@ -40,6 +42,8 @@ Arguments:
 Options:
   --fields <list>     Field selection (see formats below)
   --filter <json>     JSON filter object  e.g. '{"status":1}'
+  --filter-file <path>
+                      Read JSON filter object from a file
   --sort <fields>     Sort expression  e.g. '-lastmodified'
   --limit <n>         Max records (default: 50)
   --offset <n>        Skip first N records (default: 0)
@@ -47,6 +51,7 @@ Options:
   --expand <list>     Expand JSON/binary columns (e.g. binfile, items)
   --json              Output as JSON
   --yaml              Output as YAML
+  --query             Print the request route + JSON body without sending it
   -h, --help          Show this help
 
 Fields format:
@@ -57,6 +62,7 @@ Fields format:
 Examples:
   zeyos list tickets
   zeyos list tickets --filter '{"status":1}' --sort -lastmodified
+  zeyos list tickets --filter-file ./filters/open-tickets.json
   zeyos list tickets --fields ID,name,status --limit 10
   zeyos list accounts --fields '{"Name": "lastname", "City": "contact.city"}'
   zeyos list tickets --extdata
@@ -68,7 +74,6 @@ export async function run(values, positional) {
   const res = requireResource(resourceName, 'zeyos list <resource>');
 
   const resName = canonicalName(resourceName);
-  const clientState = buildCliClient();
 
   // ── Resolve field config ──────────────────────────────────────────────────
   const { apiFields, displayColumns } = getListFields(res, resName, values.fields);
@@ -79,8 +84,9 @@ export async function run(values, positional) {
   // Pass configured fields to the API for server-side field selection
   if (apiFields) body.fields = apiFields;
 
-  if (values.filter) {
-    body.filters = parseJsonOption(values.filter, 'filter');
+  const filters = parseJsonOptionOrFile(values, 'filter', 'filter-file');
+  if (filters !== undefined) {
+    body.filters = filters;
   }
 
   if (values.sort) body.sort = values.sort.split(',').map(s => s.trim()).filter(Boolean);
@@ -110,6 +116,9 @@ export async function run(values, positional) {
   }
 
   // ── Call API ───────────────────────────────────────────────────────────────
+  const clientState = buildCliClient(values);
+  if (await maybeDryRun(clientState, res.list, body, values)) return;
+
   const fn = requireApiMethod(clientState, res.list);
   let records = await callApi(clientState, res.list, body);
 
@@ -125,13 +134,27 @@ export async function run(values, positional) {
   } else if (mode === 'yaml') {
     printYaml(records);
   } else if (records.length === 0) {
-    warn(`No ${resourceName} found.`);
+    // QW-7: an empty result is a neutral fact, not a warning — use the info `·`
+    // glyph rather than the `⚠` glyph (which reads as an error).
+    info(`No ${resourceName} match.`);
     return;
   } else {
     const cfg = loadConfig();
     const dateFormat = cfg.dateFormat ?? 'YYYY-MM-DD';
-    const formatters = buildDateFormatters(displayColumns, dateFormat, apiFields);
-    printTable(records, displayColumns, {}, formatters);
+    const dateFormatters = buildDateFormatters(displayColumns, dateFormat, apiFields);
+
+    // QW-3: schema-driven enum/ID coloring. Resolve the resource's field defs
+    // (enums, FKs) via the same schema source `describe` uses, then color enum
+    // values by label keyword and dim ID/FK columns. No-op when color is off.
+    // Date formatters win for date columns (a column is never both).
+    const schema = clientState.client.schema;
+    const schemaKey = schema?.resourceForOperation?.(res.list);
+    const fieldDefs = schemaKey ? schema.describe(schemaKey)?.fields : undefined;
+    const enumFormatters = fieldDefs
+      ? buildEnumFormatters(displayColumns, fieldDefs, apiFields)
+      : {};
+
+    printTable(records, displayColumns, {}, { ...enumFormatters, ...dateFormatters });
   }
 
   // ── Pagination / truncation hint ──────────────────────────────────────────
@@ -149,14 +172,14 @@ export async function run(values, positional) {
       const countResult = await fn(countBody);
       const total = countResult?.count ?? null;
       if (total !== null && total > records.length) {
-        info(`Showing ${from}–${to} of ${total}  (default --limit ${limit} truncated this — pass --limit, --offset ${to} for the next page, or use \`zeyos count ${resourceName}\` for the total).`);
+        info(`→ Showing ${from}–${to} of ${total}  (default --limit ${limit} truncated this — pass --limit, --offset ${to} for the next page, or use \`zeyos count ${resourceName}\` for the total).`);
       } else if (total !== null) {
-        info(`Showing ${from}–${to} of ${total}  (--offset ${to} for next page)`);
+        info(`→ Showing ${from}–${to} of ${total}  (--offset ${to} for next page)`);
       }
     } catch {
       // Non-critical — skip pagination info
     }
   } else if (offset > 0) {
-    info(`Showing ${from}–${to} of ${to}`);
+    info(`→ Showing ${from}–${to} of ${to}`);
   }
 }

package/commands/login.mjs

@@ -20,7 +20,7 @@
 
 import { createInterface }                from 'node:readline';
 import { createZeyosClient, MemoryTokenStore } from '@zeyos/client';
-import { saveConfig, loadConfig }         from '../lib/config.mjs';
+import { saveConfig, loadConfig, getProfile, upsertProfile, setActiveProfile } from '../lib/config.mjs';
 import { waitForCallback, callbackUri, BrowserUnavailableError } from '../lib/login-server.mjs';
 import { success, error, info, warn }     from '../lib/output.mjs';
 
@@ -35,6 +35,7 @@ Options:
   --base-url <url>    ZeyOS platform URL  (prompted if missing)
   --client-id <id>    OAuth client ID     (prompted if missing)
   --secret <secret>   OAuth client secret (prompted if missing)
+  --profile <name>    Store credentials/tokens in a named profile and activate it
   --scope <scope>     OAuth scope  (default: all)
   --port <port>       Local callback server port  (default: 9005)
   --global            Store credentials globally (~/.config/zeyos/credentials.json)
@@ -45,12 +46,21 @@ Options:
 `;
 
 export async function run(values) {
+  const profileName = values.profile || null;
   const scope = values.global ? 'global' : 'local';
   const port  = values.port ? Number(values.port) : DEFAULT_CALLBACK_PORT;
   const redirectUri = callbackUri(port);
 
+  // Persist either into a named profile or the legacy local/global credential file.
+  const persist = (updates) => {
+    if (profileName) upsertProfile(profileName, updates);
+    else saveConfig(updates, scope);
+  };
+
   // ── Resolve connection params ──────────────────────────────────────────────
-  const existing = values.clean ? {} : loadConfig();
+  const existing = values.clean
+    ? {}
+    : (profileName ? (getProfile(profileName) || {}) : loadConfig());
   if (values.clean) values.force = true;
 
   let baseUrl      = values['base-url']    ?? existing.baseUrl;
@@ -79,12 +89,17 @@ export async function run(values) {
   }
 
   // Save connection params immediately so they are available on retries
-  saveConfig({ baseUrl, clientId, clientSecret }, scope);
+  persist({ baseUrl, clientId, clientSecret });
 
   // ── Check if already authenticated ────────────────────────────────────────
   if (existing.accessToken && !values.force) {
-    warn('Already logged in.  Use --force to re-authenticate.');
-    return;
+    if (_tokenExpired(existing)) {
+      info('Stored access token has expired — re-authenticating…');
+    } else {
+      const where = profileName ? `profile "${profileName}"` : 'this scope';
+      warn(`Already logged in (${where}).  Use --force to re-authenticate.`);
+      return;
+    }
   }
 
   // ── Build a temporary client (no token yet) ────────────────────────────────
@@ -138,7 +153,7 @@ export async function run(values) {
     info('Exchanging authorization code for tokens…');
     const tokenSet = await client.oauth2.exchangeAuthorizationCode({ code, redirectUri });
 
-    saveConfig({
+    persist({
       baseUrl,
       clientId,
       clientSecret,
@@ -146,9 +161,12 @@ export async function run(values) {
       refreshToken:          tokenSet.refreshToken          ?? undefined,
       expiresAt:             tokenSet.expiresAt             ?? undefined,
       refreshTokenExpiresAt: tokenSet.refreshTokenExpiresAt ?? undefined,
-    }, scope);
+    });
 
-    success('Logged in successfully.');
+    if (profileName) setActiveProfile(profileName);
+    success(profileName
+      ? `Logged in — profile "${profileName}" is now active.`
+      : 'Logged in successfully.');
   } catch (err) {
     error(`Token exchange failed: ${err.message}`);
     process.exit(1);
@@ -157,6 +175,13 @@ export async function run(values) {
 
 // ── Helpers ───────────────────────────────────────────────────────────────────
 
+/** True when stored creds carry an access token whose expiry is in the past. */
+function _tokenExpired(creds) {
+  if (!creds?.accessToken || creds.expiresAt == null) return false;
+  const exp = Number(creds.expiresAt) > 2e10 ? Number(creds.expiresAt) / 1000 : Number(creds.expiresAt);
+  return Number.isFinite(exp) && exp < Math.floor(Date.now() / 1000);
+}
+
 /**
  * Try the browser + callback server flow.
  * On any failure, fall back to prompting the user for the code.

package/commands/logout.mjs

@@ -10,7 +10,7 @@
  */
 
 import { createZeyosClient, MemoryTokenStore } from '@zeyos/client';
-import { loadConfig, clearTokens }             from '../lib/config.mjs';
+import { loadConfigWithSource, clearTokens, clearTokensForSource } from '../lib/config.mjs';
 import { success, warn, info }                 from '../lib/output.mjs';
 
 export const USAGE = `\
@@ -19,13 +19,13 @@ Usage: zeyos logout [options]
 Revoke the current session and clear stored tokens.
 
 Options:
-  --global    Target the global credentials file
-  -h, --help  Show this help
+  --profile <name>  Log out of a specific profile
+  --global          Target the legacy global credentials file
+  -h, --help        Show this help
 `;
 
 export async function run(values) {
-  const scope  = values.global ? 'global' : 'local';
-  const config = loadConfig();
+  const { config, source } = loadConfigWithSource({ profile: values.profile });
 
   if (!config.accessToken) {
     warn('Not currently logged in.');
@@ -58,6 +58,11 @@ export async function run(values) {
     }
   }
 
-  clearTokens(scope);
-  success('Logged out.');
+  if (values.global) {
+    clearTokens('global');
+  } else {
+    clearTokensForSource(source);
+  }
+  const where = source?.kind === 'profile' ? `profile "${source.name}"` : (values.global ? 'global credentials' : 'local credentials');
+  success(`Logged out (${where}).`);
 }

package/commands/profile.mjs

@@ -0,0 +1,211 @@
+/**
+ * zeyos profile <list|current|use|add|remove>
+ *
+ * Manage named credential profiles (e.g. dev, prod, client-x) and switch between
+ * ZeyOS instances without re-running login each time.
+ *
+ *   list                     Show all profiles (active marked with *)
+ *   current                  Show the profile that resolves right now, and why
+ *   use <name> [--local]     Make <name> active globally, or pin it to this project
+ *   add <name> [opts]        Create/update a profile's connection params
+ *   remove <name>            Delete a profile
+ *
+ * `add` options: --base-url, --client-id, --secret, or --from-current to snapshot
+ * the credentials currently in effect (including tokens) into the new profile.
+ */
+
+import {
+  listProfiles, getProfile, upsertProfile, removeProfile,
+  setActiveProfile, writeLocalPin, readLocalPin,
+  resolveProfileSelection, loadConfigWithSource, profilesConfigPath
+} from '../lib/config.mjs';
+import { outputMode, printJson, printYaml, printTable, success, error, info, warn } from '../lib/output.mjs';
+
+export const USAGE = `\
+Usage: zeyos profile <command> [options]
+
+Manage named credential profiles and switch between ZeyOS instances.
+
+Commands:
+  list                       List all profiles (active marked with *)
+  current                    Show which profile is in effect, and why
+  use <name>                 Make <name> the active profile (global)
+  use <name> --local         Pin <name> to the current project (.zeyos/profile)
+  add <name> [options]       Create or update a profile
+  remove <name>              Delete a profile
+
+Add options:
+  --base-url <url>           ZeyOS platform URL for the profile
+  --client-id <id>           OAuth client ID
+  --secret <secret>          OAuth client secret
+  --from-current             Snapshot the credentials currently in effect (incl. tokens)
+
+Global options:
+  --json | --yaml            Machine-readable output (list / current)
+  -h, --help                 Show this help
+
+Examples:
+  zeyos profile add dev  --base-url https://zeyos.cms-it.de/dev
+  zeyos profile add prod --from-current
+  zeyos profile use prod
+  zeyos profile use dev --local        # only inside this project
+  zeyos whoami --profile dev           # one-off override on any command
+`;
+
+export async function run(values, positional) {
+  const sub = positional[0] || 'list';
+  switch (sub) {
+    case 'list':    return cmdList(values);
+    case 'current': return cmdCurrent(values);
+    case 'use':     return cmdUse(values, positional[1]);
+    case 'add':     return cmdAdd(values, positional[1]);
+    case 'remove':
+    case 'rm':
+    case 'delete':  return cmdRemove(values, positional[1]);
+    default:
+      error(`Unknown profile command: "${sub}".`);
+      process.stderr.write(`\n${USAGE}`);
+      process.exit(1);
+  }
+}
+
+// ── list ───────────────────────────────────────────────────────────────────────
+
+function cmdList(values) {
+  const { active, profiles } = listProfiles();
+  const names = Object.keys(profiles);
+  const mode = outputMode(values);
+
+  if (mode === 'json') return printJson({ active, profiles });
+  if (mode === 'yaml') return printYaml({ active, profiles });
+
+  if (names.length === 0) {
+    info('No profiles defined yet.');
+    console.error(`Create one with:  zeyos profile add <name> --base-url <url>`);
+    console.error(`              or:  zeyos login --profile <name>`);
+    return;
+  }
+
+  const rows = names.map((name) => ({
+    name: `${name === active ? '*' : ' '} ${name}`,
+    baseUrl: profiles[name].baseUrl || '(no URL)',
+    token: tokenStatus(profiles[name])
+  }));
+  printTable(rows, ['name', 'baseUrl', 'token'], { name: 'PROFILE', baseUrl: 'BASE URL', token: 'TOKEN' });
+  console.error(`\nProfiles file: ${profilesConfigPath()}`);
+}
+
+// ── current ────────────────────────────────────────────────────────────────────
+
+function cmdCurrent(values) {
+  const selection = resolveProfileSelection({ profileFlag: values.profile });
+  const loaded = loadConfigWithSource({ profile: values.profile });
+  const mode = outputMode(values);
+
+  const out = {
+    profile: selection.name || null,
+    origin: selection.origin || null,
+    source: loaded.source,
+    baseUrl: loaded.config.baseUrl || null,
+    token: tokenStatus(loaded.config)
+  };
+
+  if (mode === 'json') return printJson(out);
+  if (mode === 'yaml') return printYaml(out);
+
+  if (selection.name) {
+    if (selection.missing) {
+      warn(`Selected profile "${selection.name}" (via ${selection.origin}) does not exist.`);
+      return;
+    }
+    success(`Active profile: ${selection.name}  (selected via ${selection.origin})`);
+  } else if (loaded.source) {
+    info(`No named profile in effect — using legacy ${loaded.source.kind} credentials.`);
+  } else {
+    warn('No credentials configured. Run `zeyos login` or `zeyos profile add`.');
+    return;
+  }
+  console.error(`  base URL: ${out.baseUrl || '(none)'}`);
+  console.error(`  token:    ${out.token}`);
+}
+
+// ── use ────────────────────────────────────────────────────────────────────────
+
+function cmdUse(values, name) {
+  if (!name) fail('Usage: zeyos profile use <name> [--local]');
+  if (!getProfile(name)) failUnknown(name);
+
+  if (values.local) {
+    const path = writeLocalPin(name);
+    success(`Pinned profile "${name}" to this project.`);
+    console.error(`  ${path}`);
+    return;
+  }
+  setActiveProfile(name);
+  success(`Active profile: ${name}`);
+}
+
+// ── add ────────────────────────────────────────────────────────────────────────
+
+function cmdAdd(values, name) {
+  if (!name) fail('Usage: zeyos profile add <name> [--base-url <url>] [--client-id <id>] [--secret <secret>] | --from-current');
+
+  let updates = {};
+  if (values['from-current']) {
+    const cfg = loadConfigWithSource().config; // whatever is in effect right now
+    for (const k of ['baseUrl', 'instance', 'clientId', 'clientSecret', 'accessToken', 'refreshToken', 'expiresAt', 'refreshTokenExpiresAt']) {
+      if (cfg[k] != null) updates[k] = cfg[k];
+    }
+    if (!updates.baseUrl) fail('Nothing to snapshot: no credentials are currently in effect.');
+  } else {
+    if (values['base-url'])  updates.baseUrl      = values['base-url'];
+    if (values['client-id']) updates.clientId     = values['client-id'];
+    if (values.secret)       updates.clientSecret = values.secret;
+    if (Object.keys(updates).length === 0) {
+      fail('Provide at least --base-url (and ideally --client-id/--secret), or use --from-current.');
+    }
+  }
+
+  const existed = Boolean(getProfile(name));
+  upsertProfile(name, updates);
+  success(`${existed ? 'Updated' : 'Created'} profile "${name}".`);
+  if (!updates.accessToken) {
+    info(`Finish authenticating with:  zeyos login --profile ${name}`);
+  }
+}
+
+// ── remove ─────────────────────────────────────────────────────────────────────
+
+function cmdRemove(values, name) {
+  if (!name) fail('Usage: zeyos profile remove <name>');
+  const removed = removeProfile(name);
+  if (!removed) failUnknown(name);
+  success(`Removed profile "${name}".`);
+  const pin = readLocalPin();
+  if (pin && pin.name === name) {
+    warn(`This project still pins "${name}" (${pin.path}); that pin will no longer resolve.`);
+  }
+}
+
+// ── helpers ────────────────────────────────────────────────────────────────────
+
+/** Human-readable token status from stored creds. Handles seconds or ms expiry. */
+function tokenStatus(creds = {}) {
+  if (!creds.accessToken) return 'none';
+  const exp = creds.expiresAt;
+  if (exp == null) return 'present';
+  const expSec = Number(exp) > 2e10 ? Number(exp) / 1000 : Number(exp);
+  const now = Math.floor(Date.now() / 1000);
+  return expSec < now ? 'expired' : 'ok';
+}
+
+function failUnknown(name) {
+  const names = Object.keys(listProfiles().profiles);
+  const known = names.length ? `Known profiles: ${names.join(', ')}.` : 'No profiles defined yet.';
+  fail(`No such profile: "${name}". ${known}`);
+}
+
+function fail(message) {
+  error(message);
+  process.exit(1);
+}

package/commands/skills.mjs

@@ -177,7 +177,7 @@ async function resolveTarget(values) {
   } else if (interactive) {
     agent = await promptAgent();
   } else {
-    agent = detectAgent() || AGENTS[0];
+    agent = detectAgent() || AGENTS.find((a) => a.key === 'agents');
   }
 
   // (b) Install globally or just for this project?
@@ -225,7 +225,8 @@ function promptMenu(question, items, defaultIndex = 0) {
 
 async function promptAgent() {
   const detected = detectAgent();
-  const defaultIndex = detected ? AGENTS.indexOf(detected) : 0;
+  const agentsIdx = AGENTS.findIndex((a) => a.key === 'agents');
+  const defaultIndex = detected ? AGENTS.indexOf(detected) : agentsIdx;
   const items = AGENTS.map((a) => ({
     label: a.label,
     hint: a === detected ? `${a.local}  (detected here)` : a.local,

package/commands/update.mjs

@@ -4,15 +4,17 @@
  * Update an existing record.  Works like `create` but requires an ID.
  *
  * Options:
- *   --data <json>    Fields to update as a JSON object
- *   --json           Output updated record as JSON
- *   --yaml           Output updated record as YAML
+ *   --data <json>       Fields to update as a JSON object
+ *   --data-file <path>  Read fields to update as a JSON object from a file
+ *   --json              Output updated record as JSON
+ *   --yaml              Output updated record as YAML
  */
 
 import {
   buildCliClient,
   buildRecordPayload,
   callApi,
+  maybeDryRun,
   requireRecordId,
   requireResource
 } from '../lib/command.mjs';
@@ -29,14 +31,17 @@ Arguments:
 
 Options:
   --data <json>       Fields to update as a JSON object
+  --data-file <path>  Read fields to update as a JSON object from a file
   --<field> <value>   Set individual fields  e.g. --status 2
   --json              Output updated record as JSON
   --yaml              Output updated record as YAML
+  --query             Print the request route + JSON body without sending it
   -h, --help          Show this help
 
 Examples:
   zeyos update ticket 42 --status 3
   zeyos update account 7 --data '{"email":"new@example.com"}'
+  zeyos update ticket 42 --data-file ./ticket-update.json
 `;
 
 export async function run(values, positional) {
@@ -51,9 +56,11 @@ export async function run(values, positional) {
   // (optional) JSON body some callers pass positionally instead of via --data.
   const data = buildRecordPayload(values, positional[2]);
 
-  const clientState = buildCliClient();
+  const clientState = buildCliClient(values);
 
   // ── Call API ───────────────────────────────────────────────────────────────
+  if (await maybeDryRun(clientState, res.update, { ID: id, body: data }, values)) return;
+
   const record = await callApi(clientState, res.update, { ID: id, body: data }, {
     notFoundMessage: `${resourceName} #${id} not found.`
   });

package/commands/whoami.mjs

@@ -27,7 +27,7 @@ Options:
 export async function run(values) {
   let client, config, tokenStore, configSource;
   try {
-    ({ client, config, tokenStore, configSource } = buildClient());
+    ({ client, config, tokenStore, configSource } = buildClient({}, { profile: values.profile }));
   } catch (err) {
     error(err.message);
     process.exit(1);
@@ -38,7 +38,14 @@ export async function run(values) {
     userInfo = await client.oauth2.getUserInfo();
     await syncTokens(tokenStore, configSource);
   } catch (err) {
-    error(`Failed to fetch user info: ${err.message}`);
+    const status = err?.status;
+    if (status === 502 || status === 503 || status === 504) {
+      error(`ZeyOS instance is temporarily unavailable (HTTP ${status}). The server at ${config.baseUrl} may be down or restarting — this is server-side, not your credentials.`);
+    } else if (status === 401) {
+      error('Your session has expired or is invalid. Re-authenticate with: zeyos login --force');
+    } else {
+      error(`Failed to fetch user info: ${err.message}`);
+    }
     process.exit(1);
   }
 

package/config/actionstep.json

@@ -0,0 +1,21 @@
+{
+  "list": {
+    "fields": {
+      "ID": "ID",
+      "Num": "actionnum",
+      "Name": "name",
+      "Status": "status",
+      "Date": "date",
+      "Due": "duedate",
+      "Effort": "effort",
+      "Ticket": "ticket",
+      "Task": "task",
+      "Account": "account",
+      "Transaction": "transaction"
+    }
+  },
+  "get": {
+    "fields": ["ID", "actionnum", "name", "description", "status", "date", "duedate", "effort", "ticket", "task", "account", "transaction", "assigneduser", "creator", "creationdate", "lastmodified"],
+    "params": { "extdata": 1 }
+  }
+}

package/config/customfield.json

@@ -0,0 +1,17 @@
+{
+  "list": {
+    "fields": {
+      "ID": "ID",
+      "Name": "name",
+      "Identifier": "identifier",
+      "Context": "context",
+      "Reference": "reference",
+      "Type": "type",
+      "Entity": "entity",
+      "Activity": "activity"
+    }
+  },
+  "get": {
+    "fields": ["ID", "name", "identifier", "context", "source", "reference", "indexed", "type", "pattern", "entity", "options", "langaliases", "activity"]
+  }
+}