@scalequality/cli 0.1.0 → 0.3.0

package/README.md

@@ -1,16 +1,65 @@
 # @scalequality/cli
 
 Run the ScaleQuality AI Workspace coding engine on your own machine, in your
-repository folder. The conversation stays in the browser; the files, the
+repository folders. The conversation stays in the browser; the files, the
 commands and the git working tree stay on your computer.
 
+## Connect this computer (recommended)
+
+```bash
+npx @scalequality/cli login          # prints a code; confirm it in ScaleQuality
+npx @scalequality/cli add ~/code/app # a folder the AI Workspace may use
+npx @scalequality/cli up             # keep the computer connected
+```
+
+`login` prints a code and an address (`<ScaleQuality>/devices?code=XXXX-XXXX`).
+Open it while signed in to ScaleQuality and confirm the code; the computer is
+then yours, in that organization, and `login` goes on running `up`. Only
+confirm a code you started yourself.
+
+| Command | What it does |
+|---------|--------------|
+| `scalequality login [--api URL] [--name NAME] [--no-up]` | Connects this computer (device code, like signing in to a TV app). |
+| `scalequality up [--api URL] [--verbose]` | Keeps it connected: sessions started in the AI Workspace run here, in your folders. Ctrl+C disconnects. |
+| `scalequality add [PATH]` | Adds a folder (default: the current one). Only folders inside your home folder, never the home folder itself. |
+| `scalequality logout [--api URL]` | Disconnects this computer in ScaleQuality and deletes the local credential. |
+
+The credential is stored in `~/.scalequality/credentials.json`, readable only
+by you (mode 0600), one entry per ScaleQuality address; ScaleQuality keeps only
+its hash. It opens only this computer's queue: each session gets its own
+one-time secret, and no repository token is ever sent to your computer. You can
+also disconnect the computer from the AI Workspace.
+
+While `up` runs, the AI Workspace can:
+
+- start a session in one of your folders (at most 3 at once);
+- add a folder you pick there (it is checked here: it must exist, be inside
+  your home folder and not be the home folder);
+- list your Claude Code (`~/.claude/projects`) and Codex (`~/.codex/sessions`)
+  conversations, and import the ones you choose. Secrets (cloud keys, provider
+  tokens, private keys, JWTs, connection strings, `password=`-style values) are
+  removed on this computer before anything is sent, and the list itself goes
+  without them. Only text is imported; tool results are left out and each tool
+  call becomes a one-line summary.
+
+A Claude Code conversation continued on the same computer and folder resumes
+from its own transcript: a copy without secrets is written into the engine's
+folder (`~/.scalequality/workspace`); the original file is never changed.
+
+Every command a session wants to run is confirmed in the terminal where `up`
+runs, one question at a time. Without a terminal (for example, `up` started in
+the background) those commands are denied.
+
+## One session with a code
+
 ```bash
 cd path/to/your/repository
 npx @scalequality/cli connect <code>
 ```
 
 Get the command, with its code, in the AI Workspace: choose **Use a folder on
-your computer**. The code opens only that session; treat it like a password.
+your computer**. The code opens only that session; treat it like a password. No
+login is needed.
 
 Options:
 
@@ -74,15 +123,16 @@ in the browser as they happen, and each file can be discarded there.
 
 ## Stopping
 
-- `Ctrl+C` once stops the current request (a pending command is denied).
-- `Ctrl+C` again disconnects, after saving the session's checkpoint. Your
-  folder keeps every change.
-- Closing the session in the browser also ends the command.
+- `connect`: `Ctrl+C` once stops the current request (a pending command is
+  denied); `Ctrl+C` again disconnects, after saving the session's checkpoint.
+- `up`: `Ctrl+C` saves every running session and disconnects the computer.
+- Your folder keeps every change. Closing the session in the browser also
+  ends it here.
 
 ## For maintainers
 
-`dist/connect.cjs` is built in the ScaleQuality ai-governance service from
-`src/main/workspace-connect.ts`:
+`dist/connect.cjs` (every command) is built in the ScaleQuality ai-governance
+service from `src/main/workspace-connect.ts`:
 
 ```bash
 # in scalequality-ai-governance-service

package/bin/scalequality.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// ScaleQuality CLI. The engine of `connect` is built in the ScaleQuality
-// ai-governance service (src/main/workspace-connect.ts) and copied into
-// dist/connect.cjs by `npm run sync`.
+// ScaleQuality CLI. The engine of every command (connect, login, up, add,
+// logout) is built in the ScaleQuality ai-governance service
+// (src/main/workspace-connect.ts) and copied into dist/connect.cjs by `npm run sync`.
 import { createRequire } from 'node:module'
 import { existsSync, readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
@@ -13,14 +13,25 @@ const engine = fileURLToPath(new URL('../dist/connect.cjs', import.meta.url))
 const HELP = `ScaleQuality CLI ${pkg.version}
 
 Usage:
+  scalequality login [--api URL] [--name NAME]
+      Connect this computer to your ScaleQuality account (you confirm a code in
+      ScaleQuality), then keep it connected.
+  scalequality up [--api URL]
+      Keep this computer connected: the AI Workspace can run sessions in the
+      folders you added and import your Claude Code and Codex conversations.
+  scalequality add [PATH]
+      Add a folder (default: the current one) for the AI Workspace to use.
+  scalequality logout [--api URL]
+      Disconnect this computer and delete its local credential.
   scalequality connect <code> [--api URL] [--dir PATH]
-      Work on this repository folder from the ScaleQuality AI Workspace.
-      Get the command with its code in the AI Workspace: "Use a folder on your computer".
+      Work on this repository folder for one session, with a code from the AI
+      Workspace ("Use a folder on your computer"). No login needed.
   scalequality --help
   scalequality --version
 
-Run "scalequality connect --help" for the options of connect.`
+Run "scalequality <command> --help" for the options of a command.`
 
+const COMMANDS = new Set(['connect', 'login', 'up', 'add', 'logout'])
 const [command] = process.argv.slice(2)
 
 if (!command || command === '--help' || command === '-h' || command === 'help') {
@@ -31,7 +42,7 @@ if (command === '--version' || command === '-v' || command === 'version') {
   process.stdout.write(`${pkg.version}\n`)
   process.exit(0)
 }
-if (command !== 'connect') {
+if (!COMMANDS.has(command)) {
   process.stderr.write(`Unknown command: ${command}\n\n${HELP}\n`)
   process.exit(2)
 }
@@ -46,5 +57,5 @@ if (!existsSync(engine)) {
   process.exit(1)
 }
 process.env.SCALEQUALITY_CLI_VERSION = pkg.version
-// The engine reads process.argv itself: [node, this file, 'connect', <code>, ...options].
+// The engine reads process.argv itself: [node, this file, <command>, ...arguments].
 require(engine)

package/dist/connect.build.json

@@ -1,5 +1,5 @@
 {
   "sdkVersion": "0.3.281",
-  "sha256": "6d37ff3ee7a2a7406dacdaf3ae10b032d83f3081a79fba5aa0f01f45edc5cb21",
-  "sourceCommit": "e87056e8f67d5b19a950795ef2884c8075211fb4"
+  "sha256": "94cfee975f0d72f2ca33b6a7418f0de48cb67c9603ed4408c4ca926dffb9e4cb",
+  "sourceCommit": "c5d6984abde6859165720afe67885521eb08787b"
 }