@powerhousedao/academy 4.0.0 → 4.1.0-dev.1

package/CHANGELOG.md

@@ -1,12 +1,84 @@
-# 4.0.0 (2025-07-24)
+## 4.1.0-dev.1 (2025-07-29)
+
+### 🚀 Features
+
+- added vetra command and vetra project ([#1713](https://github.com/powerhouse-inc/powerhouse/pull/1713))
+
+### ❤️ Thank You
+
+- Guillermo Puente Sandoval @gpuente
+
+## 4.0.0-staging.8 (2025-07-29)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 4.0.0-staging.5 (2025-07-23)
+## 4.0.0-staging.7 (2025-07-26)
+
+### 🚀 Features
+
+- **state:** make all atom states derivative ([68a4bfece](https://github.com/powerhouse-inc/powerhouse/commit/68a4bfece))
+
+### ❤️ Thank You
+
+- ryanwolhuter @ryanwolhuter
+
+## 4.0.0-staging.6 (2025-07-25)
+
+### 🚀 Features
+
+- **connect:** remove unused dep ([00d3f68c0](https://github.com/powerhouse-inc/powerhouse/commit/00d3f68c0))
+- **state:** use reactor on window object ([40321826e](https://github.com/powerhouse-inc/powerhouse/commit/40321826e))
+- **state:** add state package reference to monorepo tsconfig ([93de86073](https://github.com/powerhouse-inc/powerhouse/commit/93de86073))
+- **state:** remove unused deps ([d681fff7a](https://github.com/powerhouse-inc/powerhouse/commit/d681fff7a))
+- **state:** remove jotai optics dep ([dfc955a82](https://github.com/powerhouse-inc/powerhouse/commit/dfc955a82))
+- **common:** add storybook react dev dep ([61404f414](https://github.com/powerhouse-inc/powerhouse/commit/61404f414))
+- **common:** install storybook types ([c4d45bb7c](https://github.com/powerhouse-inc/powerhouse/commit/c4d45bb7c))
+- **connect:** use new hooks ([93a9eccfa](https://github.com/powerhouse-inc/powerhouse/commit/93a9eccfa))
+- **state:** move state code to own package ([605bd5d75](https://github.com/powerhouse-inc/powerhouse/commit/605bd5d75))
+- support initial strand without operations ([46698d2ff](https://github.com/powerhouse-inc/powerhouse/commit/46698d2ff))
+- **document-drive:** removed drive id where possible ([adcedc4f0](https://github.com/powerhouse-inc/powerhouse/commit/adcedc4f0))
+
+### 🩹 Fixes
+
+- **document-drive:** added deprecation warnings and release notes ([dbc86d172](https://github.com/powerhouse-inc/powerhouse/commit/dbc86d172))
+- **common:** update storybook story type ([a84550281](https://github.com/powerhouse-inc/powerhouse/commit/a84550281))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+- ryanwolhuter @ryanwolhuter
+
+## 3.3.0-dev.19 (2025-07-25)
+
+### 🚀 Features
+
+- **connect:** remove unused dep ([00d3f68c0](https://github.com/powerhouse-inc/powerhouse/commit/00d3f68c0))
+- **state:** use reactor on window object ([40321826e](https://github.com/powerhouse-inc/powerhouse/commit/40321826e))
+- **state:** add state package reference to monorepo tsconfig ([93de86073](https://github.com/powerhouse-inc/powerhouse/commit/93de86073))
+- **state:** remove unused deps ([d681fff7a](https://github.com/powerhouse-inc/powerhouse/commit/d681fff7a))
+- **state:** remove jotai optics dep ([dfc955a82](https://github.com/powerhouse-inc/powerhouse/commit/dfc955a82))
+- **common:** add storybook react dev dep ([61404f414](https://github.com/powerhouse-inc/powerhouse/commit/61404f414))
+- **common:** install storybook types ([c4d45bb7c](https://github.com/powerhouse-inc/powerhouse/commit/c4d45bb7c))
+- **connect:** use new hooks ([93a9eccfa](https://github.com/powerhouse-inc/powerhouse/commit/93a9eccfa))
+- **state:** move state code to own package ([605bd5d75](https://github.com/powerhouse-inc/powerhouse/commit/605bd5d75))
+- support initial strand without operations ([46698d2ff](https://github.com/powerhouse-inc/powerhouse/commit/46698d2ff))
+- **document-drive:** removed drive id where possible ([adcedc4f0](https://github.com/powerhouse-inc/powerhouse/commit/adcedc4f0))
+
+### 🩹 Fixes
+
+- **document-drive:** added deprecation warnings and release notes ([dbc86d172](https://github.com/powerhouse-inc/powerhouse/commit/dbc86d172))
+- **common:** update storybook story type ([a84550281](https://github.com/powerhouse-inc/powerhouse/commit/a84550281))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+- ryanwolhuter @ryanwolhuter
+
+## 3.3.0-dev.18 (2025-07-24)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 4.0.0-staging.4 (2025-07-22)
+## 3.3.0-dev.17 (2025-07-23)
 
 ### 🩹 Fixes
 
@@ -17,11 +89,11 @@ This was a version bump only for @powerhousedao/academy to align it with other p
 
 - Callme-T
 
-## 4.0.0-staging.3 (2025-07-17)
+## 3.3.0-dev.16 (2025-07-22)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
 
-## 4.0.0-staging.2 (2025-07-17)
+## 3.3.0-dev.15 (2025-07-17)
 
 ### 🩹 Fixes
 
@@ -30,13 +102,9 @@ This was a version bump only for @powerhousedao/academy to align it with other p
 
 ### ❤️ Thank You
 
-- acaldas @acaldas
+- acaldas
 - Callme-T
 
-## 4.0.0-staging.1 (2025-07-17)
-
-This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
-
 ## 3.3.0-dev.14 (2025-07-17)
 
 This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.

package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/07-Authorization/02-Authorization.md

@@ -1,10 +1,10 @@
-# Switchboard authorization
+# Reactor API Authorization
 
-This tutorial explains how to configure authorization for the Powerhouse Switchboard using the new role-based authentication system.
+This tutorial explains how to configure authorization for the Powerhouse Reactor API using the new role-based authentication system.
 
 ## Basic configuration
 
-The Switchboard supports two main ways to configure authorization:
+The Reactor API supports two main ways to configure authorization:
 
 1. Using environment variables
 2. Using the powerhouse configuration file
@@ -33,13 +33,11 @@ Alternatively, you can configure authorization in your `powerhouse.config.json`:
 
 ```json
 {
-  "switchboard": {
-    "auth": {
-      "enabled": true,
-      "guests": ["0x789", "0xabc"],
-      "users": ["0xdef", "0xghi"],
-      "admins": ["0x123", "0x456"]
-    }
+  "auth": {
+    "enabled": true,
+    "guests": ["0x789", "0xabc"],
+    "users": ["0xdef", "0xghi"],
+    "admins": ["0x123", "0x456"]
   }
 }
 ```
@@ -65,14 +63,14 @@ The new authorization system implements role-based access control with three dis
 
 ## Docker configuration
 
-When running the Switchboard in Docker, you can pass these configurations as environment variables:
+When running the Reactor API in Docker, you can pass these configurations as environment variables:
 
 ```bash
 docker run -e AUTH_ENABLED=true \
            -e GUESTS="0x789,0xabc" \
            -e USERS="0xdef,0xghi" \
            -e ADMINS="0x123,0x456" \
-           your-switchboard-image
+           your-Reactor API-image
 ```
 
 ## Authorization flow
@@ -95,6 +93,6 @@ If you encounter authorization issues:
 
 1. Check that AUTH_ENABLED is set appropriately
 2. Verify wallet addresses are correctly formatted in their respective roles
-3. Check the Switchboard logs for detailed error messages
+3. Check the Reactor API logs for detailed error messages
 4. Verify that your database and Redis connections are working
 5. Confirm that users are assigned to the correct roles

package/docs/academy/04-APIReferences/00-PowerhouseCLI.md

@@ -220,6 +220,7 @@ Examples:
 - [Switchboard](#switchboard)
 - [Uninstall](#uninstall)
 - [Version](#version)
+- [Vetra](#vetra)
 
 ## Connect Build
 
@@ -704,6 +705,49 @@ Notes:
   - Version information is read from the package.json file of the CLI
 ```
 
+## Vetra
+
+```
+Command Overview:
+  The vetra command sets up a complete Vetra development environment for working with Vetra projects.
+  It starts three coordinated services: a Vetra Switchboard, a Local Reactor, and Connect Studio,
+  enabling full document collaboration and real-time processing with a "Vetra" drive.
+
+  This command:
+  1. Starts a Vetra Switchboard with a "Vetra" drive for document storage
+  2. Starts a Local Reactor that connects to the Vetra Switchboard as a remote drive
+  3. Starts Connect Studio pointing to the Local Reactor for user interaction
+  4. Enables real-time updates, collaboration, and code generation across all services
+
+Options:
+  --generate               Generate code automatically when document models are updated.
+                          This keeps your code in sync with model changes across all services.
+                        
+  --switchboard-port <port> Specify the port to use for the Vetra Switchboard service.
+                          Default is 4001. The Switchboard handles document storage.
+                        
+  --reactor-port <port>    Specify the port to use for the Local Reactor service.
+                          Default is 4002. The Reactor provides the main API and connects to switchboard.
+                        
+  --https-key-file <path>  Path to the SSL key file if using HTTPS for secure connections.
+                        
+  --https-cert-file <path> Path to the SSL certificate file if using HTTPS.
+                        
+  --config-file <path>     Path to the powerhouse.config.js file. This allows you to
+                          customize the behavior of all services in the Vetra development environment.
+                        
+  -w, --watch              Watch for local changes to document models and processors,
+                          and automatically update both the Switchboard and Reactor accordingly.
+
+Examples:
+  $ ph vetra                                           # Start complete Vetra environment with defaults
+  $ ph vetra --generate                                # Auto-generate code on model changes
+  $ ph vetra --switchboard-port 5000 --reactor-port 5001  # Use custom ports
+  $ ph vetra --config-file custom.powerhouse.config.js # Use custom configuration
+  $ ph vetra --watch                                   # Watch for changes and auto-update
+  $ ph vetra --https-key-file key.pem --https-cert-file cert.pem  # Use HTTPS
+```
+
 ---
 
 *This document was automatically generated from the help text in the codebase.*\n<!-- AUTO-GENERATED-CLI-COMMANDS-END -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/academy",
-  "version": "4.0.0",
+  "version": "4.1.0-dev.1",
   "homepage": "https://powerhouse.academy",
   "repository": {
     "type": "git",