@scalequality/cli 0.4.0 → 0.4.2

package/README.md

@@ -1,8 +1,9 @@
 # @scalequality/cli
 
-Run the ScaleQuality AI Workspace coding engine on your own machine, in your
-repository folders. The conversation stays in the browser; the files, the
-commands and the git working tree stay on your computer.
+Run the ScaleQuality AI Workspace coding engine on your own machine, in any
+folder: a git repository, a folder inside one, or a folder with several
+repositories and other files. The conversation stays in the browser; the files,
+the commands and the git working trees stay on your computer.
 
 ## Connect this computer
 
@@ -121,8 +122,23 @@ Workspace screen: it runs one session in the current folder (`--dir PATH`,
 `--api URL`, `--verbose`) and ends when you press Ctrl+C twice. It is not listed
 in the help: `login` replaces it.
 
-Requires Node.js 18 or newer and git. A folder must be the root of a git
-repository; the CLI never runs `git init`, clones or fetches for you.
+Requires Node.js 18 or newer and git. Any folder works; the CLI never runs
+`git init`, clones or fetches for you.
+
+## Any folder
+
+- **A git repository**: its change is compared with `HEAD`.
+- **A folder inside a repository**: the engine works in that folder; the
+  repository tracks its change (only that folder's files).
+- **A folder that is not a repository** (for example `~/GIT` with many
+  repositories inside): the repositories in it are found (up to 4 levels down,
+  skipping `node_modules`, build output and hidden folders) and each one keeps
+  its own change against its own `HEAD`. Files outside every repository are
+  copied before the engine first changes them, into
+  `~/.scalequality/workspace/sessions/` (never into your folder), so you can
+  review, discard or rewind those changes too. Copies of sessions unused for 30
+  days are removed. Changes made by shell commands to files outside a
+  repository are not tracked.
 
 ## What runs where
 
@@ -132,8 +148,9 @@ On your machine:
   the folder**;
 - the commands it wants to run, **each one after you approve it in the
   browser** (or after an "always allow" rule you created covers it);
-- the diff of your folder against `HEAD` at connect time, which is what the
-  browser shows and what a pull request carries.
+- the diff of each repository against its `HEAD` at connect time (and of the
+  other files against their copies), which is what the browser shows and what
+  a pull request carries.
 
 In ScaleQuality:
 

package/dist/connect.build.json

@@ -1,5 +1,5 @@
 {
   "sdkVersion": "0.3.281",
-  "sha256": "e6387aaa87dedbc6a119b7f0d9a10690acc966a76b5453a6f573efdc051f8c46",
-  "sourceCommit": "e37bac1d879b18a3094b9fdc9d813efa1f115280"
+  "sha256": "e6408c8711d5f8ce5fa0fc528835a2bb1f859c6e220f4a1757f8330a88b639dc",
+  "sourceCommit": "98b4ef0ee422519ddd7767944a68147c22d33466"
 }