squally-mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -144,6 +144,58 @@ hand, so the two cannot drift. `test/drift.test.js` compares the vendored copy
144
144
  against the live document and fails when an operation or parameter has moved;
145
145
  it skips loudly when offline.
146
146
 
147
+ ## Releasing
148
+
149
+ Publishing is **staged**: CI uploads the tarball, a maintainer approves it, and
150
+ only then is the version installable. `npm stage publish` never asks for 2FA,
151
+ which is what makes it usable from a workflow; the 2FA prompt moves to the
152
+ approval step, so a compromised workflow can stage a version but cannot put one
153
+ in front of users. Direct `npm publish` is not permitted for this package's
154
+ trusted publisher, so this is the only route.
155
+
156
+ > **0.1.0 is the exception.** It was published by hand with `npm publish`
157
+ > before the trusted publisher existed, so it carries no provenance
158
+ > attestation. Every version from 0.1.1 on goes through the steps below.
159
+
160
+ 1. **Bump and tag.** The lockfile belongs to the release commit, so let `npm
161
+ version` write both and commit them together:
162
+
163
+ ```bash
164
+ npm install # only if package.json changed by hand
165
+ npm version patch # or minor / major - writes package.json + lockfile, makes the tag
166
+ git push --follow-tags
167
+ ```
168
+
169
+ 2. **The tag starts the workflow.** `.github/workflows/publish.yml` runs on
170
+ `v*`: it tests, checks that the tag and `package.json` agree, and runs
171
+
172
+ ```bash
173
+ npm stage publish --provenance --access public
174
+ ```
175
+
176
+ through npm's trusted publishing (OIDC) — no npm token in GitHub secrets.
177
+ `--provenance` attaches a signed statement linking the tarball to that
178
+ workflow run and commit.
179
+
180
+ 3. **Approve the staged version.** On
181
+ [npmjs.com/package/squally-mcp](https://www.npmjs.com/package/squally-mcp) →
182
+ **Staged Packages** → **Approve**, which asks for 2FA. Or from a terminal:
183
+
184
+ ```bash
185
+ npm stage list squally-mcp
186
+ npm stage view <stage-id> # what is in the tarball
187
+ npm stage approve <stage-id> # also asks for 2FA
188
+ npm stage reject <stage-id> # if something is wrong
189
+ ```
190
+
191
+ Until this step the version exists in the registry but installs nothing.
192
+
193
+ **Requirements for step 3 on your machine:** npm **11.15.0 or later** and Node
194
+ **22.14.0 or higher** ([npm docs](https://docs.npmjs.com/staged-publishing/)).
195
+ Node 22 still bundles npm 10.9.9, so check `npm --version` rather than assuming
196
+ your Node version brought a new enough npm. The workflow uses Node 24 for the
197
+ same reason and fails with that requirement if a runner ever ships an older npm.
198
+
147
199
  ## License
148
200
 
149
201
  MIT
@@ -131,7 +131,7 @@
131
131
  "code": "test_not_found",
132
132
  "status": 404,
133
133
  "when": "No test with this name in this project.",
134
- "action": "Check the test name (URL-encoded, \"/\" as %2F) and filePath; do not retry.",
134
+ "action": "Check the test name and filePath exactly as Squally shows them; do not retry.",
135
135
  "hasBody": true
136
136
  },
137
137
  {
@@ -1775,7 +1775,7 @@
1775
1775
  "alsoActive": [
1776
1776
  "failure_rate_broken"
1777
1777
  ],
1778
- "timeLostMs": null,
1778
+ "timeLostMs": 540000,
1779
1779
  "flakeScore": 0.9,
1780
1780
  "flipRate": 0.05,
1781
1781
  "failureRate": 1,
@@ -4945,7 +4945,7 @@
4945
4945
  "type": "null"
4946
4946
  }
4947
4947
  ],
4948
- "description": "Time lost to failed and retried attempts in the window, ms (approximation: final attempt duration x attempts). null does NOT mean zero: the test never passed in the window - the worst case."
4948
+ "description": "Time lost to failed and retried attempts in the window, ms (approximation: wasted attempts x the final attempt duration). A failed run wastes every attempt it made, a run rescued by a retry wastes the attempts before it, and a run that passed first time wastes none - so 0 is a real measurement. Computed for every listed test; null is a guard for a test with no occurrence in the window and should not occur here."
4949
4949
  },
4950
4950
  "flakeScore": {
4951
4951
  "type": "number"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "squally-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Local MCP server for Squally — read-only access to your Playwright test runs, flaky tests and failures.",
5
5
  "license": "MIT",
6
6
  "author": "Squally",