@totoday/quinn-cli 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @totoday/quinn-cli
 
+## 0.1.3
+
+### Patch Changes
+
+- 16a1fe9: Move organization path handling into the shared HTTP client to simplify service construction.
+- Updated dependencies [16a1fe9]
+  - @totoday/quinn-sdk@0.1.3
+
+## 0.1.2
+
+### Patch Changes
+
+- 629fba0: Unify organization query semantics around `organizations current`:
+  - remove `organizations details` command from CLI
+  - make `organizations current` return organization details with aggregate stats
+  - align SDK and skill documentation with the simplified flow
+- Updated dependencies [45948dc]
+  - @totoday/quinn-sdk@0.1.2
+
 ## 0.1.1
 
 ### Patch Changes
@@ -8,3 +27,4 @@
   - default to interactive hidden password prompt
   - add `--password-stdin` for script-friendly secure input
   - deprecate plain-text `--password` with warning
+  - @totoday/quinn-sdk@0.1.1

package/README.md

@@ -0,0 +1,54 @@
+# @totoday/quinn-cli
+
+Minimal CLI for Quinn auth/config/connectivity setup.
+
+Business data operations should use `@totoday/quinn-sdk`.
+
+## Install
+
+```bash
+npm i -g @totoday/quinn-cli
+quinn --help
+```
+
+One-off without global install:
+
+```bash
+npx @totoday/quinn-cli --help
+```
+
+## Commands
+
+```bash
+# login (recommended: hidden password prompt)
+quinn login --email <email>
+
+# login via stdin (scripts/password managers)
+echo "<password>" | quinn login --email <email> --password-stdin
+
+# inspect local config
+quinn config path
+quinn config get
+
+# update local config
+quinn config set --org-id <orgId>
+quinn config set --api-url <apiUrl> --api-token <token> --org-id <orgId>
+
+# connectivity test (calls organizations.current via SDK)
+quinn test
+```
+
+## Config
+
+CLI reads config from:
+
+- `~/.config/quinn/config.json` (default)
+- `QUINN_CONFIG_PATH` (override)
+
+Runtime override order:
+
+1. command flags
+2. env vars (`QUINN_API_URL`, `QUINN_API_TOKEN`, `QUINN_ORG_ID`)
+3. config file
+
+If `apiUrl` is missing, default is `https://api.lunapark.com`.

package/dist/index.js

@@ -12,25 +12,6 @@ const quinn_sdk_1 = require("@totoday/quinn-sdk");
 function print(data) {
     process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
 }
