shiplightai 0.1.102 → 0.1.104

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to `shiplightai` are documented here. This file is generated automatically at release time from the commits that touch the published package and its bundled SDK.
 
+## 0.1.104 (2026-09-08)
+
+### Other Changes
+
+- Pin @shiplightai/devtools-assets exactly, and guard the pin (83bdf30)
+- Initial commit (de28541)
+
+## 0.1.103 (2026-09-02)
+
+### Features
+
+- **telemetry:** add CLI command telemetry, share one client with the MCP server (bc3ba52)
+- **cli:** replace login/logout with setup-api-token, retire legacy proxy hosts (4460953)
+
+### Bug Fixes
+
+- **telemetry:** name both opt-out switches in the first-run notice (5344464)
+- **telemetry:** track setup-api-token, not the retired login/logout (df97829)
+- **cli:** unify URL self-healing policy (0f8333c)
+- **cli:** disable self-healing for URL navigation (86fe8d5)
+
+### Other Changes
+
+- **telemetry:** split the two opt-out switches, unexport the collector constants (a52c8cf)
+- rebuild workspace dependencies before package-level test and typecheck (9ada4a3)
+
 ## 0.1.102 (2026-08-27)
 
 ### Features
@@ -61,9 +87,9 @@ All notable changes to `shiplightai` are documented here. This file is generated
 - **cli:** drop nine dependencies with no import site (d5440ea)
 - **types:** remove five modules no consumer imports (f0fe08b)
 - **cli:** fold the yaml-transpiler into apps/cli, drop shiplight-tools (efe2c8c)
-- extract the debugger UI into packages/debugger-ui, drop @loggia/common (995da96)
+- extract the debugger UI into packages/debugger-ui, drop the internal shared package (995da96)
 - remove the unreachable export surface from shiplight-tools (c923356)
-- remove the v1 Loggia cloud workspaces (e033cef)
+- remove the retired hosted-product workspaces (e033cef)
 
 ## 0.1.99 (2026-08-10)
 

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shiplight
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -11,8 +11,9 @@ Scaffold a new test project in under a minute:
 ```bash
 npx shiplightai@latest create ./my-tests
 cd my-tests
-cp .env.example .env            # then set one of GOOGLE_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY
+cp .env.example .env            # configure credentials after install
 npm install
+npx shiplight setup-api-token   # writes SHIPLIGHT_API_TOKEN; skip if using a provider key
 npx playwright install chromium
 npx shiplight test              # runs the scaffolded starter test
 ```
@@ -29,14 +30,15 @@ npm install shiplightai
 
 Every command is invoked via `npx shiplight <command>` from inside a project that has `shiplightai` installed.
 
-| Command | Purpose |
-|---|---|
-| `shiplight create <path>` | Scaffold a new test project |
-| `shiplight test [args]` | Run your YAML and Playwright test suite (forwards all Playwright flags) |
-| `shiplight debug <file>` | Launch the interactive visual debugger for a YAML test. The server picks a free port automatically; the chosen URL is printed on startup. Pass `--port N` for a stable URL (CI, bookmarks). Multiple concurrent `shiplight debug` invocations work without any port coordination. |
-| `shiplight report [folder]` | Regenerate or merge HTML reports |
-| `shiplight transpile [glob]` | Transpile YAML tests to `.yaml.spec.ts` (usually automatic). `--strict` fails while statements are still unenriched drafts (no captured `action`/`js`) |
-| `shiplight spec <topic>` | Print an authoring reference: `yaml` (the test language spec) or `actions` (every action and its parameters) |
+| Command                      | Purpose                                                                                                                                                                                                                                                                           |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `shiplight setup-api-token`  | Authenticate with Shiplight and write `SHIPLIGHT_API_TOKEN` to the current project's `.env`                                                                                                                                                                                       |
+| `shiplight create <path>`    | Scaffold a new test project                                                                                                                                                                                                                                                       |
+| `shiplight test [args]`      | Run your YAML and Playwright test suite (forwards all Playwright flags)                                                                                                                                                                                                           |
+| `shiplight debug <file>`     | Launch the interactive visual debugger for a YAML test. The server picks a free port automatically; the chosen URL is printed on startup. Pass `--port N` for a stable URL (CI, bookmarks). Multiple concurrent `shiplight debug` invocations work without any port coordination. |
+| `shiplight report [folder]`  | Regenerate or merge HTML reports                                                                                                                                                                                                                                                  |
+| `shiplight transpile [glob]` | Transpile YAML tests to `.yaml.spec.ts` (usually automatic). `--strict` fails while statements are still unenriched drafts (no captured `action`/`js`)                                                                                                                            |
+| `shiplight spec <topic>`     | Print an authoring reference: `yaml` (the test language spec) or `actions` (every action and its parameters)                                                                                                                                                                      |
 
 Full reference with flags, options, and troubleshooting: **[docs.shiplight.ai/local/cli-reference](https://docs.shiplight.ai/local/cli-reference)**.
 
@@ -99,9 +101,12 @@ For the YAML statement language, authentication, variables, templates, and custo
 
 ## Environment variables
 
-Set at least one LLM provider API key in `.env` before running tests:
+Run `npx shiplight setup-api-token` to configure Shiplight's LLM proxy, or set
+at least one provider API key in `.env` before running tests:
 
 ```
+SHIPLIGHT_API_TOKEN=...
+# or
 GOOGLE_API_KEY=...
 # or ANTHROPIC_API_KEY=sk-ant-...
 # or OPENAI_API_KEY=sk-...
@@ -111,6 +116,23 @@ The AI model is auto-selected from the first key set. Override with `WEB_AGENT_M
 
 Shiplight uses an **explicit env var allowlist**: only the vars it forwards into its internal SDK config are accessible to the agent. Any env var not on the list is invisible to the SDK by design. Full list (`OPENAI_BASE_URL`, Vertex AI routing, Mailgun keys, etc.): **[docs.shiplight.ai/local/cli-reference#environment-variables](https://docs.shiplight.ai/local/cli-reference)**.
 
+## Telemetry
+
+The CLI sends one anonymous event per invocation: the subcommand name (`test`,
+`debug`, …), the CLI version, your OS, CPU architecture, Node version, and
+whether the run looks like CI. Nothing else — no arguments, file paths, URLs,
+test content, or account data. Commands we do not ship are reported as
+`unknown` rather than by name, so a mistyped path never leaves your machine.
+Runs are grouped by a one-way SHA-256 hash of host, user, platform and
+architecture; the inputs to that hash are never transmitted.
+
+Opt out with either:
+
+```
+SHIPLIGHT_TELEMETRY=0
+DO_NOT_TRACK=1
+```
+
 ## Requirements
 
 - **Node.js >= 22**