@powerhousedao/academy 4.1.0-dev.1 → 4.1.0-dev.100

package/docs/bookofpowerhouse/06-SNOsInActionAndPlatformEconomies.md

@@ -1,16 +1,13 @@
 # **Part 5: Powerhouse Platforms – Decentralized Operations and Builder**
 
-
 ## **Introduction**
 
 The Powerhouse architecture is not only organizational but also deeply technological. To enable scalable network organizations (SNOs) to operate effectively, Powerhouse has developed two core platforms that provide the infrastructure for decentralized coordination and execution: the **Decentralized Operations Platform** and the **Builder Platform**. These platforms are complementary: one structures and stabilizes daily operations; the other opens up participation and innovation.
 
 Together, they form the digital substrate of the Powerhouse model, encoding its governance logic, collaboration structures, and incentive mechanisms directly into software.
 
-
 ---
 
-
 ## **Decentralized Operations Platform**
 
 The Decentralized Operations Platform serves as the operational engine of a SNO. It provides the workflows, rules, and execution logic required for contributors to collaborate without a central management layer. This includes systems for compensation, budgeting, IP management, and contributor reputation.
@@ -21,10 +18,8 @@ The Decentralized Operations Platform also embeds accountability. Actions taken
 
 Strategically, the platform supports multiple service categories, including governance operations, legal and financial services, and compliance. Each of these is modular, and the marketplace of service providers enables networks to plug in what they need, when they need it. Revenue is structured around project-based transactions and reinforced by policies that encourage on-platform fulfillment, ensuring alignment across stakeholders.
 
-
 ---
 
-
 ## **Builder Platform**
 
 While the Decentralized Operations Platform governs execution, the Builder Platform governs creation. It is designed for extending the Powerhouse architecture—enabling developers and contributors to build new tools, workflows, and modules that others in the ecosystem can use.
@@ -37,10 +32,8 @@ Technically, the Builder Platform is integrated with the rest of the Powerhouse
 
 Strategically, the platform ensures that innovation remains decentralized. No single team or organization controls what can or cannot be built. Any contributor with sufficient context and intent can extend the system—and be rewarded for doing so. This model transforms Powerhouse from a static platform into a living ecosystem.
 
-
 ---
 
-
 ## **A Unified Infrastructure Layer**
 
 Together, these platforms operationalize the vision of scalable, decentralized networks. The Operations Platform provides the scaffolding for work: roles, rules, payments, and projects. The Builder Platform enables the ecosystem to evolve: by building, sharing, and monetizing new capabilities. They are not products to be sold—they are foundational infrastructure for a new kind of organization.

package/docusaurus.config.ts