-function asCsv(raw) {
-    if (!raw) {
-        return [];
-    }
-    return raw
-        .split(',')
-        .map((item) => item.trim())
-        .filter((item) => item.length > 0);
-}
-function asPrivilege(raw) {
-    const values = asCsv(raw);
-    if (values.length === 0) {
-        return undefined;
-    }
-    if (values.length === 1) {
-        return values[0];
-    }
-    return values;
-}
 function maskToken(token) {
     if (!token) {
         return null;
@@ -40,45 +21,6 @@ function maskToken(token) {
     }
     return `${token.slice(0, 6)}...${token.slice(-4)}`;
 }
-function getConfigPath(opts) {
-    return (opts.configPath ||
-        process.env.QUINN_CONFIG_PATH ||
-        node_path_1.default.join(node_os_1.default.homedir(), '.config', 'quinn', 'config.json'));
-}
-function readConfig(configPath) {
-    if (!node_fs_1.default.existsSync(configPath)) {
-        return {};
-    }
-    try {
-        const raw = node_fs_1.default.readFileSync(configPath, 'utf8');
-        const parsed = JSON.parse(raw);
-        return parsed ?? {};
-    }
-    catch {
-        return {};
-    }
-}
-function writeConfig(configPath, config) {
-    node_fs_1.default.mkdirSync(node_path_1.default.dirname(configPath), { recursive: true });
-    node_fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
-}
-function resolveRuntimeConfig(opts, fileConfig) {
-    return {
-        apiUrl: opts.apiUrl || process.env.QUINN_API_URL || fileConfig.apiUrl || quinn_sdk_1.DEFAULT_QUINN_API_URL,
-        token: opts.apiToken || opts.token || process.env.QUINN_API_TOKEN || fileConfig.token,
-        orgId: opts.orgId || process.env.QUINN_ORG_ID || fileConfig.orgId,
-    };
-}
-function createClient(config) {
-    const { apiUrl, token, orgId } = config;
-    if (!token) {
-        throw new Error('missing token: set --api-token/--token or QUINN_API_TOKEN or config');
-    }
-    if (!orgId) {
-        throw new Error('missing orgId: set --org-id or QUINN_ORG_ID or config');
-    }
-    return new quinn_sdk_1.Quinn({ apiUrl, token, orgId });
-}
 function readPasswordFromStdin() {
     const value = node_fs_1.default.readFileSync(0, 'utf8').trim();
     if (!value) {
@@ -133,12 +75,51 @@ async function promptPasswordHidden(prompt = 'Password: ') {
         stdin.on('data', onData);
     });
 }
+function getConfigPath(opts) {
+    return (opts.configPath ||
+        process.env.QUINN_CONFIG_PATH ||
+        node_path_1.default.join(node_os_1.default.homedir(), '.config', 'quinn', 'config.json'));
+}
+function readConfig(configPath) {
+    if (!node_fs_1.default.existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const raw = node_fs_1.default.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfig(configPath, config) {
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(configPath), { recursive: true });
+    node_fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+function resolveRuntimeConfig(opts, fileConfig) {
+    return {
+        apiUrl: opts.apiUrl || process.env.QUINN_API_URL || fileConfig.apiUrl || quinn_sdk_1.DEFAULT_QUINN_API_URL,
+        token: opts.apiToken || opts.token || process.env.QUINN_API_TOKEN || fileConfig.token,
+        orgId: opts.orgId || process.env.QUINN_ORG_ID || fileConfig.orgId,
+    };
+}
+function createClient(config) {
+    const { apiUrl, token, orgId } = config;
+    if (!token) {
+        throw new Error('missing token: set --api-token/--token or QUINN_API_TOKEN or config');
+    }
+    if (!orgId) {
+        throw new Error('missing orgId: set --org-id or QUINN_ORG_ID or config');
+    }
+    return new quinn_sdk_1.Quinn({ apiUrl, token, orgId });
+}
 function getContext(command) {
     const global = command.optsWithGlobals();
     const configPath = getConfigPath(global);
     const fileConfig = readConfig(configPath);
     const runtimeConfig = resolveRuntimeConfig(global, fileConfig);
-    return { global, configPath, fileConfig, runtimeConfig };
+    return { configPath, fileConfig, runtimeConfig };
 }
 async function withHandler(fn) {
     try {
@@ -179,16 +160,14 @@ async function withHandler(fn) {
 const program = new commander_1.Command();
 program
     .name('quinn')
-    .description('Quinn CLI')
+    .description('Quinn CLI (minimal setup utility, SDK-first runtime)')
     .addHelpText('after', [
     '',
     'Examples:',
     '  quinn login --email <email>',
     '  echo "<password>" | quinn login --email <email> --password-stdin',
-    '  quinn config set --api-url http://localhost:8090 --api-token <token> --org-id <orgId>',
-    '  quinn organizations details',
-    '  quinn members find alice',
-    '  quinn members get user-1,user-2,user@example.com',
+    '  quinn config get',
+    '  quinn test',
 ].join('\n'))
     .showHelpAfterError()
     .option('--config-path <path>', 'config file path (default ~/.config/quinn/config.json)')
@@ -248,13 +227,6 @@ configCmd
         },
     });
 });
-configCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn config path',
-    '  quinn config get',
-    '  quinn config set --api-url http://localhost:8090 --api-token <token> --org-id <orgId>',
-].join('\n'));
 program
     .command('login')
     .description('login and save token (+orgId) into config (password input is hidden by default)')
@@ -279,14 +251,8 @@ program
         else {
             password = await promptPasswordHidden();
         }
-        const auth = new quinn_sdk_1.QuinnAuth({
-            apiUrl: runtimeConfig.apiUrl,
-            configPath,
-        });
-        const login = await auth.login({
-            email: opts.email,
-            password,
-        });
+        const auth = new quinn_sdk_1.QuinnAuth({ apiUrl: runtimeConfig.apiUrl, configPath });
+        const login = await auth.login({ email: opts.email, password });
         const resolvedOrgId = opts.orgId || login.orgId || fileConfig.orgId;
         if (!resolvedOrgId) {
             throw new Error('orgId not found in login response, please pass --org-id');
@@ -308,303 +274,17 @@ program
         });
     });
 });
