chore: stop committing dist/, publish WIP releases via CI only

.github/workflows/cleanup-wip-releases.yml

@@ -0,0 +1,22 @@
+---
+
+name: Clean up stale WIP release tarballs
+
+on:
+  schedule:
+    - cron: '0 6 * * 1' # every Monday 06:00 UTC
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: Log keep/delete decisions without deleting anything
+        type: boolean
+        default: true
+
+jobs:
+  cleanup-wip-releases:
+    uses: mat3ra/actions/.github/workflows/cleanup-wip-releases.yml@main
+    with:
+      # Scheduled runs always delete; workflow_dispatch defaults to dry-run.
+      dry-run: ${{ github.event_name == 'workflow_dispatch' && inputs.dry-run || false }}
+    secrets:
+      github-token: ${{ secrets.BOT_GITHUB_TOKEN }}

.github/workflows/release-wip.yml

@@ -0,0 +1,14 @@
+---
+
+name: Publish WIP release tarball
+
+on: push
+
+jobs:
+  release-wip:
+    uses: mat3ra/actions/.github/workflows/release-wip.yml@main
+    with:
+      package-name: code
+      build-script: transpile
+    secrets:
+      github-token: ${{ secrets.BOT_GITHUB_TOKEN }}

.gitignore

@@ -11,8 +11,7 @@ __pycache__/
 *.so
 
 # Distribution / packaging
-# "dist" folder is not ignored on purpose to be able to install intermediate changes from github commits
-# dist
+dist/
 .Python
 build/
 develop-eggs/

.husky/pre-commit

@@ -3,4 +3,4 @@
 
 npm run lint:fix
 npm run transpile
-git add dist
+# dist/ is gitignored - not staged here

RELEASING.md

@@ -0,0 +1,30 @@
+# Releasing WIP builds for consumers
+
+`dist/` is build output and is gitignored — it is not committed on any branch. CI
+publishes a pre-release tarball (`wip-<short-commit-sha>`) whenever a pushed commit
+message contains `[release]`, via the reusable workflow at
+[`mat3ra/actions`](https://github.com/mat3ra/actions#release-wip-usage-reusable-workflow).
+See that README for the full explanation: why this exists, the tag/URL scheme, the
+`EINTEGRITY`/npm-cache gotcha on a same-commit rebuild, and the cleanup policy.
+
+Download URL shape:
+
+```text
+https://github.com/mat3ra/code/releases/download/wip-<short-sha>/code.tgz
+```
+
+Reinstall in `web-app` after a same-commit rebuild (plain `npm install` won't refetch —
+see the linked README for why):
+
+```bash
+npm run mat3ra:install -- code wip-<short-sha>
+```
+
+Delete a pre-release once its commit merges and a real published version supersedes it:
+
+```bash
+gh release delete wip-<short-sha> --yes
+```
+
+(Or let this repo's `cleanup-wip-releases.yml` do it automatically once that commit is
+no longer any branch's tip.)