@@ -1,65 +1,63 @@
-import { themes as prismThemes } from 'prism-react-renderer';
-import type { Config } from '@docusaurus/types';
-import type * as Preset from '@docusaurus/preset-classic';
+import { themes as prismThemes } from "prism-react-renderer";
+import type { Config } from "@docusaurus/types";
+import type * as Preset from "@docusaurus/preset-classic";
 
 const config: Config = {
-  title: 'Powerhouse Academy',
-  tagline: 'Get started with the Powerhouse ecosystem',
-  favicon: 'img/ph-icon-light.svg',
+  title: "Powerhouse Academy",
+  tagline: "Get started with the Powerhouse ecosystem",
+  favicon: "img/ph-icon-light.svg",
 
   // Set the production url of your site here
-  url: 'https://powerhouse.academy',
+  url: "https://powerhouse.academy",
   // Set the /<baseUrl>/ pathname under which your site is served
   // For GitHub pages deployment, it is often '/<projectName>/'
-  baseUrl: '/',
+  baseUrl: "/",
 
   // GitHub pages deployment config.
   // If you aren't using GitHub pages, you don't need these.
-  organizationName: '', // Usually your GitHub org/user name.
-  projectName: '', // Usually your repo name.
+  organizationName: "", // Usually your GitHub org/user name.
+  projectName: "", // Usually your repo name.
 
-  onBrokenLinks: 'warn',
-  onBrokenMarkdownLinks: 'warn',
-  deploymentBranch: 'gh-pages',
+  onBrokenLinks: "warn",
+  onBrokenMarkdownLinks: "warn",
+  deploymentBranch: "gh-pages",
   trailingSlash: false,
-  onBrokenAnchors: 'ignore',
+  onBrokenAnchors: "ignore",
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you
   // may want to replace "en" with "zh-Hans".
   i18n: {
-    defaultLocale: 'en',
-    locales: ['en'],
+    defaultLocale: "en",
+    locales: ["en"],
   },
 
   presets: [
     [
-      'classic',
+      "classic",
       {
         docs: {
-          routeBasePath: '/',
-          sidebarPath: './sidebars.ts',
-          editUrl:
-            'https://github.com/powerhouse-inc/powerhouse-docs/tree/dev',
+          routeBasePath: "/",
+          sidebarPath: "./sidebars.ts",
+          editUrl: "https://github.com/powerhouse-inc/powerhouse-docs/tree/dev",
           showLastUpdateTime: false,
           showLastUpdateAuthor: false,
         },
         theme: {
-          customCss: './src/css/custom.css',
+          customCss: "./src/css/custom.css",
         },
         blog: {
           showReadingTime: false,
-          editUrl:
-            'https://github.com/powerhouse-inc/powerhouse-docs/tree/dev',
-          onInlineAuthors: 'ignore',
+          editUrl: "https://github.com/powerhouse-inc/powerhouse-docs/tree/dev",
+          onInlineAuthors: "ignore",
           showLastUpdateTime: false,
           showLastUpdateAuthor: false,
         },
         sitemap: {
-          changefreq: 'weekly',
+          changefreq: "weekly",
           priority: 0.5,
-          ignorePatterns: ['/tags/**'],
-          filename: 'sitemap.xml',
+          ignorePatterns: ["/tags/**"],
+          filename: "sitemap.xml",
         },
       } satisfies Preset.Options,
     ],
@@ -67,86 +65,86 @@ const config: Config = {
 
   themeConfig: {
     // Replace with your project's social card
-    image: 'img/docusaurus-social-card.jpg',
+    image: "img/docusaurus-social-card.jpg",
     algolia: {
-      appId: '2P4JJIQAAV',
-      apiKey: 'b5d796c3c48626f107dabdcb1cd77f29',
-      indexName: 'staging-powerhouse',
+      appId: "2P4JJIQAAV",
+      apiKey: "b5d796c3c48626f107dabdcb1cd77f29",
+      indexName: "staging-powerhouse",
       contextualSearch: true,
     },
     navbar: {
-      title: '',
+      title: "",
       logo: {
-        alt: 'My Site Logo',
-        src: 'img/Powerhouse-main.svg',
-        srcDark: 'img/Powerhouse-main-light.svg',
-        href: '/',
+        alt: "My Site Logo",
+        src: "img/Powerhouse-main.svg",
+        srcDark: "img/Powerhouse-main-light.svg",
+        href: "/",
       },
       items: [
         {
-          type: 'docSidebar',
-          sidebarId: 'academySidebar',
-          position: 'left',
-          label: 'Academy',
+          type: "docSidebar",
+          sidebarId: "academySidebar",
+          position: "left",
+          label: "Academy",
         },
         {
-          href: 'https://github.com/powerhouse-inc/powerhouse-docs',
-          label: 'GitHub',
-          position: 'right',
+          href: "https://github.com/powerhouse-inc/powerhouse-docs",
+          label: "GitHub",
+          position: "right",
         },
       ],
     },
     footer: {
-      style: 'dark',
+      style: "dark",
       links: [
         {
-          title: 'Docs',
+          title: "Docs",
           items: [
             {
-              label: 'Connect',
-              to: 'academy/Architecture/PowerhouseArchitecture',
+              label: "Connect",
+              to: "academy/Architecture/PowerhouseArchitecture",
             },
             {
-              label: 'Reactor',
-              to: 'academy/Architecture/PowerhouseArchitecture',
+              label: "Reactor",
+              to: "academy/Architecture/PowerhouseArchitecture",
             },
             {
-              label: 'Switchboard',
-              to: 'academy/Architecture/PowerhouseArchitecture',
+              label: "Switchboard",
+              to: "academy/Architecture/PowerhouseArchitecture",
             },
             {
-              label: 'Renown',
-              to: 'academy/Architecture/PowerhouseArchitecture',
+              label: "Renown",
+              to: "academy/Architecture/PowerhouseArchitecture",
             },
             {
-              label: 'FAQ',
-              to: 'academy/Architecture/PowerhouseArchitecture',
+              label: "FAQ",
+              to: "academy/Architecture/PowerhouseArchitecture",
             },
             {
               label: "Blog",
-              to: '/blog'
-            }
+              to: "/blog",
+            },
           ],
         },
         {
-          title: 'Community',
+          title: "Community",
           items: [
             {
-              label: 'Discord',
-              href: 'https://discord.gg/h7GKvqDyDP',
+              label: "Discord",
+              href: "https://discord.gg/h7GKvqDyDP",
             },
             {
-              label: 'X',
-              href: 'https://x.com/PowerhouseDAO',
+              label: "X",
+              href: "https://x.com/PowerhouseDAO",
             },
           ],
         },
         {
-          title: 'More',
+          title: "More",
           items: [
             {
-              label: 'GitHub',
-              href: 'https://github.com/powerhouse-inc',
+              label: "GitHub",
+              href: "https://github.com/powerhouse-inc",
             },
           ],
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/academy",
-  "version": "4.1.0-dev.1",
+  "version": "4.1.0-dev.100",
   "homepage": "https://powerhouse.academy",
   "repository": {
     "type": "git",
@@ -16,15 +16,17 @@
     "@powerhousedao/design-system": "^1.6.0",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.8.0",
-    "@docusaurus/tsconfig": "^3.8.0",
-    "@docusaurus/types": "^3.8.0",
+    "@docusaurus/module-type-aliases": "^3.9.1",
+    "@docusaurus/tsconfig": "^3.9.1",
+    "@docusaurus/types": "^3.9.1",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
     "tsx": "^4.20.3",
-    "typescript": "^5.7.3"
+    "typescript": "^5.9.3"
   },
   "browserslist": {
     "production": [

package/scripts/generate-combined-cli-docs.ts

@@ -12,11 +12,33 @@ async function generateCombinedCliDocs() {
     const __dirname = path.dirname(__filename);
 
     // Define paths
-    const academyDocsDir = path.resolve(__dirname, "..", "docs", "academy", "04-APIReferences");
+    const academyDocsDir = path.resolve(
+      __dirname,
+      "..",
+      "docs",
+      "academy",
+      "04-APIReferences",
+    );
     const targetDocFile = path.join(academyDocsDir, "00-PowerhouseCLI.md");
 
-    const phCliCommandsPath = path.resolve(__dirname, "..", "..", "..", "clis", "ph-cli", "COMMANDS.md");
-    const phCmdCommandsPath = path.resolve(__dirname, "..", "..", "..", "clis", "ph-cmd", "COMMANDS.md");
+    const phCliCommandsPath = path.resolve(
+      __dirname,
+      "..",
+      "..",
+      "..",
+      "clis",
+      "ph-cli",
+      "COMMANDS.md",
+    );
+    const phCmdCommandsPath = path.resolve(
+      __dirname,
+      "..",
+      "..",
+      "..",
+      "clis",
+      "ph-cmd",
+      "COMMANDS.md",
+    );
 
     // Read COMMANDS.md files
     const phCliCommandsContent = fs.readFileSync(phCliCommandsPath, "utf8");
@@ -27,13 +49,18 @@ async function generateCombinedCliDocs() {
       const tocHeader = "## Table of Contents";
       const tocIndex = content.indexOf(tocHeader);
       if (tocIndex === -1) {
-        console.warn(`Warning: "## Table of Contents" not found in ${cliName} COMMANDS.md. Including entire file.`);
+        console.warn(
+          `Warning: "## Table of Contents" not found in ${cliName} COMMANDS.md. Including entire file.`,
+        );
         return content;
       }
-      let commandsSection = content.substring(tocIndex + tocHeader.length).trim();
-      
+      let commandsSection = content
+        .substring(tocIndex + tocHeader.length)
+        .trim();
+
       // Remove the auto-generation footer
-      const footerRegex = /---\\n\\n\\\*This document was automatically generated from the help text in the codebase\\\.\\\*\\n?$/m;
+      const footerRegex =
+        /---\\n\\n\\\*This document was automatically generated from the help text in the codebase\\\.\\\*\\n?$/m;
       commandsSection = commandsSection.replace(footerRegex, "").trim();
       return commandsSection;
     };
@@ -42,7 +69,7 @@ async function generateCombinedCliDocs() {
     const phCmdDocs = extractCommands(phCmdCommandsContent, "ph-cmd");
 
     // Prepare the combined markdown
-    let combinedDocs = `### ph-cmd Commands\\n\\n${phCmdDocs}\\n\\n### ph-cli Commands\\n\\n${phCliDocs}`;
+    const combinedDocs = `### ph-cmd Commands\\n\\n${phCmdDocs}\\n\\n### ph-cli Commands\\n\\n${phCliDocs}`;
 
     // Read the target documentation file
     let targetDocContent = fs.readFileSync(targetDocFile, "utf8");
@@ -54,11 +81,13 @@ async function generateCombinedCliDocs() {
     const endIndex = targetDocContent.indexOf(endPlaceholder);
 
     if (startIndex === -1 || endIndex === -1) {
-      console.error(`Error: Placeholders not found in ${targetDocFile}. Please ensure the file contains:\\n${startPlaceholder}\\n...\\n${endPlaceholder}`);
+      console.error(
+        `Error: Placeholders not found in ${targetDocFile}. Please ensure the file contains:\\n${startPlaceholder}\\n...\\n${endPlaceholder}`,
+      );
       process.exit(1);
     }
 
-    targetDocContent = 
+    targetDocContent =
       targetDocContent.substring(0, startIndex + startPlaceholder.length) +
       "\\n<!-- This content is automatically generated. Do not edit directly. -->\\n" +
       combinedDocs +
@@ -68,8 +97,9 @@ async function generateCombinedCliDocs() {
     // Write the updated content back to the target file
     fs.writeFileSync(targetDocFile, targetDocContent);
 
-    console.log(`✅ Combined CLI documentation has been generated at ${targetDocFile}`);
-
+    console.log(
+      `✅ Combined CLI documentation has been generated at ${targetDocFile}`,
+    );
   } catch (error) {
     console.error("Failed to generate combined CLI documentation:", error);
     process.exit(1);
@@ -77,4 +107,4 @@ async function generateCombinedCliDocs() {
 }
 
 // Run the script
-generateCombinedCliDocs(); 
+generateCombinedCliDocs();

package/sidebars.ts

@@ -24,6 +24,8 @@ const sidebars = {
         "academy/GetStarted/DefineToDoListDocumentModel",
         "academy/GetStarted/ImplementOperationReducers",
         "academy/GetStarted/BuildToDoListEditor",
+        "academy/GetStarted/VetraStudio",
+        "academy/GetStarted/ReactorMCP",
       ],
     },
     {