-const orgCmd = program
-    .command('organizations')
-    .description('organization metadata and high-level stats');
-orgCmd
-    .command('current')
-    .description('get current organization basic info (id, name)')
-    .action(function () {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.organizations.current());
-    });
-});
-orgCmd
-    .command('details')
-    .description('get organization details with aggregate stats')
+program
+    .command('test')
+    .description('test connectivity and auth by calling organizations.current()')
     .action(function () {
     return withHandler(async () => {
         const { runtimeConfig } = getContext(this);
         const quinn = createClient(runtimeConfig);
-        print(await quinn.organizations.getDetails());
+        const item = await quinn.organizations.current();
+        print({ ok: true, item });
     });
 });
-orgCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn organizations current',
-    '  quinn organizations details',
-].join('\n'));
-const membersCmd = program.command('members').description('member operations');
-membersCmd
-    .command('list')
-    .description('list members with structured filters (no keyword search)')
-    .option('--privilege <value>', 'filter by privilege: owner|admin|member, supports comma-separated')
-    .option('--manager-uid <uid>', 'filter by manager UID')
-    .option('--limit <n>', 'page size')
-    .option('--page-token <token>', 'pagination token from previous page')
-    .action(function (opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.members.list({
-            privilege: asPrivilege(opts.privilege),
-            managerUid: opts.managerUid,
-            limit: opts.limit ? Number(opts.limit) : undefined,
-            token: opts.pageToken,
-        }));
-    });
-});
-membersCmd
-    .command('find')
-    .description('find members by keyword (name/email fuzzy search)')
-    .argument('<query>')
-    .option('--limit <n>', 'page size')
-    .option('--page-token <token>', 'pagination token from previous page')
-    .action(function (query, opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.members.list({
-            search: query,
-            limit: opts.limit ? Number(opts.limit) : undefined,
-            token: opts.pageToken,
-        }));
-    });
-});
-membersCmd
-    .command('list-managers')
-    .description('list unique manager members in the organization')
-    .option('--search <text>', 'optional keyword filter on manager name/email')
-    .option('--limit <n>', 'page size')
-    .option('--page-token <token>', 'pagination token from previous page')
-    .action(function (opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.members.listManagers({
-            search: opts.search,
-            limit: opts.limit ? Number(opts.limit) : undefined,
-            token: opts.pageToken,
-        }));
-    });
-});
-membersCmd
-    .command('get')
-    .description('get one member by ID/email, or many members by comma-separated values')
-    .argument('<memberIdOrEmail>')
-    .action(function (memberIdOrEmail) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        const values = asCsv(memberIdOrEmail);
-        if (values.length <= 1) {
-            print(await quinn.members.get(memberIdOrEmail));
-            return;
-        }
-        const ids = [];
-        const emails = [];
-        for (const value of values) {
-            if (value.includes('@')) {
-                emails.push(value);
-            }
-            else {
-                ids.push(value);
-            }
-        }
-        print(await quinn.members.batchGet({
-            ids: ids.length > 0 ? ids : undefined,
-            emails: emails.length > 0 ? emails : undefined,
-        }));
-    });
-});
-membersCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn members list --privilege owner,admin',
-    '  quinn members list --manager-uid <uid>',
-    '  quinn members find alice',
-    '  quinn members list-managers --search bob',
-    '  quinn members get <memberId>',
-    '  quinn members get <memberId1,memberId2,user@example.com>',
-].join('\n'));
-const rolesCmd = program.command('roles').description('role operations');
-rolesCmd.command('list').description('list all roles in the organization').action(function () {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.roles.list());
-    });
-});
-rolesCmd
-    .command('get')
-    .description('get one role by ID, or many roles by comma-separated values')
-    .argument('<roleId>')
-    .action(function (roleId) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        const values = asCsv(roleId);
-        if (values.length <= 1) {
-            print(await quinn.roles.get(roleId));
-            return;
-        }
-        print(await quinn.roles.batchGet(values));
-    });
-});
-rolesCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn roles list',
-    '  quinn roles get <roleId>',
-    '  quinn roles get <roleId1,roleId2>',
-].join('\n'));
-const levelsCmd = program.command('levels').description('level operations');
-levelsCmd
-    .command('list')
-    .description('list levels under a role')
-    .requiredOption('--role-id <id>', 'role ID to scope the query')
-    .option('--limit <n>', 'page size')
-    .option('--page-token <token>', 'pagination token from previous page')
-    .action(function (opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.levels.list({
-            roleId: opts.roleId,
-            limit: opts.limit ? Number(opts.limit) : undefined,
-            token: opts.pageToken,
-        }));
-    });
-});
-levelsCmd
-    .command('get')
-    .description('get one level by ID, or many levels by comma-separated values')
-    .argument('<levelId>')
-    .action(function (levelId) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        const values = asCsv(levelId);
-        if (values.length <= 1) {
-            print(await quinn.levels.get(levelId));
-            return;
-        }
-        print(await quinn.levels.batchGet(values));
-    });
-});
-levelsCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn levels list --role-id <roleId>',
-    '  quinn levels get <levelId>',
-    '  quinn levels get <levelId1,levelId2>',
-].join('\n'));
-const compsCmd = program.command('competencies').description('competency operations');
-compsCmd
-    .command('list')
-    .description('list competencies scoped by role + level')
-    .requiredOption('--role-id <id>', 'role ID')
-    .requiredOption('--level-id <id>', 'level ID')
-    .option('--search <text>', 'optional keyword filter')
-    .option('--limit <n>', 'page size')
-    .option('--page-token <token>', 'pagination token from previous page')
-    .action(function (opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.competencies.list({
-            roleId: opts.roleId,
-            levelId: opts.levelId,
-            search: opts.search,
-            limit: opts.limit ? Number(opts.limit) : undefined,
-            token: opts.pageToken,
-        }));
-    });
-});
-compsCmd
-    .command('get')
-    .description('get one competency by ID, or many competencies by comma-separated values')
-    .argument('<competencyId>')
-    .action(function (competencyId) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        const values = asCsv(competencyId);
-        if (values.length <= 1) {
-            print(await quinn.competencies.get(competencyId));
-            return;
-        }
-        print(await quinn.competencies.batchGet(values));
-    });
-});
-compsCmd
-    .command('courses')
-    .description('list courses under a competency')
-    .argument('<competencyId>')
-    .action(function (competencyId) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.competencies.listCourses(competencyId));
-    });
-});
-compsCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn competencies list --role-id <roleId> --level-id <levelId>',
-    '  quinn competencies get <competencyId>',
-    '  quinn competencies get <id1,id2>',
-    '  quinn competencies courses <competencyId>',
-].join('\n'));
-const endorseCmd = program.command('endorsements').description('endorsement operations');
-endorseCmd
-    .command('get')
-    .description('get one endorsement by ID')
-    .argument('<endorsementId>')
-    .action(function (endorsementId) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.endorsements.get(endorsementId));
-    });
-});
-endorseCmd
-    .command('find')
-    .description('find one endorsement by user + competency')
-    .requiredOption('--uid <uid>', 'user ID')
-    .requiredOption('--competency-id <id>', 'competency ID')
-    .action(function (opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.endorsements.find(opts.uid, opts.competencyId));
-    });
-});
-endorseCmd
-    .command('list')
-    .description('list endorsements by user IDs and competency IDs')
-    .requiredOption('--uids <uids>', 'comma-separated user IDs')
-    .requiredOption('--competency-ids <ids>', 'comma-separated competency IDs')
-    .action(function (opts) {
-    return withHandler(async () => {
-        const { runtimeConfig } = getContext(this);
-        const quinn = createClient(runtimeConfig);
-        print(await quinn.endorsements.list({
-            uids: asCsv(opts.uids),
-            competencyIds: asCsv(opts.competencyIds),
-        }));
-    });
-});
-endorseCmd.addHelpText('after', [
-    '',
-    'Examples:',
-    '  quinn endorsements get <endorsementId>',
-    '  quinn endorsements find --uid <uid> --competency-id <competencyId>',
-    '  quinn endorsements list --uids <u1,u2> --competency-ids <c1,c2>',
-].join('\n'));
 program.parseAsync(process.argv).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
     process.stderr.write(`${message}\n`);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@totoday/quinn-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "bin": {
     "quinn": "dist/index.js"
   },
   "dependencies": {
     "commander": "^13.1.0",
-    "@totoday/quinn-sdk": "0.1.0"
+    "@totoday/quinn-sdk": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.13.10",

package/src/index.ts

@@ -4,7 +4,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { Command } from 'commander';
-import { DEFAULT_QUINN_API_URL, Quinn, QuinnAuth, Privilege } from '@totoday/quinn-sdk';
+import { DEFAULT_QUINN_API_URL, Quinn, QuinnAuth } from '@totoday/quinn-sdk';
 
 type QuinnCliConfig = {
   apiUrl?: string;
@@ -24,27 +24,6 @@ function print(data: unknown): void {
   process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
 }
 
-function asCsv(raw?: string): string[] {
-  if (!raw) {
-    return [];
-  }
-  return raw
-    .split(',')
-    .map((item) => item.trim())
-    .filter((item) => item.length > 0);
-}
-
-function asPrivilege(raw?: string): Privilege | Privilege[] | undefined {
-  const values = asCsv(raw);
-  if (values.length === 0) {
-    return undefined;
-  }
-  if (values.length === 1) {
-    return values[0] as Privilege;
-  }
-  return values as Privilege[];
-}
-
 function maskToken(token?: string): string | null {
   if (!token) {
     return null;
@@ -55,51 +34,6 @@ function maskToken(token?: string): string | null {
   return `${token.slice(0, 6)}...${token.slice(-4)}`;
 }
 
-function getConfigPath(opts: GlobalOptions): string {
-  return (
-    opts.configPath ||
-    process.env.QUINN_CONFIG_PATH ||
-    path.join(os.homedir(), '.config', 'quinn', 'config.json')
-  );
-}
-
-function readConfig(configPath: string): QuinnCliConfig {
-  if (!fs.existsSync(configPath)) {
-    return {};
-  }
-  try {
-    const raw = fs.readFileSync(configPath, 'utf8');
-    const parsed = JSON.parse(raw) as QuinnCliConfig;
-    return parsed ?? {};
-  } catch {
-    return {};
-  }
-}
-
-function writeConfig(configPath: string, config: QuinnCliConfig): void {
-  fs.mkdirSync(path.dirname(configPath), { recursive: true });
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-}
-
-function resolveRuntimeConfig(opts: GlobalOptions, fileConfig: QuinnCliConfig): QuinnCliConfig {
-  return {
-    apiUrl: opts.apiUrl || process.env.QUINN_API_URL || fileConfig.apiUrl || DEFAULT_QUINN_API_URL,
-    token: opts.apiToken || opts.token || process.env.QUINN_API_TOKEN || fileConfig.token,
-    orgId: opts.orgId || process.env.QUINN_ORG_ID || fileConfig.orgId,
-  };
-}
-
-function createClient(config: QuinnCliConfig): Quinn {
-  const { apiUrl, token, orgId } = config;
-  if (!token) {
-    throw new Error('missing token: set --api-token/--token or QUINN_API_TOKEN or config');
-  }
-  if (!orgId) {
-    throw new Error('missing orgId: set --org-id or QUINN_ORG_ID or config');
-  }
-  return new Quinn({ apiUrl, token, orgId });
-}
-
 function readPasswordFromStdin(): string {
   const value = fs.readFileSync(0, 'utf8').trim();
   if (!value) {
@@ -163,8 +97,52 @@ async function promptPasswordHidden(prompt = 'Password: '): Promise<string> {
   });
 }
 
+function getConfigPath(opts: GlobalOptions): string {
+  return (
+    opts.configPath ||
+    process.env.QUINN_CONFIG_PATH ||
+    path.join(os.homedir(), '.config', 'quinn', 'config.json')
+  );
+}
+
+function readConfig(configPath: string): QuinnCliConfig {
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  try {
+    const raw = fs.readFileSync(configPath, 'utf8');
+    const parsed = JSON.parse(raw) as QuinnCliConfig;
+    return parsed ?? {};
+  } catch {
+    return {};
+  }
+}
+
+function writeConfig(configPath: string, config: QuinnCliConfig): void {
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+
+function resolveRuntimeConfig(opts: GlobalOptions, fileConfig: QuinnCliConfig): QuinnCliConfig {
+  return {
+    apiUrl: opts.apiUrl || process.env.QUINN_API_URL || fileConfig.apiUrl || DEFAULT_QUINN_API_URL,
+    token: opts.apiToken || opts.token || process.env.QUINN_API_TOKEN || fileConfig.token,
+    orgId: opts.orgId || process.env.QUINN_ORG_ID || fileConfig.orgId,
+  };
+}
+
+function createClient(config: QuinnCliConfig): Quinn {
+  const { apiUrl, token, orgId } = config;
+  if (!token) {
+    throw new Error('missing token: set --api-token/--token or QUINN_API_TOKEN or config');
+  }
+  if (!orgId) {
+    throw new Error('missing orgId: set --org-id or QUINN_ORG_ID or config');
+  }
+  return new Quinn({ apiUrl, token, orgId });
+}
+
 function getContext(command: Command): {
-  global: GlobalOptions;
   configPath: string;
   fileConfig: QuinnCliConfig;
   runtimeConfig: QuinnCliConfig;
@@ -173,7 +151,7 @@ function getContext(command: Command): {
   const configPath = getConfigPath(global);
   const fileConfig = readConfig(configPath);
   const runtimeConfig = resolveRuntimeConfig(global, fileConfig);
-  return { global, configPath, fileConfig, runtimeConfig };
+  return { configPath, fileConfig, runtimeConfig };
 }
 
 async function withHandler(fn: () => Promise<void>): Promise<void> {
@@ -219,7 +197,7 @@ async function withHandler(fn: () => Promise<void>): Promise<void> {
 const program = new Command();
 program
   .name('quinn')
-  .description('Quinn CLI')
+  .description('Quinn CLI (minimal setup utility, SDK-first runtime)')
   .addHelpText(
     'after',
     [
@@ -227,10 +205,8 @@ program
       'Examples:',
       '  quinn login --email <email>',
       '  echo "<password>" | quinn login --email <email> --password-stdin',
-      '  quinn config set --api-url http://localhost:8090 --api-token <token> --org-id <orgId>',
-      '  quinn organizations details',
-      '  quinn members find alice',
-      '  quinn members get user-1,user-2,user@example.com',
+      '  quinn config get',
+      '  quinn test',
     ].join('\n')
   )
   .showHelpAfterError()
@@ -294,16 +270,6 @@ configCmd
       },
     });
   });
-configCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn config path',
-    '  quinn config get',
-    '  quinn config set --api-url http://localhost:8090 --api-token <token> --org-id <orgId>',
-  ].join('\n')
-);
 
 program
   .command('login')
@@ -329,14 +295,8 @@ program
       } else {
         password = await promptPasswordHidden();
       }
