mirror of
https://github.com/screentinker/screentinker.git
synced 2026-08-15 06:43:27 -06:00
3f9459139f
Some checks are pending
CI / Unit tests (node --test) (push) Waiting to run
CI / OpenAPI spec lint (push) Waiting to run
CI / Android unit tests (Kotlin schedule evaluator vectors) (push) Waiting to run
CI / Licence gate + SBOM (production deps) (push) Waiting to run
CI / Boot smoke + version check (push) Waiting to run
The licence audit that found org.json in the APK was run by hand. Nothing stopped the next
transitive dependency arriving the same way, and "we track licences" was a claim rather than
something anyone could check.
TWO GATES, BOTH FAIL CLOSED.
scripts/license-check.js audits the server's npm tree. scripts/android-license-check.js
resolves the real releaseRuntimeClasspath — everything that can enter the APK a customer
installs — and checks it against android/licenses.json, where each entry records the licence
AND the evidence for it. A dependency nobody has recorded fails the build. That is the case
worth catching: org.json reached customers because it arrived transitively and nothing ever
asked what licence it carried.
Denied: AGPL, GPL, SSPL, Commons Clause, BUSL, and the JSON Licence. Weak copyleft (LGPL,
MPL, EPL, CDDL) is reported but does not fail — it is a judgement, and the judgement should
be made by someone who knows they are making it. Anything unrecognised fails; a package whose
licence we cannot identify is not one we ship.
⚠️ THE SERVER GATE INSTALLS --omit=dev, AND THAT IS THE POINT. A developer checkout carries
sharp, whose @img/sharp-wasm32 declares LGPL-3.0-or-later. It is a test fixture generator that
never reaches a server, but a scanner pointed at a dev tree reports LGPL and contradicts the
answer we give customers. Auditing the production install is what makes the answer defensible.
SBOM. Every release now publishes screentinker-sbom-<version>.cdx.json — CycloneDX 1.5, every
production dependency with version, purl and licence, generated from a production install. CI
uploads one on every run too. That is what turns the claim into something a customer or an
underwriter can verify themselves.
Neither script takes a dependency: a gate that needs its own supply chain audited is worth
less than one that does not.
Verified by mutation rather than assumed. Injecting GPL-3.0-or-later, AGPL-3.0, the JSON
Licence, SSPL-1.0, and a package with no licence field each fail the server gate; MIT and
LGPL pass (LGPL reported). Removing the org.json exclusion fails the Android gate by name;
dropping a group from the policy fails it as unrecorded. Both restored, both green.
Found and fixed while building it: npm ls exits non-zero for any tree problem — an extraneous
package is enough — which made the gate abort instead of auditing. It now reads the listing
either way and only aborts on genuinely empty output.
docs/licensing.md records the policy, how to run the gates, and the dev-vs-production trap.
1676/1676 pass.
66 lines
1.1 KiB
Plaintext
66 lines
1.1 KiB
Plaintext
# Dependencies
|
|
node_modules/
|
|
|
|
# Databases: SQLite files, WAL/SHM sidecars, and any .db.<suffix> backups
|
|
# (e.g. .db.devbak), anywhere in the tree - never commit a database.
|
|
*.db
|
|
*.db-wal
|
|
*.db-shm
|
|
*.db.*
|
|
|
|
# Uploads (user content)
|
|
server/uploads/
|
|
|
|
# Secrets and certificates
|
|
server/certs/key.pem
|
|
server/certs/cert.pem
|
|
server/certs/license_private.pem
|
|
server/certs/.jwt_secret
|
|
server/certs/.license_key
|
|
|
|
# Android
|
|
android/.gradle/
|
|
android/build/
|
|
android/app/build/
|
|
android/local.properties
|
|
android/release-key.jks
|
|
*.apk
|
|
*.aab
|
|
*.wgt
|
|
*.tar.gz
|
|
|
|
# IDE / Editor
|
|
.claude/
|
|
.idea/
|
|
.vscode/
|
|
*.swp
|
|
*.swo
|
|
*~
|
|
|
|
# OS
|
|
.DS_Store
|
|
Thumbs.db
|
|
|
|
# Environment
|
|
.env
|
|
.env.*
|
|
# ...but DO track the documented template (placeholders only, no secrets)
|
|
!.env.example
|
|
|
|
# Local-only marketing assets
|
|
video/
|
|
|
|
# Generated: transition demo (rebuild with `node shared/Transitions/build-demo.js`)
|
|
shared/Transitions/demo.html
|
|
audit/
|
|
.mcp.json
|
|
**/.mcp.json
|
|
|
|
# Local SQLite artifacts (any extension the tooling might produce)
|
|
*.sqlite
|
|
*.sqlite3
|
|
|
|
# Generated by scripts/license-check.js --sbom (CI publishes it as a release asset)
|
|
sbom/
|
|
*.cdx.json
|