@zeyos/cli 0.2.0 → 0.4.0

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/update.mjs

@@ -56,7 +56,7 @@ 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;

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"]
+  }
+}

package/config/message.json

@@ -0,0 +1,20 @@
+{
+  "list": {
+    "fields": {
+      "ID": "ID",
+      "Date": "date",
+      "Mailbox": "mailbox",
+      "Subject": "subject",
+      "From": "sender_email",
+      "To": "to_email",
+      "Ticket": "ticket",
+      "Opportunity": "opportunity",
+      "Reference": "reference",
+      "Message-ID": "messageid"
+    }
+  },
+  "get": {
+    "fields": ["ID", "date", "mailbox", "subject", "sender", "sender_email", "sender_name", "to", "to_email", "to_name", "cc", "bcc", "ticket", "opportunity", "reference", "messageid", "contenttype", "text", "attachments", "senddate", "senderror", "creationdate", "lastmodified"],
+    "params": { "extdata": 1 }
+  }
+}

package/config/task.json

@@ -8,11 +8,13 @@
       "Priority": "priority",
       "Agent": "assigneduser.name",
       "Due": "duedate",
-      "Ticket": "ticket"
+      "Ticket": "ticket",
+      "Project": "project",
+      "Projected": "projectedeffort"
     }
   },
   "get": {
-    "fields": ["ID", "tasknum", "name", "description", "status", "priority", "duedate", "ticket", "creator", "created", "lastmodified"],
+    "fields": ["ID", "tasknum", "name", "description", "status", "priority", "datefrom", "duedate", "ticket", "project", "projectedeffort", "assigneduser", "creator", "creationdate", "lastmodified"],
     "params": { "extdata": 1 }
   }
 }

package/config/ticket.json

@@ -7,13 +7,14 @@
       "Status": "status",
       "Priority": "priority",
       "Account": "account.lastname",
+      "Project": "project",
       "Agent": "assigneduser.name",
       "Due": "duedate",
       "Modified": "lastmodified"
     }
   },
   "get": {
-    "fields": ["ID", "ticketnum", "name", "description", "status", "priority", "duedate", "created", "creator", "lastmodified"],
+    "fields": ["ID", "ticketnum", "name", "description", "status", "priority", "duedate", "account", "project", "assigneduser", "creator", "creationdate", "lastmodified"],
     "params": { "extdata": 1 }
   }
 }

package/lib/client.mjs

@@ -3,7 +3,7 @@
  * Also provides a helper that persists refreshed tokens back to the config file.
  */
 import { createZeyosClient, MemoryTokenStore } from '@zeyos/client';
-import { loadConfigWithSource, saveConfig, requireConfig } from './config.mjs';
+import { loadConfigWithSource, persistTokens, requireConfig, listProfiles } from './config.mjs';
 
 /** @typedef {import('./types.mjs').CliConfig} CliConfig */
 
@@ -12,10 +12,16 @@ import { loadConfigWithSource, saveConfig, requireConfig } from './config.mjs';
  * Throws a friendly error if required config keys are missing.
  *
  * @param {CliConfig} [overrides]  Extra config values (e.g. from CLI flags)
- * @returns {{ client: ReturnType<typeof createZeyosClient>, config: CliConfig, tokenStore: MemoryTokenStore, configSource: 'local'|'global'|null }}
+ * @param {{ profile?: string }} [opts]  Profile selector (from --profile / ZEYOS_PROFILE)
+ * @returns {{ client: ReturnType<typeof createZeyosClient>, config: CliConfig, tokenStore: MemoryTokenStore, configSource: import('./config.mjs').ConfigSource|null }}
  */
-export function buildClient(overrides = {}) {
-  const loaded = loadConfigWithSource();
+export function buildClient(overrides = {}, opts = {}) {
+  const loaded = loadConfigWithSource({ profile: opts.profile });
+  if (loaded.profile?.missing) {
+    const names = Object.keys(listProfiles().profiles);
+    const known = names.length ? `Known profiles: ${names.join(', ')}.` : 'No profiles defined yet — create one with `zeyos profile add <name>`.';
+    throw new Error(`Profile "${loaded.profile.name}" not found (selected via ${loaded.profile.origin}). ${known}`);
+  }
   const config = { ...loaded.config, ...overrides };
   requireConfig(['baseUrl', 'clientId', 'clientSecret', 'accessToken'], config);
 
@@ -43,25 +49,28 @@ export function buildClient(overrides = {}) {
 }
 
 /**
- * Persist any refreshed tokens back to the credential store.
+ * Persist any refreshed tokens back to the credential store the config came from
+ * (a named profile, the legacy local auth.json, or the legacy global file).
  * Call this after API operations to keep tokens up-to-date.
  *
  * @param {MemoryTokenStore} tokenStore
- * @param {'local'|'global'|null} scope
+ * @param {import('./config.mjs').ConfigSource|'local'|'global'|null} source
  */
-export async function syncTokens(tokenStore, scope = 'local') {
-  if (!scope) {
+export async function syncTokens(tokenStore, source = 'local') {
+  if (!source) {
     return;
   }
+  // Back-compat: a bare 'local'/'global' string still works.
+  const resolved = typeof source === 'string' ? { kind: source } : source;
   try {
     const ts = await tokenStore.get();
     if (ts?.accessToken) {
-      saveConfig({
+      persistTokens(resolved, {
         accessToken:           ts.accessToken,
         refreshToken:          ts.refreshToken,
         expiresAt:             ts.expiresAt,
         refreshTokenExpiresAt: ts.refreshTokenExpiresAt,
-      }, scope);
+      });
     }
   } catch {
     // non-critical

package/lib/command.mjs

@@ -33,9 +33,9 @@ export function requireRecordId(id, usage) {
   }
 }
 
-export function buildCliClient() {
+export function buildCliClient(values = {}) {
   try {
-    return buildClient();
+    return buildClient({}, { profile: values.profile });
   } catch (err) {
     fail(err.message);
   }