Merge Release Auto-PR

.env.example

@@ -1 +1 @@
-PORT=4000
+PORT=4000

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: ['HeyPuter']

.github/workflows/docker-image.yaml

@@ -5,8 +5,10 @@ name: Docker Image CI
 # branch called `main`.
 on:
   push:
-    branches: ['release']
-
+    tags:
+      - '*.*.*'
+    branches:
+      - 'main'
 
 # Defines two custom environment variables for the workflow. These are used
 # for the Container registry domain, and a name for the Docker image that
@@ -40,12 +42,12 @@ jobs:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-          
-      - name: Set up QEMU 
+
+      - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       # This step uses [docker/metadata-action](https://github.com/docker/metadata-action#about)
       # to extract tags and labels that will be applied to the specified image.
@@ -56,16 +58,10 @@ jobs:
         id: meta
         uses: docker/metadata-action@v5
         with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          images: "${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}"
           tags: |
-            type=schedule
-            type=ref,event=branch
-            type=ref,event=pr
             type=semver,pattern={{version}}
-            type=semver,pattern={{major}}.{{minor}}
-            type=semver,pattern={{major}},enable=${{ !startsWith(github.ref, 'refs/tags/v0.') }}
-            type=sha
-            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', github.event.repository.default_branch) }}
+            type=ref,event=branch
 
       # This step uses the `docker/build-push-action` action to build the
       # image, based on your repository's `Dockerfile`. If the build succeeds,
@@ -81,6 +77,8 @@ jobs:
         with:
           platforms: linux/amd64,linux/arm64
           context: .
-          push: true
+          push: ${{ github.event_name != 'pull_request' }}
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/notify-prod.yaml

@@ -0,0 +1,18 @@
+name: Notify HeyPuter
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger heyputer build
+        run: |
+          curl -X POST \
+            -H "Authorization: token ${{ secrets.HEYPUTER_DISPATCH_TOKEN }}" \
+            -H "Accept: application/vnd.github.v3+json" \
+            https://api.github.com/repos/HeyPuter/heyputer/dispatches \
+            -d '{"event_type":"puter-main-updated","client_payload":{"puter_ref":"main"}}'

.github/workflows/test.yml

@@ -0,0 +1,94 @@
+name: test
+
+on:
+  push:
+    branches: ["main"]
+    paths-ignore:
+      - "src/docs/**"
+  pull_request:
+    branches: ["main"]
+    paths-ignore:
+      - "src/docs/**"
+
+jobs:
+  test-backend:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [24.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Backend Tests (with coverage)
+        env:
+          NODE_OPTIONS: "--max-old-space-size=4096"
+        run: |
+          npm ci
+          npm run build
+          npm run test:backend -- --coverage --coverage.reporter=json --coverage.reporter=json-summary --coverage.reporter=lcov
+
+      - name: Upload backend coverage report
+        if: ${{ always() && hashFiles('coverage/**/coverage-summary.json') != '' }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: backend-coverage-${{ matrix.node-version }}
+          path: coverage
+          retention-days: 5
+
+  api-test:
+    name: API tests (node env, api-test)
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    strategy:
+      matrix:
+        node-version: [24.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: API Test
+        run: |
+          pip install -r ./tests/ci/requirements.txt
+          ./tests/ci/api-test.py
+
+      - uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with:
+          name: (api-test) server-logs
+          path: /tmp/backend.log
+          retention-days: 3
+
+  vitest:
+    name: puterjs (node env, vitest)
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    strategy:
+      matrix:
+        node-version: [24.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Vitest Test
+        run: |
+          pip install -r ./tests/ci/requirements.txt
+          ./tests/ci/vitest.py

.gitignore

@@ -1,12 +1,65 @@
+# Misc
 .DS_Store
+
+# Dependencies
 node_modules/
+
 *.zip
 *.tgz
 license.config.json
 license-header.txt
+
+# Build Outputs
 dist/
-.vscode/
+
+# VS Code IDE
+.vscode/**/*
+!.vscode/extensions.json
+!.vscode/launch.json
+!.vscode/tasks.json
+
+# Local env files
 .env
+!.env.example
+
 # this is for jetbrain IDEs
 .idea/
 /puter
+
+# Local Netlify folder
+.netlify
+src/emulator/release/
+
+# ======================================================================
+# vscode
+# ======================================================================
+# vscode configuration
+.vscode/
+
+# JS language server, ref: https://code.visualstudio.com/docs/languages/jsconfig
+jsconfig.json
+
+# ======================================================================
+# playwright test (currently only test the file-system)
+# ======================================================================
+tests/client-config.yaml
+
+# ======================================================================
+# python
+# ======================================================================
+__pycache__/
+
+# ======================================================================
+# other
+# ======================================================================
+# AI STUFF
+AGENTS.md
+.roo
+
+# source maps
+*.map
+
+
+coverage/
+*.log
+undefined

.gitmodules

@@ -0,0 +1,12 @@
+[submodule "submodules/v86"]
+	path = submodules/v86
+	url = git@github.com:HeyPuter/v86.git
+[submodule "submodules/twisp"]
+	path = submodules/twisp
+	url = git@github.com:MercuryWorkshop/twisp.git
+[submodule "submodules/epoxy-tls"]
+	path = submodules/epoxy-tls
+	url = git@github.com:MercuryWorkshop/epoxy-tls.git
+[submodule "submodules/wiki"]
+	path = submodules/wiki
+	url = https://github.com/HeyPuter/puter.wiki.git

.husky/pre-commit

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+
+tmpfile="$(mktemp)"
+git diff --cached --name-only -z --diff-filter=ACMR -- \
+  '*.js' '*.mjs' '*.cjs' '*.jsx' '*.ts' '*.tsx' '*.vue' \
+  > "$tmpfile"
+
+if [ -s "$tmpfile" ]; then
+  xargs -0 eslint --fix < "$tmpfile" || true
+  xargs -0 git add < "$tmpfile"
+fi
+
+rm -f "$tmpfile"