Init docs lib simulation with inline commenting and module build

Author: nanehambardzumyan

.github/workflows/build-release.yml

@@ -0,0 +1,59 @@
+name: Build and Release
+
+on:
+  push:
+    branches: [ main ]
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Populate design system submodule
+        run: git submodule update --init
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.13.1'
+          cache: 'npm'
+
+      - name: Install all dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Install production dependencies only
+        run: |
+          npm ci --production
+
+      - name: Create release tarball
+        run: |
+          tar -czf release.tar.gz dist/ package.json server.js node_modules/
+
+      - name: Upload build artifact (for workflow logs)
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Create GitHub Release and upload asset
+        uses: ncipollo/release-action@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          tag: v${{ github.run_number }}
+          name: Release ${{ github.run_number }}
+          body: |
+            Latest build from main branch.
+          artifacts: release.tar.gz
+          allowUpdates: false
+          draft: false
+          prerelease: false
+          makeLatest: true

.gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+module

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "client/design-system"]
+	path = client/design-system
+	url = https://github.com/CodeSignal/learn_bespoke-design-system.git

AGENTS.md

@@ -0,0 +1,119 @@
+# Repository Guidelines
+
+This repository contains a template for building embedded applications using
+the Bespoke Simulation framework. For complete template documentation, see
+[BESPOKE-TEMPLATE.md](./BESPOKE-TEMPLATE.md).
+
+## Overview
+
+This template provides:
+- CodeSignal Design System integration
+- Consistent layout components (header, sidebar, main content area)
+- Help modal system
+- Local development server with WebSocket support
+- Standardized file structure and naming conventions
+
+## Quick Start
+
+1. **Customize the HTML template** (`client/index.html`):
+   - Replace `<!-- APP_TITLE -->` with your page title
+   - Replace `<!-- APP_NAME -->` with your app name
+   - Add your main content at `<!-- APP_SPECIFIC_MAIN_CONTENT -->`
+   - Add app-specific CSS links at `<!-- APP_SPECIFIC_CSS -->`
+   - Add app-specific JavaScript at `<!-- APP_SPECIFIC_SCRIPTS -->`
+
+2. **Create your application files**:
+   - App-specific CSS (e.g., `my-app.css`)
+   - App-specific JavaScript (e.g., `my-app.js`)
+   - Help content (based on `help-content-template.html`)
+
+3. **Start the development server**:
+   ```bash
+   npm start
+   ```
+   Server runs on `http://localhost:3000`
+
+## Key Conventions
+
+### File Naming
+
+- CSS files: kebab-case (e.g., `my-app.css`)
+- JavaScript files: kebab-case (e.g., `my-app.js`)
+- Data files: kebab-case (e.g., `solution.json`)
+- Image files: kebab-case (e.g., `overview.png`)
+
+### Error Handling
+
+- Wrap all async operations in try-catch blocks
+- Provide meaningful error messages to users
+- Log errors to console for debugging
+- Implement retry logic for network operations
+- Handle localStorage quota exceeded errors
+- Validate data before saving operations
+
+## Development Workflow
+
+### Build and Test
+
+```bash
+# Start development server
+npm start
+
+# Development mode (same as start)
+npm run dev
+```
+
+### WebSocket Messaging
+
+The server provides a `POST /message` endpoint for real-time messaging:
+
+```bash
+curl -X POST http://localhost:3000/message \
+  -H "Content-Type: application/json" \
+  -d '{"message": "Your message here"}'
+```
+
+This sends alerts to connected clients. Requires `ws` package:
+```bash
+npm install
+```
+
+## Template Documentation
+
+For detailed information about:
+- Design System usage and components
+- CSS implementation guidelines
+- JavaScript API (HelpModal)
+- Component reference and examples
+- Customization options
+
+See [BESPOKE-TEMPLATE.md](./BESPOKE-TEMPLATE.md).
+
+## Project Structure
+
+```
+client/
+  ├── index.html              # Main HTML template
+  ├── app.js                  # Application logic
+  ├── bespoke-template.css    # Template-specific styles
+  ├── help-modal.js           # Help modal system
+  ├── help-content-template.html  # Help content template
+  └── design-system/          # CodeSignal Design System
+      ├── colors/
+      ├── spacing/
+      ├── typography/
+      └── components/
+server.js                      # Development server
+```
+
+## Notes for AI Agents
+
+When working on applications built with this template:
+
+1. **Always reference BESPOKE-TEMPLATE.md** for template-specific
+   implementation details
+2. **Follow the conventions** listed above for file naming
+3. **Use Design System components** directly - see BESPOKE-TEMPLATE.md for
+   component classes and usage
+4. **Maintain consistency** with the template's structure and patterns
+5. **Keep guidelines up to date** by editing this AGENTS.md file as the codebase evolves