Feature/integrate xp contract

.aws/ami/README.md

@@ -28,7 +28,8 @@ This assumes you installed Packer to your PATH.
 
 ```
 $ cd ./.aws/ami
-$ packer build packer.json
+$ packer init packer.json.pkr.hcl
+$ packer build packer.json.pkr.hcl
 ```
 
 When finished, you will have a new AMI named `nodejs-docker-ubuntu20-{{timestamp}}` in your AWS account.

.aws/ami/packer.json.pkr.hcl

@@ -0,0 +1,63 @@
+packer {
+  required_version = ">= 0.12.0"
+  required_plugins {
+    amazon = {
+      source  = "github.com/hashicorp/amazon"
+      version = "~> 1"
+    }
+  }
+}
+
+variable "aws_region" {
+  type    = string
+  default = "us-east-1"
+}
+
+variable "node_version" {
+  type    = string
+  default = "20.18.3"
+}
+
+data "amazon-ami" "autogenerated_1" {
+  filters = {
+    architecture                       = "arm64"
+    "block-device-mapping.volume-type" = "gp2"
+    name                               = "ubuntu/images/hvm-ssd/ubuntu-focal-20.04-arm64-server-*"
+    root-device-type                   = "ebs"
+    virtualization-type                = "hvm"
+  }
+  most_recent = true
+  owners      = ["099720109477"]
+  profile     = "casualsimulation"
+  region      = "${var.aws_region}"
+}
+
+locals { timestamp = regex_replace(timestamp(), "[- TZ:]", "") }
+
+source "amazon-ebs" "ubuntu20-ami" {
+  ami_description = "A Ubuntu 20.04 AMI that has Node.js and Docker"
+  ami_name        = "nodejs-docker-ubuntu20-${local.timestamp}"
+  instance_type   = "t4g.micro"
+  profile         = "casualsimulation"
+  region          = "${var.aws_region}"
+  source_ami      = "${data.amazon-ami.autogenerated_1.id}"
+  ssh_username    = "ubuntu"
+}
+
+build {
+  sources = ["source.amazon-ebs.ubuntu20-ami"]
+
+  provisioner "shell" {
+    script = "${path.root}/install-aws-cli.sh"
+  }
+
+  provisioner "shell" {
+    script = "${path.root}/install-docker.sh"
+  }
+
+  provisioner "shell" {
+    environment_vars = ["NODE_VERSION=${var.node_version}"]
+    script           = "${path.root}/install-nodejs.sh"
+  }
+
+}

.github/ISSUE_TEMPLATE/fix-request.yml

@@ -0,0 +1,37 @@
+name: 🛠️ Fix Request
+description: Request a bug fix or change that Claude can auto-pick up
+labels: ['fix', 'claude']
+body:
+    - type: markdown
+      attributes:
+          value: |
+              Thanks for filing a fix request!  
+              👉 To have Claude auto-create a branch & PR, make sure to **comment** with:
+
+              ```
+              @claude please fix this
+              ```
+
+              Claude will:
+              - Read this issue
+              - Create a branch
+              - Apply changes
+              - Run tests/linters if available
+              - Open a pull request tied to this issue
+
+    - type: input
+      id: summary
+      attributes:
+          label: ✏️ Summary
+          description: A short description of the problem
+          placeholder: 'Login button throws 500 when email already exists'
+
+    - type: textarea
+      id: steps
+      attributes:
+          label: ✅ Steps to Reproduce / Notes
+          description: Steps, logs, or extra info Claude should see
+          placeholder: |
+              1. Go to /signup
+              2. Enter an already-registered email
+              3. Submit form → error 500

.github/copilot-instructions.md

