@totoday/quinn-cli 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @totoday/quinn-cli
 
+## 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
+  - @totoday/quinn-sdk@0.1.2
+
 ## 0.1.1
 
 ### Patch Changes
@@ -8,3 +18,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,69 @@
+# @totoday/quinn-cli
+
+CLI for Quinn organization/member/role/competency queries.
+
+## Install
+
+```bash
+npm i -g @totoday/quinn-cli
+quinn --help
+```
+
+One-off without global install:
+
+```bash
+npx @totoday/quinn-cli --help
+```
+
+## Quick Start
+
+Login (recommended: hidden password prompt):
+
+```bash
+quinn login --email <email>
+```
+
+Login via stdin (scripts/password managers):
+
+```bash
+echo "<password>" | quinn login --email <email> --password-stdin
+```
+
+Check organization:
+
+```bash
+quinn organizations current
+```
+
+## Common Commands
+
+```bash
+# members
+quinn members find alice
+quinn members list --privilege owner,admin
+quinn members get <memberId1,memberId2,user@example.com>
+
+# roles / levels / competencies
+quinn roles list
+quinn levels list --role-id <roleId>
+quinn competencies list --role-id <roleId> --level-id <levelId>
+
+# endorsements
+quinn endorsements find --uid <uid> --competency-id <competencyId>
+quinn endorsements list --uids <u1,u2> --competency-ids <c1,c2>
+```
+
+## 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

@@ -186,7 +186,7 @@ program
     '  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 organizations current',
     '  quinn members find alice',
     '  quinn members get user-1,user-2,user@example.com',
 ].join('\n'))
@@ -313,7 +313,7 @@ const orgCmd = program
     .description('organization metadata and high-level stats');
 orgCmd
     .command('current')
-    .description('get current organization basic info (id, name)')
+    .description('get current organization details with aggregate stats')
     .action(function () {
     return withHandler(async () => {
         const { runtimeConfig } = getContext(this);
@@ -321,21 +321,10 @@ orgCmd
         print(await quinn.organizations.current());
     });
 });
-orgCmd
-    .command('details')
-    .description('get organization details with aggregate stats')
-    .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

package/package.json

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

package/src/index.ts

@@ -228,7 +228,7 @@ program
       '  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 organizations current',
       '  quinn members find alice',
       '  quinn members get user-1,user-2,user@example.com',
     ].join('\n')
@@ -364,7 +364,7 @@ const orgCmd = program
   .description('organization metadata and high-level stats');
 orgCmd
   .command('current')
-  .description('get current organization basic info (id, name)')
+  .description('get current organization details with aggregate stats')
   .action(function () {
     return withHandler(async () => {
       const { runtimeConfig } = getContext(this);
@@ -372,24 +372,12 @@ orgCmd
       print(await quinn.organizations.current());
     });
   });
-
-orgCmd
-  .command('details')
-  .description('get organization details with aggregate stats')
-  .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')
 );