chore: clean up repo structure - move scripts to scripts/ directory

- Moved release.sh, test-publish-local.sh, test-version-update.sh, and update-versions.js to scripts/
- Updated GitHub Actions workflow to reference new script paths
- Updated release.sh usage instructions
- Added scripts/README.md to document all utility scripts

Author: realfishsam

.github/workflows/publish.yml

@@ -28,7 +28,7 @@ jobs:
           echo "Publishing version: $VERSION"
       
       - name: Update package versions
-        run: node update-versions.js ${{ steps.get_version.outputs.version }}
+        run: node scripts/update-versions.js ${{ steps.get_version.outputs.version }}
 
       - name: Install dependencies
         run: npm ci
@@ -82,7 +82,7 @@ jobs:
           echo "Publishing version: $VERSION"
       
       - name: Update package versions
-        run: node update-versions.js ${{ steps.get_version.outputs.version }}
+        run: node scripts/update-versions.js ${{ steps.get_version.outputs.version }}
 
       - name: Generate SDKs
         run: |

scripts/README.md

@@ -0,0 +1,69 @@
+# Scripts
+
+This directory contains utility scripts for the PMXT project.
+
+## Available Scripts
+
+### `release.sh`
+Release automation script that creates and pushes version tags.
+
+**Usage:**
+```bash
+./scripts/release.sh <version>
+```
+
+**Example:**
+```bash
+./scripts/release.sh 0.5.0
+```
+
+**What it does:**
+1. Validates version format
+2. Creates a git tag `v<version>`
+3. Pushes the tag to GitHub
+4. Triggers GitHub Actions to build and publish all packages
+
+---
+
+### `update-versions.js`
+Node.js script to update version numbers across all package files.
+
+**Usage:**
+```bash
+node scripts/update-versions.js <version>
+```
+
+**What it updates:**
+- `core/package.json`
+- `sdks/javascript/package.json`
+- `sdks/python/pyproject.toml`
+
+---
+
+### `test-publish-local.sh`
+Test script for validating the publish workflow locally before pushing tags.
+
+**Usage:**
+```bash
+./scripts/test-publish-local.sh
+```
+
+**What it does:**
+1. Builds all packages
+2. Starts the PMXT server
+3. Runs all SDK tests
+4. Validates everything works before release
+
+---
+
+### `test-version-update.sh`
+Test script for validating the version update functionality.
+
+**Usage:**
+```bash
+./scripts/test-version-update.sh
+```
+
+**What it does:**
+1. Tests version number extraction from git tags
+2. Validates that `update-versions.js` correctly updates all package files

release.sh scripts/release.shrelease.sh renamed to scripts/release.sh

@@ -1,15 +1,15 @@
 #!/bin/bash
 
 # Release script for PMXT
-# Usage: ./release.sh <version>
-# Example: ./release.sh 0.5.0
+# Usage: ./scripts/release.sh <version>
+# Example: ./scripts/release.sh 0.5.0
 
 set -e
 
 if [ -z "$1" ]; then
     echo "[ERROR] Error: Version number required"
-    echo "Usage: ./release.sh <version>"
-    echo "Example: ./release.sh 0.5.0"
+    echo "Usage: ./scripts/release.sh <version>"
+    echo "Example: ./scripts/release.sh 0.5.0"
     exit 1
 fi