@@ -0,0 +1,226 @@
+# CasualOS Copilot Coding Agent Instructions
+
+## Repository Overview
+
+**CasualOS** is a set of web-based tools designed to facilitate the creation of real-time, multi-user, context-aware interactive experiences. This is a large-scale TypeScript/JavaScript monorepo (36+ packages) using PNPM for package management, built with modern web technologies including Vue.js, Three.js, and Node.js.
+
+**Repository Statistics:**
+
+-   36 workspace packages total (34 in src/ + docs + root)
+-   Primary languages: TypeScript (80%), JavaScript, Vue, HTML, CSS
+-   Package manager: pnpm v10.10.0+ (managed by corepack)
+-   Node.js: v20.18+ required
+-   Build tool: TypeScript compiler + esbuild + Vite
+-   Test framework: Jest
+-   Linting: ESLint v9 with TypeScript ESLint
+-   Docker support for development services
+
+## Build and Development Workflow
+
+### Prerequisites and Environment Setup
+
+**ALWAYS run these commands in this exact order before any other operations:**
+
+1. **Enable corepack** (critical for pnpm):
+
+    ```bash
+    corepack enable
+    ```
+
+2. **Install dependencies** (use frozen lockfile in CI, regular install for development):
+
+    ```bash
+    npm run bootstrap  # Production: pnpm install --frozen-lockfile
+    # OR for development without network restrictions:
+    npm run bootstrap -- --ignore-scripts
+    ```
+
+3. **Start development services** (required for full functionality):
+    ```bash
+    # Choose one based on your Docker setup:
+    npm run docker:dev     # If using standard docker
+    npm run nerdctl:dev    # If using nerdctl/Rancher Desktop
+    ```
+
+### Build Commands - Execution Order and Timing
+
+**CRITICAL: Build commands must be run in this specific order:**
+
+1. **Build Full Project** (5-8 minutes total):
+    ```bash
+    npm run build  # Complete build including server, proxy, CLI
+    ```
+
+**Known Issues & Workarounds:**
+
+-   **Prisma Generation Failure**: Bootstrap may fail with "binaries.prisma.sh ENOTFOUND" - use `--ignore-scripts` flag and generate Prisma separately
+-   **Memory Issues**: Use `--max_old_space_size=4096` for Node.js in memory-intensive operations
+-   **Git Tags Missing**: Some builds (CLI) require git tags for version info - expect failures in fresh clones without release tags
+-   **Build Dependencies**: Libraries MUST be built before server/web components
+-   **Docker Services**: MongoDB, Redis, and other services in docker-compose.dev.yml are required for full functionality, but should not be required for building.
+-   **Windows-specific**: Special node-gyp configuration required (see CI workflow)
+
+### Testing Commands
+
+**Test Execution Order:**
+
+```bash
+# Run all tests (10-15 minutes):
+npm test  # Equivalent: jest --verbose
+
+# Watch mode for development:
+npm run test:watch
+
+# CI testing (with proper flags):
+npm run test:ci  # Includes --no-cache --ci flags
+```
+
+**Common Test Issues:**
+
+-   Some tests may have network dependencies and console warnings (expected)
+-   Use `--detectOpenHandles --forceExit` flags for complete test runs
+
+### Linting and Code Quality
+
+**Linting Commands:**
+
+```bash
+npm run lint              # Full repository lint
+npm run lint:common       # Individual package linting
+npm run lint:server       # Server-specific linting
+```
+
+**Key Linting Rules:**
+
+-   Header comments required on most TypeScript files
+-   Consistent type imports: Use `import type` for type-only imports (auto-fixable)
+-   No unused imports (auto-fixable)
+-   Vue component specific rules in components directories
+
+## Project Architecture and Layout
+
+### Core Directory Structure
+
+```
+/
+├── .github/                    # GitHub workflows, templates, instructions
+├── docs/                       # Documentation site (Docusaurus)
+├── script/                     # Build helpers, deployment scripts
+├── docker/                     # Development services configuration
+├── src/                        # All source packages (34 packages)
+│   ├── aux-common/            # Core shared utilities and types
+│   ├── aux-server/            # Main web application server
+│   │   ├── aux-backend/       # Backend API configuration (includes Prisma)
+│   │   ├── aux-web/          # Frontend Vue.js applications
+│   ├── aux-vm/               # Virtual machine abstraction
+│   ├── aux-vm-browser/       # Browser VM implementation
+│   ├── aux-vm-client/        # Client VM implementation
+│   ├── aux-vm-node/          # Node.js VM implementation
+│   ├── aux-records/          # Backend API implementation
+│   ├── aux-runtime/          # Runtime execution engine (user scripts & functions, compilers, etc.)
+│   ├── casualos-cli/         # Command-line interface
+│   └── [21 other packages]   # Supporting libraries (crypto, websocket, etc.)
+├── package.json              # Root package.json with scripts
+├── lerna.json               # Lerna configuration
+├── tsconfig.json            # TypeScript project references
+└── pnpm-workspace.yaml      # PNPM workspace configuration
+```
+
+### Key Configuration Files
+
+-   **eslint.config.mjs**: ESLint v9 flat config with TypeScript rules
+-   **tsconfig.json**: TypeScript project references for all packages
+-   **jest.config.js**: Jest testing configuration with ts-jest
+-   **docker/docker-compose.dev.yml**: Development services (MongoDB, Redis, MinIO, etc.)
+
+### CI/CD Pipeline (GitHub Actions)
+
+**Continuous Integration (.github/workflows/continuous-integration-workflow.yml):**
+
+-   Triggers: All branches except master/staging/release
+-   Matrix: ubuntu/macOS/windows with Node 20.x
+-   Steps: bootstrap → test → build → lint → docs build
+-   **Critical**: Uses `corepack enable` and specific node-gyp setup for Windows
+
+**Release Pipeline (.github/workflows/release.yml):**
+
+-   Triggers: master, staging, release/\* branches
+-   Steps: test → build → npm publish → docs deploy → Docker build/push
+-   Publishes to NPM, DockerHub, and GitHub Container Registry
+
+**Known CI Issues:**
+
+-   Windows requires special node-gyp configuration
+-   Tests use `--max_old_space_size=4096` for memory management
+-   Docker builds have ARM32/ARM64 variants via AWS CodeBuild
+
+## Development Best Practices
+
+### Code Style Guidelines (from existing .github/instructions)
+
+-   **Naming**: camelCase (variables/functions), PascalCase (classes), ALL_CAPS (constants)
+-   **Private members**: prefix with `_` and use `private` keyword
+-   **Imports**: Use ES6 modules, prefer `import type` for types
+-   **Documentation**: JSDoc with required `@dochash` and `@docid` tags
+-   **Error handling**: try/catch for void functions, always log errors with class/method names
+
+### TypeScript Project References
+
+The repository uses TypeScript project references for efficient incremental builds. Each package in src/ has its own tsconfig.json that references dependencies.
+
+### Package Dependencies
+
+-   **Critical**: aux-common is foundational - many packages depend on it
+-   **Build order**: Libraries (aux-common, aux-vm, etc.) → Server → Applications
+-   **Circular dependencies**: Avoided through careful architecture
+
+### Release Notes
+
+Make sure to update CHANGELOG.md with a summary of the changes you've made.
+
+## Quick Start for Common Tasks
+
+### Making Code Changes
+
+1. `corepack enable && npm run bootstrap`
+2. `npm run docker:dev` (start services)
+3. Make your changes
+4. `npm run build` (full build)
+5. `npm test` (verify changes)
+6. `npm run lint` (check code quality)
+7. Update CHANGELOG.md
+
+### Working with Specific Packages
+
+```bash
+# Build specific package:
+npm run build:server
+npm run build:proxy
+npm run build:cli
+
+# Lint specific package:
+npm run lint:common
+npm run lint:server
+npm run lint:components
+```
+
+### Development Server
+
+```bash
+npm run watch  # Starts Vite in watch mode + nodemon
+# Server available at http://localhost:3000 and http://localhost:3002
+```
+
+### Documentation Updates
+
+```bash
+cd docs
+npm start          # Development server
+npm run build      # Production build
+```
+
+## Trust These Instructions
+
+These instructions are based on comprehensive analysis of the codebase, successful testing of build/test/lint commands, and examination of CI/CD pipelines. **Only search for additional information if these instructions are incomplete or incorrect for your specific task.** The commands and workflows documented here have been validated and account for the major dependencies and timing requirements of this complex monorepo.
+
+When in doubt, follow the exact command sequences provided, especially for bootstrap → build → test workflows which are critical for this repository's build system.