Initial commit: Clean DSS implementation

Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm

Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)

Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability

Migration completed: $(date)
🤖 Clean migration with full functionality preserved

STORYBOOK_DEPLOYMENT.md

@@ -0,0 +1,134 @@
+# Storybook Deployment Status
+
+**Date**: 2025-12-09
+**Status**: ⚠️ Partially Deployed (HTTP only)
+
+## Current Configuration
+
+### URLs
+- **HTTP**: http://storybook.dss.overbits.luz.uy ✅ Working
+- **HTTPS**: https://storybook.dss.overbits.luz.uy ❌ Not configured
+
+### Infrastructure
+- **Port**: 6006
+- **Service**: Storybook Dev Server (PID: 3546941)
+- **Nginx Config**: `/etc/nginx/sites-available/storybook.dss.overbits.luz.uy.conf` ✅
+- **Enabled**: Yes (symlinked in sites-enabled)
+- **SSL**: ❌ Not configured
+
+### Nginx Configuration
+```nginx
+server {
+    server_name storybook.dss.overbits.luz.uy;
+
+    location / {
+        proxy_pass http://127.0.0.1:6006;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+    }
+
+    listen 80;
+}
+```
+
+## What's Working
+✅ Storybook server running on localhost:6006
+✅ Nginx reverse proxy configured
+✅ HTTP access via http://storybook.dss.overbits.luz.uy
+✅ WebSocket upgrade support (for HMR)
+
+## What's Needed
+
+### 🔐 SSL Certificate Required
+
+**Sysadmin Action Needed:**
+```bash
+# Run certbot to obtain SSL certificate
+sudo certbot --nginx -d storybook.dss.overbits.luz.uy
+
+# This will automatically:
+# 1. Obtain Let's Encrypt certificate
+# 2. Update nginx config with SSL settings
+# 3. Add HTTPS redirect from HTTP
+# 4. Set up auto-renewal
+```
+
+**Why This is Needed:**
+- Modern browsers show warnings for HTTP sites
+- WebSocket connections prefer HTTPS
+- Consistent security with main DSS site (https://dss.overbits.luz.uy)
+- Best practice for production documentation
+
+## Documentation Updates
+
+### ✅ Updated Files
+- `docs/02_status/PROJECT_STATUS.md` - Added Storybook URL to deployment status
+- `README.md` - Added Storybook to production URLs
+- `STORYBOOK_DEPLOYMENT.md` - This file
+
+### Production URLs Reference
+```
+Admin UI:   https://dss.overbits.luz.uy/              (Port 3456) ✅ HTTPS
+Storybook:  http://storybook.dss.overbits.luz.uy     (Port 6006) ⚠️ HTTP only
+DSS API:    http://localhost:3458                     (Internal)
+```
+
+## Next Steps
+
+### For Sysadmin
+1. Run certbot for `storybook.dss.overbits.luz.uy`
+2. Verify HTTPS access works
+3. Confirm auto-renewal is configured
+
+### After SSL is Configured
+1. Update this document to mark SSL as ✅
+2. Update PROJECT_STATUS.md to remove "Pending SSL" warning
+3. Update README.md to use HTTPS URL
+4. Test Storybook functionality over HTTPS
+
+## Design Token Integration
+
+Storybook is configured with DSS design tokens:
+- Token file: `admin-ui/design-tokens.json` (W3C DTCG format)
+- CSS tokens: `admin-ui/css/dss-tokens.css`
+- Theme config: `dss-mvp1/.storybook/dss-theme.ts`
+
+Components documented in Storybook:
+- 18 custom web components (ds-* prefix)
+- Complete design token library
+- Interactive component playground
+
+## Service Management
+
+### Check Status
+```bash
+ps aux | grep storybook | grep -v grep
+```
+
+### View Logs
+```bash
+# Nginx access logs
+tail -f /var/log/nginx/storybook_dss_overbits_luz_uy_access.log
+
+# Nginx error logs
+tail -f /var/log/nginx/storybook_dss_overbits_luz_uy_error.log
+```
+
+### Restart Storybook
+```bash
+cd /home/overbits/dss/dss-mvp1
+npm run storybook
+```
+
+## Summary
+
+**Status**: Storybook is running and accessible via HTTP. Only missing SSL certificate for production-ready HTTPS access.
+
+**Action Required**: Sysadmin needs to run `certbot --nginx -d storybook.dss.overbits.luz.uy`
+
+**Priority**: Medium - Site is functional but HTTP-only is not ideal for production documentation.