-      const auth = new QuinnAuth({
-        apiUrl: runtimeConfig.apiUrl,
-        configPath,
-      });
-      const login = await auth.login({
-        email: opts.email,
-        password,
-      });
+      const auth = new QuinnAuth({ apiUrl: runtimeConfig.apiUrl, configPath });
+      const login = await auth.login({ email: opts.email, password });
       const resolvedOrgId = opts.orgId || login.orgId || fileConfig.orgId;
       if (!resolvedOrgId) {
         throw new Error('orgId not found in login response, please pass --org-id');
@@ -359,350 +319,17 @@ program
     });
   });
 
-const orgCmd = program
-  .command('organizations')
-  .description('organization metadata and high-level stats');
-orgCmd
-  .command('current')
-  .description('get current organization basic info (id, name)')
-  .action(function () {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(await quinn.organizations.current());
-    });
-  });
-
-orgCmd
-  .command('details')
-  .description('get organization details with aggregate stats')
+program
+  .command('test')
+  .description('test connectivity and auth by calling organizations.current()')
   .action(function () {
     return withHandler(async () => {
       const { runtimeConfig } = getContext(this);
       const quinn = createClient(runtimeConfig);
-      print(await quinn.organizations.getDetails());
-    });
-  });
-orgCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn organizations current',
-    '  quinn organizations details',
-  ].join('\n')
-);
-
-const membersCmd = program.command('members').description('member operations');
-membersCmd
-  .command('list')
-  .description('list members with structured filters (no keyword search)')
-  .option('--privilege <value>', 'filter by privilege: owner|admin|member, supports comma-separated')
-  .option('--manager-uid <uid>', 'filter by manager UID')
-  .option('--limit <n>', 'page size')
-  .option('--page-token <token>', 'pagination token from previous page')
-  .action(function (opts: { privilege?: string; managerUid?: string; limit?: string; pageToken?: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(
-        await quinn.members.list({
-          privilege: asPrivilege(opts.privilege),
-          managerUid: opts.managerUid,
-          limit: opts.limit ? Number(opts.limit) : undefined,
-          token: opts.pageToken,
-        })
-      );
-    });
-  });
-
-membersCmd
-  .command('find')
-  .description('find members by keyword (name/email fuzzy search)')
-  .argument('<query>')
-  .option('--limit <n>', 'page size')
-  .option('--page-token <token>', 'pagination token from previous page')
-  .action(function (query: string, opts: { limit?: string; pageToken?: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(
-        await quinn.members.list({
-          search: query,
-          limit: opts.limit ? Number(opts.limit) : undefined,
-          token: opts.pageToken,
-        })
-      );
-    });
-  });
-
-membersCmd
-  .command('list-managers')
-  .description('list unique manager members in the organization')
-  .option('--search <text>', 'optional keyword filter on manager name/email')
-  .option('--limit <n>', 'page size')
-  .option('--page-token <token>', 'pagination token from previous page')
-  .action(function (opts: { search?: string; limit?: string; pageToken?: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(
-        await quinn.members.listManagers({
-          search: opts.search,
-          limit: opts.limit ? Number(opts.limit) : undefined,
-          token: opts.pageToken,
-        })
-      );
-    });
-  });
-
-membersCmd
-  .command('get')
-  .description('get one member by ID/email, or many members by comma-separated values')
-  .argument('<memberIdOrEmail>')
-  .action(function (memberIdOrEmail: string) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      const values = asCsv(memberIdOrEmail);
-      if (values.length <= 1) {
-        print(await quinn.members.get(memberIdOrEmail));
-        return;
-      }
-
-      const ids: string[] = [];
-      const emails: string[] = [];
-      for (const value of values) {
-        if (value.includes('@')) {
-          emails.push(value);
-        } else {
-          ids.push(value);
-        }
-      }
-      print(
-        await quinn.members.batchGet({
-          ids: ids.length > 0 ? ids : undefined,
-          emails: emails.length > 0 ? emails : undefined,
-        })
-      );
-    });
-  });
-membersCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn members list --privilege owner,admin',
-    '  quinn members list --manager-uid <uid>',
-    '  quinn members find alice',
-    '  quinn members list-managers --search bob',
-    '  quinn members get <memberId>',
-    '  quinn members get <memberId1,memberId2,user@example.com>',
-  ].join('\n')
-);
-
-const rolesCmd = program.command('roles').description('role operations');
-rolesCmd.command('list').description('list all roles in the organization').action(function () {
-  return withHandler(async () => {
-    const { runtimeConfig } = getContext(this);
-    const quinn = createClient(runtimeConfig);
-    print(await quinn.roles.list());
-  });
-});
-
-rolesCmd
-  .command('get')
-  .description('get one role by ID, or many roles by comma-separated values')
-  .argument('<roleId>')
-  .action(function (roleId: string) {
-  return withHandler(async () => {
-    const { runtimeConfig } = getContext(this);
-    const quinn = createClient(runtimeConfig);
-    const values = asCsv(roleId);
-    if (values.length <= 1) {
-      print(await quinn.roles.get(roleId));
-      return;
-    }
-    print(await quinn.roles.batchGet(values));
-  });
-});
-rolesCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn roles list',
-    '  quinn roles get <roleId>',
-    '  quinn roles get <roleId1,roleId2>',
-  ].join('\n')
-);
-
-const levelsCmd = program.command('levels').description('level operations');
-levelsCmd
-  .command('list')
-  .description('list levels under a role')
-  .requiredOption('--role-id <id>', 'role ID to scope the query')
-  .option('--limit <n>', 'page size')
-  .option('--page-token <token>', 'pagination token from previous page')
-  .action(function (opts: { roleId: string; limit?: string; pageToken?: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(
-        await quinn.levels.list({
-          roleId: opts.roleId,
-          limit: opts.limit ? Number(opts.limit) : undefined,
-          token: opts.pageToken,
-        })
-      );
-    });
-  });
-
-levelsCmd
-  .command('get')
-  .description('get one level by ID, or many levels by comma-separated values')
-  .argument('<levelId>')
-  .action(function (levelId: string) {
-  return withHandler(async () => {
-    const { runtimeConfig } = getContext(this);
-    const quinn = createClient(runtimeConfig);
-    const values = asCsv(levelId);
-    if (values.length <= 1) {
-      print(await quinn.levels.get(levelId));
-      return;
-    }
-    print(await quinn.levels.batchGet(values));
-  });
-});
-levelsCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn levels list --role-id <roleId>',
-    '  quinn levels get <levelId>',
-    '  quinn levels get <levelId1,levelId2>',
-  ].join('\n')
-);
-
-const compsCmd = program.command('competencies').description('competency operations');
-compsCmd
-  .command('list')
-  .description('list competencies scoped by role + level')
-  .requiredOption('--role-id <id>', 'role ID')
-  .requiredOption('--level-id <id>', 'level ID')
-  .option('--search <text>', 'optional keyword filter')
-  .option('--limit <n>', 'page size')
-  .option('--page-token <token>', 'pagination token from previous page')
-  .action(function (opts: { roleId: string; levelId: string; search?: string; limit?: string; pageToken?: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(
-        await quinn.competencies.list({
-          roleId: opts.roleId,
-          levelId: opts.levelId,
-          search: opts.search,
-          limit: opts.limit ? Number(opts.limit) : undefined,
-          token: opts.pageToken,
-        })
-      );
-    });
-  });
-
-compsCmd
-  .command('get')
-  .description('get one competency by ID, or many competencies by comma-separated values')
-  .argument('<competencyId>')
-  .action(function (competencyId: string) {
-  return withHandler(async () => {
-    const { runtimeConfig } = getContext(this);
-    const quinn = createClient(runtimeConfig);
-    const values = asCsv(competencyId);
-    if (values.length <= 1) {
-      print(await quinn.competencies.get(competencyId));
-      return;
-    }
-    print(await quinn.competencies.batchGet(values));
-  });
-});
-
-compsCmd
-  .command('courses')
-  .description('list courses under a competency')
-  .argument('<competencyId>')
-  .action(function (competencyId: string) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(await quinn.competencies.listCourses(competencyId));
-    });
-  });
-compsCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn competencies list --role-id <roleId> --level-id <levelId>',
-    '  quinn competencies get <competencyId>',
-    '  quinn competencies get <id1,id2>',
-    '  quinn competencies courses <competencyId>',
-  ].join('\n')
-);
-
-const endorseCmd = program.command('endorsements').description('endorsement operations');
-endorseCmd
-  .command('get')
-  .description('get one endorsement by ID')
-  .argument('<endorsementId>')
-  .action(function (endorsementId: string) {
-  return withHandler(async () => {
-    const { runtimeConfig } = getContext(this);
-    const quinn = createClient(runtimeConfig);
-    print(await quinn.endorsements.get(endorsementId));
-  });
-  });
-
-endorseCmd
-  .command('find')
-  .description('find one endorsement by user + competency')
-  .requiredOption('--uid <uid>', 'user ID')
-  .requiredOption('--competency-id <id>', 'competency ID')
-  .action(function (opts: { uid: string; competencyId: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(await quinn.endorsements.find(opts.uid, opts.competencyId));
-    });
-  });
-
-endorseCmd
-  .command('list')
-  .description('list endorsements by user IDs and competency IDs')
-  .requiredOption('--uids <uids>', 'comma-separated user IDs')
-  .requiredOption('--competency-ids <ids>', 'comma-separated competency IDs')
-  .action(function (opts: { uids: string; competencyIds: string }) {
-    return withHandler(async () => {
-      const { runtimeConfig } = getContext(this);
-      const quinn = createClient(runtimeConfig);
-      print(
-        await quinn.endorsements.list({
-          uids: asCsv(opts.uids),
-          competencyIds: asCsv(opts.competencyIds),
-        })
-      );
+      const item = await quinn.organizations.current();
+      print({ ok: true, item });
     });
   });
-endorseCmd.addHelpText(
-  'after',
-  [
-    '',
-    'Examples:',
-    '  quinn endorsements get <endorsementId>',
-    '  quinn endorsements find --uid <uid> --competency-id <competencyId>',
-    '  quinn endorsements list --uids <u1,u2> --competency-ids <c1,c2>',
-  ].join('\n')
-);
 
 program.parseAsync(process.argv).catch((error: unknown) => {
   const message = error instanceof Error ? error.message : String(error);