@ai-ecoverse/slicc-browsers 1.1.0 → 1.2.0

package/README.md

@@ -66,7 +66,7 @@ Every feature builds for `wasm32-wasip1`.
   - `windows?`: `roots` (names from `platforms.windows.roots`, searched in order) and `executables` (each tried under each root); `dataRoot` and `dataDir`, the default user-data dir; `startMenuInternet?`, the browser's key names under the `StartMenuInternet` registry keys.
   - `linux?`: `bins` (names on `PATH`), `desktopIds` (`.desktop` file names without the suffix), `flatpak?` (the app id), `snap?` (the snap name), `snapDataDir?` (the user-data dir under `~/snap/<snap>/common`), `configDir` (the user-data dir under the config dir, also under `~/.var/app/<flatpak>/config` for a flatpak), and `debs` (dpkg package names for the version).
 - `electron`: `macosApps` (known Electron apps by bundle id, with display names), `debugBlocked` (app names that block remote debugging; they're listed with `debugSupport: "disabled"` and never launched), and `idPrefix` (`electron:`, followed by the slug of the name: lower case, runs of other characters as one `-`).
-- `rank`: `tiers`, 1 to 5: `sevenOpen` (an endpoint with a seven tab), `endpoint` (any other endpoint), `chrome` (installed `chromeId`), `chromium` (other installed Chromium browsers), `electron` (installed Electron apps).
+- `rank`: `tiers`, 1 to 6: `sevenOpen` (an endpoint with a seven tab), `endpoint` (any other endpoint), `chrome` (installed `chromeId`), `chromium` (other installed Chromium browsers), `electron` (installed Electron apps), `six` (an endpoint in SLICC six's profile, with or without a seven tab; see [SLICC six's profiles](#slicc-sixs-profiles)).
 - `discovery`:
   - `activePortFile` (`DevToolsActivePort`): its first line is the port (1 to 65535) and its second the browser's websocket path, which starts with `/`. A file without both is ignored. A file is live only when its port answers `/json/version` with a `webSocketDebuggerUrl` whose path is that websocket path; otherwise it's stale and ignored. When the port accepts connections but serves no `/json/version`, the endpoint is listed as `wsOnly`, with `ws://127.0.0.1:<port><path>`;
   - `probePorts` (9222 to 9229, probed by `slicc` only);
@@ -82,7 +82,10 @@ Every feature builds for `wasm32-wasip1`.
   - `discardExceptions`: where the site pattern and the extra origins' hosts go, as a `list` of strings or as a `chrome-time-map`, a map from site to the time it was added (microseconds since 1601-01-01 UTC, as a decimal string);
   - `cleanExit`: values that mark the last exit clean;
   - `form` says where a key comes from: `six` (SLICC six's keys) or `chrome-154` (what Chrome 154 reads).
-- `profiles`: SLICC profiles live in `<config dir>/<root>/<name>`, and a snap's in `~/snap/<snap>/common/<snapRoot>/<name>`. `legacyRoot` is the old root, which SLICC six also uses, and `sixProfilePattern` matches six's profile names; neither is ever scanned. `namePattern` is a valid profile name.
+- `profiles`: SLICC profiles live in `<config dir>/<root>/<name>`, and a snap's in `~/snap/<snap>/common/<snapRoot>/<name>`. `legacyRoot` is the old root, never scanned; on macOS's case-insensitive volume it is SLICC six's root too. `sixProfilePattern` matches six's profile names, case-insensitively. `namePattern` is a valid profile name. `six` describes SLICC six's Chrome profiles (see [SLICC six's profiles](#slicc-sixs-profiles)):
+  - `roots`: six's profile root per OS (`macos`, `linux`, `windows`), a `base` location followed by the `path` segments. The base is its `env` when that is set and not empty (any value, as six takes it), else `home` under the home dir.
+  - `defaultName` (`browser-coding-agent-chrome`), `defaultPort` (5710) and `portSuffix` (`-{port}`): six's profile for its serve port `<port>` is `<root>/<defaultName>`, with `portSuffix` added for any port other than `defaultPort`.
+  - `userDataDirEnv` (`SLICC_USER_DATA_DIR`): when set, its value, trimmed of whitespace, is six's profile for every port, unless it is empty.
 - `launch`: `chromiumArgs` (with `{profile}` for the profile dir), then the seven flags, then `headless` with `--headless`. Electron apps get `electron.portFlag` with the first free port from `electron.minPort` up that isn't in `electron.reservedPorts`.
 - `platforms`: the config dir per OS, the Windows roots, and the Windows registry keys. A location is the environment variable `env` when it's set (on Linux only an absolute path counts), else `absolute`, else `home` under the home dir. `registry`: under each of `hives`, every subkey of each `startMenuInternet` key, with its `openCommand` default value, and the default value of `appPaths\<name>` for each of `appPathNames`.
 
@@ -93,13 +96,40 @@ The process scan finds browsers started with a debugging port by something else:
 - **What's skipped:** pid 0, the scanning process itself, and commands whose first token is a wrapper. The first token is the quoted string when the command starts with a quote. A wrapper is a token whose base name, without `.exe`, `.cmd` or `.bat`, is one of `wrappers`, case-insensitively. A command with no executable before its first `-` token is skipped too.
 - **The port** comes from the first `--remote-debugging-port` followed by `=` or whitespace and then digits. A port above 65535 drops the process.
 - **The dir** is the value of `--user-data-dir` at the start of a token, followed by `=` or by whitespace (which is skipped). A value that starts with one of `valueQuotes` (`"` or `'`) runs to the matching quote. Any other value runs up to the first whitespace that is followed by `valueStop` (`--`), or to the end of the command, without trailing whitespace. So `--user-data-dir=/Users/me/Library/Application Support/x --no-first-run` gives `/Users/me/Library/Application Support/x`. A value that would start with `--` is empty.
-- **Port 0** means the port is in the dir's `DevToolsActivePort`, checked like any other. With no dir, or a dir under the legacy profile root (a `slicc` segment followed by `profiles`, case-insensitively), the process is skipped.
+- **Port 0** means the port is in the dir's `DevToolsActivePort`, checked like any other. With no dir, or a dir under the legacy profile root (a `slicc` segment followed by `profiles`, case-insensitively) that isn't one of [six's profile dirs](#slicc-sixs-profiles), the process is skipped.
 - **Any other port** is probed on `127.0.0.1`. An endpoint from the process scan has `source: "process"` and `userDataDir` set to the dir when there is one.
 - **Tests** must fake the process list: never scan the real one in a test.
 
+## SLICC six's profiles
+
+SLICC six launches Chrome in a profile of its own, and slicc-cli can use that profile in place (`slicc --profile six`). Discovery never chooses it: its endpoints are listed, marked and ranked last.
+
+| | macOS | Linux | Windows |
+| --- | --- | --- | --- |
+| six's root | `~/Library/Application Support/Slicc/profiles` | `$XDG_STATE_HOME/slicc/profiles`, else `~/.local/state/slicc/profiles` | `%LOCALAPPDATA%\Slicc\profiles`, else `~\AppData\Local\Slicc\profiles` |
+
+Taken from [ai-ecoverse/slicc](https://github.com/ai-ecoverse/slicc) at `65c5a79b4` (v6.247.17-8):
+
+| what | where |
+| --- | --- |
+| the root per OS | `packages/node-server/src/chrome-launch.ts:119-136` (`resolveProfilesDir`); `packages/swift-server/Sources/Browser/ChromeLauncher.swift:314-322` (macOS only) |
+| `browser-coding-agent-chrome` | `chrome-launch.ts:27`; `ChromeLauncher.swift:5` |
+| the `-<port>` suffix for a serve port other than 5710 | `chrome-launch.ts:147`; `ChromeLauncher.swift:6`, `:323` |
+| `SLICC_USER_DATA_DIR`, trimmed | `chrome-launch.ts:143-146` (node-server only) |
+| six's own `--remote-debugging-port` (9222 by default) | `chrome-launch.ts:283`, `packages/node-server/src/runtime-flags.ts:47`; `ChromeLauncher.swift:213` |
+
+**Six's profile dirs** are the dirs in six's root whose name matches `sixProfilePattern` case-insensitively, and the `SLICC_USER_DATA_DIR` dir. A dir found anywhere is six's when it is one of them: the paths are compared case-insensitively, with `/` and `\` alike, and after resolving symlinks where the program can (so a symlink to six's profile, or a symlinked root, is six's too).
+
+**Discovery** marks an endpoint `six: true` when one of its sources found it in six's profile:
+- `DevToolsActivePort` in each of six's profile dirs, checked like any other. No other dir in six's root is read.
+- The process list: a process whose `--user-data-dir` is six's. With port 0 its `DevToolsActivePort` is read, which the legacy-root rule would otherwise skip.
+- Merging: an endpoint is six's when any source that found it, and whose checks passed, is six's. So a port probe hit or a `--cdp` URL that the process list maps to six's profile is six's, while a stale `DevToolsActivePort` in six's profile marks nothing. Its `userDataDir` is six's dir when the source that wins has none.
+
+A six endpoint has tier `six`, whatever its seven tabs. **A program never chooses it by itself**: a default choice, an "attach to the best" rule, or a non-interactive mode skips it. Only an explicit request for six's profile unlocks it, such as `slicc --profile six` or picking it in a picker.
+
 ## Output schema 1
 
-`schema/browsers.schema.json` describes `slicc browsers --json`, which `playwright-cli list --json` also prints. [slicc-cli's README](https://github.com/ai-ecoverse/slicc-cli#slicc-browsers---json---cdp-url---no-bundle-scan) is the authoritative spec for it; this schema is a copy and follows it. Fields can be added; `source` is one of `devtools-active-port`, `flag`, `probe` and `process`.
+`schema/browsers.schema.json` describes `slicc browsers --json`, which `playwright-cli list --json` also prints. [slicc-cli's README](https://github.com/ai-ecoverse/slicc-cli#slicc-browsers---json---cdp-url---no-bundle-scan) is the authoritative spec for it; this schema is a copy and follows it. Fields can be added; `source` is one of `devtools-active-port`, `flag`, `probe` and `process`. `tier` is 1 to 6, and `six: true` marks an endpoint in SLICC six's profile (tier 6).
 
 ## The corpus
 
@@ -107,15 +137,16 @@ Each case is a fake machine: a home tree, `DevToolsActivePort` files, fake `/jso
 
 **`case.json`:**
 - `description`, and `os?`: the OSes the case runs on (`darwin`, `linux`, `windows`; default all).
-- `needs`: what a program must support to run the case: `user-data-dirs` (`DevToolsActivePort` in browsers' default user-data dirs), `seven-profiles` (in the profile roots), `flag` (`--cdp` URLs), `process`, `probe` (port probes, `slicc` only), `origins` (extra seven origins), `installed` (ranking installed browsers). A program skips a case that needs something it doesn't do.
+- `needs`: what a program must support to run the case: `user-data-dirs` (`DevToolsActivePort` in browsers' default user-data dirs), `seven-profiles` (in the profile roots), `flag` (`--cdp` URLs), `process`, `probe` (port probes, `slicc` only), `origins` (extra seven origins), `installed` (ranking installed browsers), `six` (finding and marking SLICC six's profiles). A program skips a case that needs something it doesn't do.
 - `env?`: environment variables for discovery, which sees nothing else from the real environment.
 - `files?`: file contents by path. Every path starts with a token.
 - `cdp?`, `origins?`, `probePorts?`: `--cdp` URLs, extra seven origins, and the ports to probe.
 - `processes?`: `{ "pid", "command" }`, or `{ "self": true, "command" }` for the scanning process, whose pid the harness fills in.
 - `http?`: fake servers by `host:port`. `localhost` and `[::1]` are `127.0.0.1`. A listed port accepts TCP connections. `/json/version` answers 200 with `version`, `/json/list` (and `/json`) with `list`. A missing body, or any other path, answers 404. An unlisted port refuses connections.
 - `installed?`: installed browsers in the shape of output schema 1's `installed`, ranked along with the endpoints.
+- `auto`: exactly in the cases that need `six`, the id of the first entry in `expected.json` that isn't six's, or `null` when every entry is. A program that chooses without being asked must choose no entry before it, and never a six entry.
 
-**Tokens.** `{home}` (the fake home), `{config}` (the config dir), `{sevenProfiles}` (the profile root) and `{userData:<id>}` (the browser's first default user-data dir on this OS) stand for directories. In `files`, `env`, `cdp`, process commands and `expected.json`, a token and the path characters after it (up to whitespace, `"`, `'` or `,`) become a path on the OS under test, with `\` on Windows. The token values come from `catalog.json`, with the case's `env`.
+**Tokens.** `{home}` (the fake home), `{config}` (the config dir), `{sevenProfiles}` (the profile root), `{sixProfiles}` (SLICC six's root) and `{userData:<id>}` (the browser's first default user-data dir on this OS) stand for directories. In `files`, `env`, `cdp`, process commands and `expected.json`, a token and the path characters after it (up to whitespace, `"`, `'` or `,`) become a path on the OS under test, with `\` on Windows. The token values come from `catalog.json`, with the case's `env`.
 
 **Never 9222 to 9229.** A developer's own Chrome listens there. The corpus schema refuses those ports, `npm run validate` refuses them anywhere in the corpus, and the fakes never serve them.
 
@@ -161,13 +192,13 @@ for case in corpus().cases {
 }
 ```
 
-`Layout` also gives `Config`, `SevenProfiles`, `UserDataDirs(id)`, `Token(name)` and `Expand(text)` (Rust: `config`, `seven_profiles`, `user_data_dirs`, `token`, `expand`). Their results for a few homes are pinned in `test/integration/layout.json`, which the Go and Rust tests both check.
+`Layout` also gives `Config`, `SevenProfiles`, `SixProfiles`, `UserDataDirs(id)`, `Token(name)` and `Expand(text)` (Rust: `config`, `seven_profiles`, `six_profiles`, `user_data_dirs`, `token`, `expand`). Their results for a few homes are pinned in `test/integration/layout.json`, which the Go and Rust tests both check.
 
 ## Development
 
 Go 1.26, Rust stable with `wasm32-wasip1`, Node ≥ 24.
 - `npm run corpus` regenerates `corpus.json` from `corpus/`; the pre-commit hook and CI fail when it's stale.
-- `npm run validate` checks `catalog.json` and `corpus.json` against the schemas, plus what a schema can't say: unique ids, bundle ids and names, known Windows roots, rising tiers, compiling patterns, known tokens, tier order and `sevenOpen` in each `expected.json`, and no port from 9222 to 9229.
+- `npm run validate` checks `catalog.json` and `corpus.json` against the schemas, plus what a schema can't say: unique ids, bundle ids and names, known Windows roots, rising tiers, compiling patterns, known tokens, tier order, `sevenOpen`, `six` and `auto` in each `expected.json`, and no port from 9222 to 9229.
 - `npm run lint`: the slicc lint tools (Biome, no comments, no unit tests in git, `AGENTS.md`), `gofmt`, `go mod tidy -diff`, `go vet`, golangci-lint, `cargo fmt --check` and clippy.
 - `npm test`: `validate`, the Go tests in `test/integration/`, and `cargo test --all-features`.
 - `npm run build`: the Go module, the crate (also for `wasm32-wasip1`), and `npm pack --dry-run`.
@@ -181,7 +212,7 @@ semantic-release cuts one version from `main` for all three packages (`.github/w
 2. **npm:** with the repository variable `SLICC_BROWSERS_NPM_PUBLISH` set to `true`, the package is stamped with the version and published through npm trusted publishing (OIDC, with provenance). A version that is already on npm is skipped.
 3. **crates.io:** with the repository variable `SLICC_BROWSERS_CRATES_PUBLISH` set to `true`, `Cargo.toml` is stamped with the version and `cargo publish` runs with a short-lived token from crates.io trusted publishing (`rust-lang/crates-io-auth-action`). A version that is already on crates.io is skipped.
 
-A run started by hand (`gh workflow run release.yml --ref main`) on a commit that already has its tag publishes what's missing without a new release.
+A run started by hand publishes what's missing without a new release: `gh workflow run release.yml --ref main` when `main`'s head has its tag, or `gh workflow run release.yml --ref main -f tag=vX.Y.Z` for any existing tag.
 
 **Go module versions.** A pushed tag is the release: `proxy.golang.org` caches it and `sum.golang.org` records its hash for good. Never move or delete a pushed tag; retract a bad version in `go.mod` and release anew. A `BREAKING CHANGE` needs a `/vN` module path first.
 

package/catalog.json

@@ -580,7 +580,8 @@
       "endpoint": 2,
       "chrome": 3,
       "chromium": 4,
-      "electron": 5
+      "electron": 5,
+      "six": 6
     },
     "chromeId": "chrome"
   },
@@ -705,7 +706,27 @@
     "snapRoot": ["slicc", "seven-profiles"],
     "legacyRoot": ["slicc", "profiles"],
     "sixProfilePattern": "^browser-coding-agent-chrome(-[0-9]+)?$",
-    "namePattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+    "namePattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
+    "six": {
+      "roots": {
+        "macos": {
+          "base": { "home": ["Library", "Application Support"] },
+          "path": ["Slicc", "profiles"]
+        },
+        "linux": {
+          "base": { "env": "XDG_STATE_HOME", "home": [".local", "state"] },
+          "path": ["slicc", "profiles"]
+        },
+        "windows": {
+          "base": { "env": "LOCALAPPDATA", "home": ["AppData", "Local"] },
+          "path": ["Slicc", "profiles"]
+        }
+      },
+      "defaultName": "browser-coding-agent-chrome",
+      "defaultPort": 5710,
+      "portSuffix": "-{port}",
+      "userDataDirEnv": "SLICC_USER_DATA_DIR"
+    }
   },
   "launch": {
     "chromiumArgs": [

package/corpus.json

@@ -2127,6 +2127,565 @@
         ]
       }
     },
+    {
+      "name": "six-flag",
+      "case": {
+        "description": "A --cdp URL is still six's when the process list maps its port to six's profile: the flag wins as the source, and the endpoint keeps six's userDataDir",
+        "needs": [
+          "six",
+          "process",
+          "flag"
+        ],
+        "cdp": [
+          "127.0.0.1:9341"
+        ],
+        "processes": [
+          {
+            "pid": 401,
+            "command": "/opt/google/chrome/chrome --remote-debugging-port=9341 --user-data-dir={sixProfiles}/browser-coding-agent-chrome"
+          }
+        ],
+        "http": {
+          "127.0.0.1:9341": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9341/devtools/browser/z1"
+            },
+            "list": []
+          }
+        },
+        "auto": null
+      },
+      "expected": {
+        "schema": 1,
+        "minChromium": 116,
+        "entries": [
+          {
+            "id": "cdp:127.0.0.1:9341",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9341",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9341/devtools/browser/z1",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "flag",
+              "userDataDir": "{sixProfiles}/browser-coding-agent-chrome",
+              "six": true,
+              "sevenOpen": false,
+              "sevenTabs": []
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "six-probe",
+      "case": {
+        "description": "A port probe hit that the process list maps to six's profile is six's; a probe hit the process list doesn't know ranks as usual",
+        "needs": [
+          "six",
+          "process",
+          "probe"
+        ],
+        "probePorts": [
+          9331,
+          9332
+        ],
+        "processes": [
+          {
+            "pid": 301,
+            "command": "/opt/google/chrome/chrome --remote-debugging-port=9331 --user-data-dir={sixProfiles}/browser-coding-agent-chrome"
+          }
+        ],
+        "http": {
+          "127.0.0.1:9331": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9331/devtools/browser/y1"
+            },
+            "list": [
+              {
+                "id": "S1",
+                "type": "page",
+                "url": "https://lars.sliccy.ai/",
+                "title": "seven",
+                "webSocketDebuggerUrl": "ws://127.0.0.1/devtools/page/S1"
+              }
+            ]
+          },
+          "127.0.0.1:9332": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9332/devtools/browser/y2"
+            },
+            "list": []
+          }
+        },
+        "auto": "cdp:127.0.0.1:9332"
+      },
+      "expected": {
+        "schema": 1,
+        "minChromium": 116,
+        "entries": [
+          {
+            "id": "cdp:127.0.0.1:9332",
+            "kind": "endpoint",
+            "tier": 2,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9332",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9332/devtools/browser/y2",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "probe",
+              "sevenOpen": false,
+              "sevenTabs": []
+            }
+          },
+          {
+            "id": "cdp:127.0.0.1:9331",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9331",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9331/devtools/browser/y1",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "process",
+              "userDataDir": "{sixProfiles}/browser-coding-agent-chrome",
+              "six": true,
+              "sevenOpen": true,
+              "sevenTabs": [
+                {
+                  "id": "S1",
+                  "url": "https://lars.sliccy.ai/",
+                  "title": "seven"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "six-process-scan",
+      "case": {
+        "description": "A process whose --user-data-dir is one of six's profiles is six's: with a port, and with port 0 through the profile's DevToolsActivePort; other processes rank as usual and come first",
+        "needs": [
+          "six",
+          "process"
+        ],
+        "files": {
+          "{sixProfiles}/browser-coding-agent-chrome-5711/DevToolsActivePort": "9322\n/devtools/browser/x8\n"
+        },
+        "processes": [
+          {
+            "pid": 201,
+            "command": "/opt/google/chrome/chrome --remote-debugging-port=9321 --user-data-dir={sixProfiles}/browser-coding-agent-chrome --no-first-run"
+          },
+          {
+            "pid": 202,
+            "command": "/opt/google/chrome/chrome --remote-debugging-port=0 --user-data-dir={sixProfiles}/browser-coding-agent-chrome-5711"
+          },
+          {
+            "pid": 203,
+            "command": "/opt/google/chrome/chrome --remote-debugging-port=9323 --user-data-dir={home}/tmp/pw"
+          }
+        ],
+        "http": {
+          "127.0.0.1:9321": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9321/devtools/browser/x7"
+            },
+            "list": [
+              {
+                "id": "S1",
+                "type": "page",
+                "url": "https://lars.sliccy.ai/",
+                "title": "seven",
+                "webSocketDebuggerUrl": "ws://127.0.0.1/devtools/page/S1"
+              }
+            ]
+          },
+          "127.0.0.1:9322": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9322/devtools/browser/x8"
+            },
+            "list": []
+          },
+          "127.0.0.1:9323": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9323/devtools/browser/x9"
+            },
+            "list": []
+          }
+        },
+        "auto": "cdp:127.0.0.1:9323"
+      },
+      "expected": {
+        "schema": 1,
+        "minChromium": 116,
+        "entries": [
+          {
+            "id": "cdp:127.0.0.1:9323",
+            "kind": "endpoint",
+            "tier": 2,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9323",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9323/devtools/browser/x9",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "process",
+              "userDataDir": "{home}/tmp/pw",
+              "sevenOpen": false,
+              "sevenTabs": []
+            }
+          },
+          {
+            "id": "cdp:127.0.0.1:9321",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9321",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9321/devtools/browser/x7",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "process",
+              "userDataDir": "{sixProfiles}/browser-coding-agent-chrome",
+              "six": true,
+              "sevenOpen": true,
+              "sevenTabs": [
+                {
+                  "id": "S1",
+                  "url": "https://lars.sliccy.ai/",
+                  "title": "seven"
+                }
+              ]
+            }
+          },
+          {
+            "id": "cdp:127.0.0.1:9322",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9322",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9322/devtools/browser/x8",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "devtools-active-port",
+              "userDataDir": "{sixProfiles}/browser-coding-agent-chrome-5711",
+              "six": true,
+              "sevenOpen": false,
+              "sevenTabs": []
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "six-profile-scan",
+      "case": {
+        "description": "DevToolsActivePort in six's profiles (the default name and its -<port> variants, matched case-insensitively) gives endpoints marked six, in the last tier even with a seven tab open, after installed browsers; other names in six's root are never read, and nothing is chosen from six's profiles without being asked",
+        "needs": [
+          "six",
+          "installed"
+        ],
+        "files": {
+          "{sixProfiles}/browser-coding-agent-chrome/DevToolsActivePort": "9311\n/devtools/browser/x1\n",
+          "{sixProfiles}/BROWSER-Coding-Agent-Chrome-5720/DevToolsActivePort": "9312\n/devtools/browser/x2\n",
+          "{sixProfiles}/leader/DevToolsActivePort": "9313\n/devtools/browser/x3\n",
+          "{sixProfiles}/browser-coding-agent-chrome-old/DevToolsActivePort": "9314\n/devtools/browser/x4\n"
+        },
+        "http": {
+          "127.0.0.1:9311": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9311/devtools/browser/x1"
+            },
+            "list": [
+              {
+                "id": "S1",
+                "type": "page",
+                "url": "https://lars.sliccy.ai/",
+                "title": "seven",
+                "webSocketDebuggerUrl": "ws://127.0.0.1/devtools/page/S1"
+              }
+            ]
+          },
+          "127.0.0.1:9312": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9312/devtools/browser/x2"
+            },
+            "list": []
+          },
+          "127.0.0.1:9313": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9313/devtools/browser/x3"
+            },
+            "list": []
+          },
+          "127.0.0.1:9314": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9314/devtools/browser/x4"
+            },
+            "list": []
+          }
+        },
+        "installed": [
+          {
+            "id": "chrome",
+            "name": "Google Chrome",
+            "engine": "chromium",
+            "channel": "stable",
+            "version": "154.0.8037.98",
+            "path": "/opt/google/chrome/google-chrome",
+            "executable": "/opt/google/chrome/google-chrome",
+            "debugSupport": "supported"
+          }
+        ],
+        "auto": "chrome"
+      },
+      "expected": {
+        "schema": 1,
+        "minChromium": 116,
+        "entries": [
+          {
+            "id": "chrome",
+            "kind": "installed",
+            "tier": 3,
+            "name": "Google Chrome",
+            "version": "154.0.8037.98",
+            "installed": {
+              "id": "chrome",
+              "name": "Google Chrome",
+              "engine": "chromium",
+              "channel": "stable",
+              "version": "154.0.8037.98",
+              "path": "/opt/google/chrome/google-chrome",
+              "executable": "/opt/google/chrome/google-chrome",
+              "debugSupport": "supported"
+            }
+          },
+          {
+            "id": "cdp:127.0.0.1:9311",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9311",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9311/devtools/browser/x1",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "devtools-active-port",
+              "userDataDir": "{sixProfiles}/browser-coding-agent-chrome",
+              "six": true,
+              "sevenOpen": true,
+              "sevenTabs": [
+                {
+                  "id": "S1",
+                  "url": "https://lars.sliccy.ai/",
+                  "title": "seven"
+                }
+              ]
+            }
+          },
+          {
+            "id": "cdp:127.0.0.1:9312",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9312",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9312/devtools/browser/x2",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "devtools-active-port",
+              "userDataDir": "{sixProfiles}/BROWSER-Coding-Agent-Chrome-5720",
+              "six": true,
+              "sevenOpen": false,
+              "sevenTabs": []
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "six-user-data-dir",
+      "case": {
+        "description": "SLICC_USER_DATA_DIR, trimmed, is six's profile too, next to the ones in six's root; when every entry is six's, nothing is chosen without being asked",
+        "needs": [
+          "six"
+        ],
+        "env": {
+          "SLICC_USER_DATA_DIR": "  {home}/elsewhere/six-chrome  "
+        },
+        "files": {
+          "{home}/elsewhere/six-chrome/DevToolsActivePort": "9315\n/devtools/browser/x5\n",
+          "{sixProfiles}/browser-coding-agent-chrome/DevToolsActivePort": "9316\n/devtools/browser/x6\n"
+        },
+        "http": {
+          "127.0.0.1:9315": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9315/devtools/browser/x5"
+            },
+            "list": [
+              {
+                "id": "S1",
+                "type": "page",
+                "url": "https://lars.sliccy.ai/",
+                "title": "seven",
+                "webSocketDebuggerUrl": "ws://127.0.0.1/devtools/page/S1"
+              }
+            ]
+          },
+          "127.0.0.1:9316": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9316/devtools/browser/x6"
+            },
+            "list": []
+          }
+        },
+        "auto": null
+      },
+      "expected": {
+        "schema": 1,
+        "minChromium": 116,
+        "entries": [
+          {
+            "id": "cdp:127.0.0.1:9315",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9315",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9315/devtools/browser/x5",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "devtools-active-port",
+              "userDataDir": "{home}/elsewhere/six-chrome",
+              "six": true,
+              "sevenOpen": true,
+              "sevenTabs": [
+                {
+                  "id": "S1",
+                  "url": "https://lars.sliccy.ai/",
+                  "title": "seven"
+                }
+              ]
+            }
+          },
+          {
+            "id": "cdp:127.0.0.1:9316",
+            "kind": "endpoint",
+            "tier": 6,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9316",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9316/devtools/browser/x6",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "devtools-active-port",
+              "userDataDir": "{sixProfiles}/browser-coding-agent-chrome",
+              "six": true,
+              "sevenOpen": false,
+              "sevenTabs": []
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "stale-active-port",
       "case": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-browsers",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "SLICC's shared browser catalog, JSON schemas and discovery conformance corpus",
   "type": "module",
   "license": "Apache-2.0",

package/schema/browsers.schema.json

@@ -17,7 +17,7 @@
       "properties": {
         "id": { "$ref": "#/$defs/text" },
         "kind": { "enum": ["endpoint", "installed"] },
-        "tier": { "type": "integer", "minimum": 1, "maximum": 5 },
+        "tier": { "type": "integer", "minimum": 1, "maximum": 6 },
         "name": { "type": "string" },
         "version": { "$ref": "#/$defs/text" },
         "endpoint": { "$ref": "#/$defs/endpoint" },
@@ -28,10 +28,15 @@
           "properties": {
             "kind": { "const": "endpoint" },
             "id": { "type": "string", "pattern": "^cdp:" },
-            "tier": { "enum": [1, 2] }
+            "tier": { "enum": [1, 2, 6] }
           },
           "required": ["endpoint"],
-          "not": { "required": ["installed"] }
+          "not": { "required": ["installed"] },
+          "if": { "properties": { "tier": { "const": 6 } } },
+          "then": { "properties": { "endpoint": { "type": "object", "required": ["six"] } } },
+          "else": {
+            "properties": { "endpoint": { "type": "object", "not": { "required": ["six"] } } }
+          }
         },
         {
           "properties": {
@@ -68,6 +73,7 @@
         "userDataDir": { "$ref": "#/$defs/text" },
         "profile": { "$ref": "#/$defs/text" },
         "wsOnly": { "const": true },
+        "six": { "const": true },
         "sevenOpen": { "type": "boolean" },
         "sevenTabs": { "type": "array", "items": { "$ref": "#/$defs/tab" } }
       }

package/schema/catalog.schema.json

@@ -54,13 +54,14 @@
         "tiers": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["sevenOpen", "endpoint", "chrome", "chromium", "electron"],
+          "required": ["sevenOpen", "endpoint", "chrome", "chromium", "electron", "six"],
           "properties": {
             "sevenOpen": { "$ref": "#/$defs/tier" },
             "endpoint": { "$ref": "#/$defs/tier" },
             "chrome": { "$ref": "#/$defs/tier" },
             "chromium": { "$ref": "#/$defs/tier" },
-            "electron": { "$ref": "#/$defs/tier" }
+            "electron": { "$ref": "#/$defs/tier" },
+            "six": { "$ref": "#/$defs/tier" }
           }
         },
         "chromeId": { "$ref": "#/$defs/id" }
@@ -171,13 +172,35 @@
     "profiles": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["root", "snapRoot", "legacyRoot", "sixProfilePattern", "namePattern"],
+      "required": ["root", "snapRoot", "legacyRoot", "sixProfilePattern", "namePattern", "six"],
       "properties": {
         "root": { "$ref": "#/$defs/segments" },
         "snapRoot": { "$ref": "#/$defs/segments" },
         "legacyRoot": { "$ref": "#/$defs/segments" },
         "sixProfilePattern": { "type": "string", "format": "regex" },
-        "namePattern": { "type": "string", "format": "regex" }
+        "namePattern": { "type": "string", "format": "regex" },
+        "six": {
+          "description": "SLICC six's Chrome profiles, used in place and never written to.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["roots", "defaultName", "defaultPort", "portSuffix", "userDataDirEnv"],
+          "properties": {
+            "roots": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["macos", "linux", "windows"],
+              "properties": {
+                "macos": { "$ref": "#/$defs/sixRoot" },
+                "linux": { "$ref": "#/$defs/sixRoot" },
+                "windows": { "$ref": "#/$defs/sixRoot" }
+              }
+            },
+            "defaultName": { "$ref": "#/$defs/name" },
+            "defaultPort": { "$ref": "#/$defs/port" },
+            "portSuffix": { "type": "string", "pattern": "\\{port\\}" },
+            "userDataDirEnv": { "$ref": "#/$defs/name" }
+          }
+        }
       }
     },
     "launch": {
@@ -253,7 +276,7 @@
     },
     "port": { "type": "integer", "minimum": 1, "maximum": 65535 },
     "ports": { "type": "array", "items": { "$ref": "#/$defs/port" } },
-    "tier": { "type": "integer", "minimum": 1, "maximum": 5 },
+    "tier": { "type": "integer", "minimum": 1, "maximum": 6 },
     "form": { "enum": ["six", "chrome-154"] },
     "pref": {
       "type": "object",
@@ -265,6 +288,16 @@
         "form": { "$ref": "#/$defs/form" }
       }
     },
+    "sixRoot": {
+      "description": "A base location, then path segments under it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["base", "path"],
+      "properties": {
+        "base": { "$ref": "#/$defs/location" },
+        "path": { "$ref": "#/$defs/segments" }
+      }
+    },
     "location": {
       "description": "An environment variable, else a dir under the home dir or an absolute path.",
       "type": "object",

package/schema/corpus.schema.json

@@ -46,7 +46,8 @@
               "process",
               "probe",
               "origins",
-              "installed"
+              "installed",
+              "six"
             ]
           }
         },
@@ -55,7 +56,7 @@
           "type": "object",
           "propertyNames": {
             "type": "string",
-            "pattern": "^\\{(home|config|sevenProfiles|userData:[a-z0-9-]+)\\}/[^\\\\]+$"
+            "pattern": "^\\{(home|config|sevenProfiles|sixProfiles|userData:[a-z0-9-]+)\\}/[^\\\\]+$"
           },
           "additionalProperties": { "type": "string" }
         },
@@ -99,6 +100,10 @@
         "installed": {
           "type": "array",
           "items": { "$ref": "browsers.schema.json#/$defs/installed" }
+        },
+        "auto": {
+          "description": "With needs six: the id of the first entry that isn't six's, or null.",
+          "type": ["string", "null"]
         }
       }
     }