@powerhousedao/academy 4.1.0-dev.5 → 4.1.0-dev.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/.vscode/settings.json +1 -1
  2. package/CHANGELOG.md +386 -1
  3. package/README.md +3 -3
  4. package/babel.config.js +1 -1
  5. package/blog/BeyondCommunication-ABlueprintForDevelopment.md +25 -24
  6. package/blog/TheChallengeOfChange.md +21 -21
  7. package/docs/academy/01-GetStarted/00-ExploreDemoPackage.mdx +61 -24
  8. package/docs/academy/01-GetStarted/01-CreateNewPowerhouseProject.md +21 -12
  9. package/docs/academy/01-GetStarted/02-DefineToDoListDocumentModel.md +24 -19
  10. package/docs/academy/01-GetStarted/03-ImplementOperationReducers.md +44 -41
  11. package/docs/academy/01-GetStarted/04-BuildToDoListEditor.md +10 -10
  12. package/docs/academy/01-GetStarted/05-SpecDrivenAI.md +143 -0
  13. package/docs/academy/01-GetStarted/home.mdx +185 -90
  14. package/docs/academy/01-GetStarted/styles.module.css +5 -5
  15. package/docs/academy/02-MasteryTrack/01-BuilderEnvironment/01-Prerequisites.md +46 -18
  16. package/docs/academy/02-MasteryTrack/01-BuilderEnvironment/02-StandardDocumentModelWorkflow.md +118 -68
  17. package/docs/academy/02-MasteryTrack/01-BuilderEnvironment/03-BuilderTools.md +75 -33
  18. package/docs/academy/02-MasteryTrack/01-BuilderEnvironment/_category_.json +6 -6
  19. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/01-WhatIsADocumentModel.md +30 -21
  20. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/02-SpecifyTheStateSchema.md +41 -37
  21. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/03-SpecifyDocumentOperations.md +29 -25
  22. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/04-UseTheDocumentModelGenerator.md +36 -37
  23. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/05-ImplementDocumentReducers.md +128 -109
  24. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/06-ImplementDocumentModelTests.md +95 -86
  25. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/07-ExampleToDoListRepository.md +7 -9
  26. package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/_category_.json +6 -6
  27. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/01-BuildingDocumentEditors.md +65 -47
  28. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/02-ConfiguringDrives.md +77 -62
  29. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/03-BuildingADriveExplorer.md +360 -349
  30. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/06-DocumentTools/00-DocumentToolbar.mdx +16 -10
  31. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/06-DocumentTools/01-OperationHistory.md +10 -7
  32. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/06-DocumentTools/02-RevisionHistoryTimeline.md +26 -11
  33. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/06-DocumentTools/_category_.json +6 -6
  34. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/07-Authorization/01-RenownAuthenticationFlow.md +14 -7
  35. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/07-Authorization/02-Authorization.md +0 -1
  36. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/07-Authorization/_category_.json +5 -5
  37. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/_category_.json +1 -1
  38. package/docs/academy/02-MasteryTrack/04-WorkWithData/01-GraphQLAtPowerhouse.md +45 -33
  39. package/docs/academy/02-MasteryTrack/04-WorkWithData/02-UsingTheAPI.mdx +61 -18
  40. package/docs/academy/02-MasteryTrack/04-WorkWithData/03-UsingSubgraphs.md +105 -456
  41. package/docs/academy/02-MasteryTrack/04-WorkWithData/04-analytics-processor.md +126 -110
  42. package/docs/academy/02-MasteryTrack/04-WorkWithData/05-RelationalDbProcessor.md +98 -65
  43. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/GraphQL References/QueryingADocumentWithGraphQL.md +23 -21
  44. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/best-practices.md +9 -9
  45. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/graphql/index.md +11 -23
  46. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/graphql/integration.md +25 -9
  47. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/intro.md +10 -10
  48. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/typescript/benchmarks.md +1 -1
  49. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/typescript/index.md +16 -11
  50. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/typescript/memory.md +6 -5
  51. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/typescript/schema.md +2 -2
  52. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/typescript/utilities.md +7 -5
  53. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/use-cases/maker.md +32 -58
  54. package/docs/academy/02-MasteryTrack/04-WorkWithData/06-Analytics Engine/use-cases/processors.md +1 -1
  55. package/docs/academy/02-MasteryTrack/04-WorkWithData/07-drive-analytics.md +105 -71
  56. package/docs/academy/02-MasteryTrack/04-WorkWithData/_ARCHIVE-AnalyticsProcessorTutorial/_01-SetupBuilderEnvironment.md +22 -0
  57. package/docs/academy/02-MasteryTrack/04-WorkWithData/_ARCHIVE-AnalyticsProcessorTutorial/_02-CreateNewPowerhouseProject.md +9 -8
  58. package/docs/academy/02-MasteryTrack/04-WorkWithData/_ARCHIVE-AnalyticsProcessorTutorial/_03-GenerateAnAnalyticsProcessor.md +28 -32
  59. package/docs/academy/02-MasteryTrack/04-WorkWithData/_ARCHIVE-AnalyticsProcessorTutorial/_04-UpdateAnalyticsProcessor.md +25 -26
  60. package/docs/academy/02-MasteryTrack/04-WorkWithData/_ARCHIVE-AnalyticsProcessorTutorial/_category_.json +1 -1
  61. package/docs/academy/02-MasteryTrack/04-WorkWithData/_category_.json +7 -7
  62. package/docs/academy/02-MasteryTrack/05-Launch/01-IntroductionToPackages.md +3 -4
  63. package/docs/academy/02-MasteryTrack/05-Launch/02-PublishYourProject.md +69 -45
  64. package/docs/academy/02-MasteryTrack/05-Launch/03-SetupEnvironment.md +70 -40
  65. package/docs/academy/02-MasteryTrack/05-Launch/04-ConfigureEnvironment.md +1 -0
  66. package/docs/academy/02-MasteryTrack/05-Launch/_category_.json +7 -7
  67. package/docs/academy/02-MasteryTrack/_category_.json +6 -6
  68. package/docs/academy/03-ExampleUsecases/Chatroom/02-CreateNewPowerhouseProject.md +5 -3
  69. package/docs/academy/03-ExampleUsecases/Chatroom/03-DefineChatroomDocumentModel.md +38 -37
  70. package/docs/academy/03-ExampleUsecases/Chatroom/04-ImplementOperationReducers.md +45 -41
  71. package/docs/academy/03-ExampleUsecases/Chatroom/05-ImplementChatroomEditor.md +14 -14
  72. package/docs/academy/03-ExampleUsecases/Chatroom/06-LaunchALocalReactor.md +6 -6
  73. package/docs/academy/03-ExampleUsecases/Chatroom/_category_.json +1 -1
  74. package/docs/academy/04-APIReferences/00-PowerhouseCLI.md +50 -30
  75. package/docs/academy/04-APIReferences/01-ReactHooks.md +649 -141
  76. package/docs/academy/04-APIReferences/04-RelationalDatabase.md +121 -113
  77. package/docs/academy/04-APIReferences/05-PHDocumentMigrationGuide.md +48 -41
  78. package/docs/academy/04-APIReferences/_category_.json +6 -6
  79. package/docs/academy/05-Architecture/00-PowerhouseArchitecture.md +1 -2
  80. package/docs/academy/05-Architecture/01-WorkingWithTheReactor.md +11 -8
  81. package/docs/academy/05-Architecture/05-DocumentModelTheory/_category_.json +1 -1
  82. package/docs/academy/05-Architecture/_category_.json +6 -6
  83. package/docs/academy/06-ComponentLibrary/00-DocumentEngineering.md +25 -23
  84. package/docs/academy/06-ComponentLibrary/02-CreateCustomScalars.md +105 -93
  85. package/docs/academy/06-ComponentLibrary/03-IntegrateIntoAReactComponent.md +1 -0
  86. package/docs/academy/06-ComponentLibrary/_category_.json +7 -7
  87. package/docs/academy/07-Cookbook.md +267 -34
  88. package/docs/academy/08-Glossary.md +7 -1
  89. package/docs/bookofpowerhouse/01-Overview.md +2 -2
  90. package/docs/bookofpowerhouse/02-GeneralFrameworkAndPhilosophy.md +1 -7
  91. package/docs/bookofpowerhouse/03-PowerhouseSoftwareArchitecture.md +10 -7
  92. package/docs/bookofpowerhouse/04-DevelopmentApproaches.md +10 -4
  93. package/docs/bookofpowerhouse/05-SNOsandANewModelForOSSandPublicGoods.md +23 -30
  94. package/docs/bookofpowerhouse/06-SNOsInActionAndPlatformEconomies.md +0 -7
  95. package/docusaurus.config.ts +64 -66
  96. package/package.json +1 -1
  97. package/scripts/generate-combined-cli-docs.ts +43 -13
  98. package/sidebars.ts +1 -0
  99. package/src/components/HomepageFeatures/index.tsx +171 -78
  100. package/src/components/HomepageFeatures/styles.module.css +1 -2
  101. package/src/css/custom.css +89 -89
  102. package/src/pages/_archive-homepage.tsx +17 -16
  103. package/src/theme/DocCardList/index.tsx +9 -8
  104. package/static.json +6 -6
@@ -1,3 +1,3 @@
1
1
  {
2
2
  "svg.preview.background": "transparent"
3
- }
3
+ }
package/CHANGELOG.md CHANGED
@@ -1,3 +1,388 @@
1
+ ## 4.1.0-dev.51 (2025-09-11)
2
+
3
+ ### 🚀 Features
4
+
5
+ - **reactor-api:** generate sdk ([ec107015c](https://github.com/powerhouse-inc/powerhouse/commit/ec107015c))
6
+ - **reactor-api:** initial gql codegen ([3db9e9778](https://github.com/powerhouse-inc/powerhouse/commit/3db9e9778))
7
+ - **monorepo:** make format consistent across ignores ([98469560f](https://github.com/powerhouse-inc/powerhouse/commit/98469560f))
8
+ - **monorepo:** use consistent separate type imports ([6fd4ac0f4](https://github.com/powerhouse-inc/powerhouse/commit/6fd4ac0f4))
9
+ - **monorepo:** use consistent formatting ([d2a1182c5](https://github.com/powerhouse-inc/powerhouse/commit/d2a1182c5))
10
+
11
+ ### 🩹 Fixes
12
+
13
+ - linting fixes ([27fe7d397](https://github.com/powerhouse-inc/powerhouse/commit/27fe7d397))
14
+ - annoyingly, you have to add ignores to the root eslint ([bb6d993bd](https://github.com/powerhouse-inc/powerhouse/commit/bb6d993bd))
15
+ - **docs:** improve document hooks documentation ([d05fcb835](https://github.com/powerhouse-inc/powerhouse/commit/d05fcb835))
16
+
17
+ ### ❤️ Thank You
18
+
19
+ - Benjamin Jordan (@thegoldenmule)
20
+ - Callme-T
21
+ - ryanwolhuter @ryanwolhuter
22
+
23
+ ## 4.1.0-dev.50 (2025-09-09)
24
+
25
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
26
+
27
+ ## 4.1.0-dev.49 (2025-09-09)
28
+
29
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
30
+
31
+ ## 4.1.0-dev.48 (2025-09-09)
32
+
33
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
34
+
35
+ ## 4.1.0-dev.47 (2025-09-06)
36
+
37
+ ### 🩹 Fixes
38
+
39
+ - **docs:** added zip redundancy to release notes ([3acfe1027](https://github.com/powerhouse-inc/powerhouse/commit/3acfe1027))
40
+
41
+ ### ❤️ Thank You
42
+
43
+ - Callme-T
44
+
45
+ ## 4.1.0-dev.46 (2025-09-05)
46
+
47
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
48
+
49
+ ## 5.0.0-staging.3 (2025-09-08)
50
+
51
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
52
+
53
+ ## 5.0.0-staging.2 (2025-09-05)
54
+
55
+ ### 🩹 Fixes
56
+
57
+ - **docs:** added zip redundancy to release notes ([3acfe1027](https://github.com/powerhouse-inc/powerhouse/commit/3acfe1027))
58
+
59
+ ### ❤️ Thank You
60
+
61
+ - Callme-T
62
+
63
+ ## 5.0.0-staging.1 (2025-09-04)
64
+
65
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
66
+
67
+ ## 4.1.0-dev.44 (2025-09-04)
68
+
69
+ ### 🚀 Features
70
+
71
+ - **switchboard:** updated readme ([9659cf035](https://github.com/powerhouse-inc/powerhouse/commit/9659cf035))
72
+
73
+ ### ❤️ Thank You
74
+
75
+ - Frank
76
+
77
+ ## 4.1.0-dev.43 (2025-09-02)
78
+
79
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
80
+
81
+ ## 4.1.0-dev.42 (2025-09-02)
82
+
83
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
84
+
85
+ ## 4.1.0-dev.41 (2025-09-02)
86
+
87
+ ### 🩹 Fixes
88
+
89
+ - **document-drive:** install openssl ([89f21529e](https://github.com/powerhouse-inc/powerhouse/commit/89f21529e))
90
+ - **document-drive:** prisma build ([7884368a2](https://github.com/powerhouse-inc/powerhouse/commit/7884368a2))
91
+ - **switchboard, connect:** fetch proper tag ([79a0bc967](https://github.com/powerhouse-inc/powerhouse/commit/79a0bc967))
92
+
93
+ ### ❤️ Thank You
94
+
95
+ - Frank
96
+
97
+ ## 4.1.0-dev.40 (2025-09-02)
98
+
99
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
100
+
101
+ ## 4.1.0-dev.39 (2025-09-02)
102
+
103
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
104
+
105
+ ## 4.1.0-dev.38 (2025-08-30)
106
+
107
+ ### 🚀 Features
108
+
109
+ - gql-gen spec ([5bf2c7226](https://github.com/powerhouse-inc/powerhouse/commit/5bf2c7226))
110
+ - **reactor:** we have a reactor facade ([7a61e68ab](https://github.com/powerhouse-inc/powerhouse/commit/7a61e68ab))
111
+ - **reactor:** impstubbing out initial interface and types ([b74b194f9](https://github.com/powerhouse-inc/powerhouse/commit/b74b194f9))
112
+
113
+ ### ❤️ Thank You
114
+
115
+ - Benjamin Jordan (@thegoldenmule)
116
+
117
+ ## 4.1.0-dev.37 (2025-08-29)
118
+
119
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
120
+
121
+ ## 4.1.0-dev.36 (2025-08-28)
122
+
123
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
124
+
125
+ ## 4.1.0-dev.35 (2025-08-27)
126
+
127
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
128
+
129
+ ## 4.1.0-dev.34 (2025-08-26)
130
+
131
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
132
+
133
+ ## 4.1.0-dev.33 (2025-08-21)
134
+
135
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
136
+
137
+ ## 4.1.0-dev.32 (2025-08-21)
138
+
139
+ ### 🩹 Fixes
140
+
141
+ - **ph-cli:** resolve local document model loading in switchboard and vetra ([262f13035](https://github.com/powerhouse-inc/powerhouse/commit/262f13035))
142
+
143
+ ### ❤️ Thank You
144
+
145
+ - Guillermo Puente @gpuente
146
+
147
+ ## 4.1.0-dev.31 (2025-08-20)
148
+
149
+ ### 🚀 Features
150
+
151
+ - added interactive mode to vetra command ([#1775](https://github.com/powerhouse-inc/powerhouse/pull/1775))
152
+
153
+ ### ❤️ Thank You
154
+
155
+ - Guillermo Puente Sandoval @gpuente
156
+
157
+ ## 4.1.0-dev.30 (2025-08-20)
158
+
159
+ ### 🩹 Fixes
160
+
161
+ - add additional tags ([4f0cf8658](https://github.com/powerhouse-inc/powerhouse/commit/4f0cf8658))
162
+
163
+ ### ❤️ Thank You
164
+
165
+ - Frank
166
+
167
+ ## 4.1.0-dev.29 (2025-08-20)
168
+
169
+ ### 🩹 Fixes
170
+
171
+ - fetch tags :-) ([df0b7beba](https://github.com/powerhouse-inc/powerhouse/commit/df0b7beba))
172
+
173
+ ### ❤️ Thank You
174
+
175
+ - Frank
176
+
177
+ ## 4.1.0-dev.28 (2025-08-20)
178
+
179
+ ### 🩹 Fixes
180
+
181
+ - removed metadata extraction from commit ([637960021](https://github.com/powerhouse-inc/powerhouse/commit/637960021))
182
+
183
+ ### ❤️ Thank You
184
+
185
+ - Frank
186
+
187
+ ## 4.1.0-dev.27 (2025-08-20)
188
+
189
+ ### 🩹 Fixes
190
+
191
+ - extract metadata tags and labels for docker ([bb9c81ce7](https://github.com/powerhouse-inc/powerhouse/commit/bb9c81ce7))
192
+ - use github tag properly ([95ccff4b8](https://github.com/powerhouse-inc/powerhouse/commit/95ccff4b8))
193
+ - proper tag for docker images ([e73e10617](https://github.com/powerhouse-inc/powerhouse/commit/e73e10617))
194
+ - use patname secret instead of github token ([db9dfd5cd](https://github.com/powerhouse-inc/powerhouse/commit/db9dfd5cd))
195
+
196
+ ### ❤️ Thank You
197
+
198
+ - Frank
199
+
200
+ ## 4.1.0-dev.26 (2025-08-20)
201
+
202
+ ### 🩹 Fixes
203
+
204
+ - docker deploy alternative approach ([2a5522cdc](https://github.com/powerhouse-inc/powerhouse/commit/2a5522cdc))
205
+
206
+ ### ❤️ Thank You
207
+
208
+ - Frank
209
+
210
+ ## 4.1.0-dev.25 (2025-08-20)
211
+
212
+ ### 🩹 Fixes
213
+
214
+ - docker deploy ([b057a7cce](https://github.com/powerhouse-inc/powerhouse/commit/b057a7cce))
215
+
216
+ ### ❤️ Thank You
217
+
218
+ - Frank
219
+
220
+ ## 4.1.0-dev.24 (2025-08-20)
221
+
222
+ ### 🚀 Features
223
+
224
+ - **codegen:** add drive explorer template ([9c27219dc](https://github.com/powerhouse-inc/powerhouse/commit/9c27219dc))
225
+ - **connect,reactor-browser:** remove more old electron garbage ([5cd255568](https://github.com/powerhouse-inc/powerhouse/commit/5cd255568))
226
+ - **connect:** remove broken electron code ([3f28d6a46](https://github.com/powerhouse-inc/powerhouse/commit/3f28d6a46))
227
+ - **reactor-browser,connect,vetra:** move state hooks into reactor browser and eliminate redundant and dead code ([30fa16f1f](https://github.com/powerhouse-inc/powerhouse/commit/30fa16f1f))
228
+ - **connect,state,renown:** add state hook for renown ([5beb1252b](https://github.com/powerhouse-inc/powerhouse/commit/5beb1252b))
229
+ - **connect:** remove unused dep ([ef492bc7a](https://github.com/powerhouse-inc/powerhouse/commit/ef492bc7a))
230
+ - **connect,state,reactor-browser:** eliminate jotai ([53b1ab759](https://github.com/powerhouse-inc/powerhouse/commit/53b1ab759))
231
+ - **state:** rename to vetra packages ([c415b7dc2](https://github.com/powerhouse-inc/powerhouse/commit/c415b7dc2))
232
+ - **state:** use ph packages atoms ([6421fbeea](https://github.com/powerhouse-inc/powerhouse/commit/6421fbeea))
233
+
234
+ ### 🩹 Fixes
235
+
236
+ - today claude taught me I could mock a package to fix circular references ([dcb83174c](https://github.com/powerhouse-inc/powerhouse/commit/dcb83174c))
237
+ - **monorepo:** numerous build issues ([04349dd25](https://github.com/powerhouse-inc/powerhouse/commit/04349dd25))
238
+
239
+ ### ❤️ Thank You
240
+
241
+ - Benjamin Jordan (@thegoldenmule)
242
+ - ryanwolhuter @ryanwolhuter
243
+
244
+ ## 4.1.0-dev.23 (2025-08-19)
245
+
246
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
247
+
248
+ ## 4.1.0-dev.22 (2025-08-15)
249
+
250
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
251
+
252
+ ## 4.1.0-dev.21 (2025-08-15)
253
+
254
+ ### 🚀 Features
255
+
256
+ - **vetra:** update manifest when new module is added ([#1766](https://github.com/powerhouse-inc/powerhouse/pull/1766))
257
+ - **academy:** hooks documentation ([a517eadce](https://github.com/powerhouse-inc/powerhouse/commit/a517eadce))
258
+
259
+ ### 🩹 Fixes
260
+
261
+ - **academy:** subgraphs documentation update ([4f3a024ab](https://github.com/powerhouse-inc/powerhouse/commit/4f3a024ab))
262
+ - fixed debug launch configuration now that source maps are in the proper locations ([c75d793ed](https://github.com/powerhouse-inc/powerhouse/commit/c75d793ed))
263
+
264
+ ### ❤️ Thank You
265
+
266
+ - Benjamin Jordan (@thegoldenmule)
267
+ - Callme-T
268
+ - Guillermo Puente Sandoval @gpuente
269
+
270
+ ## 4.1.0-dev.20 (2025-08-15)
271
+
272
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
273
+
274
+ ## 4.1.0-dev.19 (2025-08-14)
275
+
276
+ ### 🩹 Fixes
277
+
278
+ - **academy:** subgraph example ([ae3e24458](https://github.com/powerhouse-inc/powerhouse/commit/ae3e24458))
279
+
280
+ ### ❤️ Thank You
281
+
282
+ - Frank
283
+
284
+ ## 4.1.0-dev.18 (2025-08-14)
285
+
286
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
287
+
288
+ ## 4.1.0-dev.17 (2025-08-12)
289
+
290
+ ### 🚀 Features
291
+
292
+ - refactor vetra command and remove vetra deps in connect and reactor ([#1753](https://github.com/powerhouse-inc/powerhouse/pull/1753))
293
+
294
+ ### ❤️ Thank You
295
+
296
+ - Guillermo Puente Sandoval @gpuente
297
+
298
+ ## 4.1.0-dev.16 (2025-08-12)
299
+
300
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
301
+
302
+ ## 4.1.0-dev.15 (2025-08-12)
303
+
304
+ ### 🚀 Features
305
+
306
+ - **reactor-mcp,reactor-api,reactor-local,switchboard,ph-cli:** run mcp on express app ([d51fa590e](https://github.com/powerhouse-inc/powerhouse/commit/d51fa590e))
307
+
308
+ ### ❤️ Thank You
309
+
310
+ - acaldas @acaldas
311
+
312
+ ## 4.1.0-dev.14 (2025-08-11)
313
+
314
+ ### 🚀 Features
315
+
316
+ - update document engineering dep ([54dcee90d](https://github.com/powerhouse-inc/powerhouse/commit/54dcee90d))
317
+
318
+ ### ❤️ Thank You
319
+
320
+ - acaldas @acaldas
321
+
322
+ ## 4.1.0-dev.13 (2025-08-09)
323
+
324
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
325
+
326
+ ## 4.1.0-dev.12 (2025-08-08)
327
+
328
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
329
+
330
+ ## 4.1.0-dev.11 (2025-08-07)
331
+
332
+ ### 🚀 Features
333
+
334
+ - **switchboard,reactor-local,reactor-api:** moved vite loader to reactor-api package ([c84f0a2a3](https://github.com/powerhouse-inc/powerhouse/commit/c84f0a2a3))
335
+ - vetra package documents and app integration ([0e4053302](https://github.com/powerhouse-inc/powerhouse/commit/0e4053302))
336
+ - **vetra:** added vetra drive editor ([4ebafd143](https://github.com/powerhouse-inc/powerhouse/commit/4ebafd143))
337
+ - **ph-cli:** added verbose option to vetra command ([7310ec06c](https://github.com/powerhouse-inc/powerhouse/commit/7310ec06c))
338
+ - integrate package documents into reactor system ([939fe8e80](https://github.com/powerhouse-inc/powerhouse/commit/939fe8e80))
339
+ - **connect:** integrate Vetra package documents and editors ([2ecb9bd15](https://github.com/powerhouse-inc/powerhouse/commit/2ecb9bd15))
340
+
341
+ ### ❤️ Thank You
342
+
343
+ - acaldas @acaldas
344
+ - Guillermo Puente @gpuente
345
+ - Guillermo Puente Sandoval @gpuente
346
+
347
+ ## 4.1.0-dev.10 (2025-08-07)
348
+
349
+ ### 🚀 Features
350
+
351
+ - **builder-tools,codegen,design-system,reactor-api:** updated document-engineering version ([e74068b43](https://github.com/powerhouse-inc/powerhouse/commit/e74068b43))
352
+
353
+ ### ❤️ Thank You
354
+
355
+ - acaldas @acaldas
356
+
357
+ ## 4.1.0-dev.9 (2025-08-07)
358
+
359
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
360
+
361
+ ## 4.1.0-dev.8 (2025-08-06)
362
+
363
+ ### 🚀 Features
364
+
365
+ - **switchboard,config,reactor-api:** handle auth in reactor-api ([f33c921ee](https://github.com/powerhouse-inc/powerhouse/commit/f33c921ee))
366
+
367
+ ### ❤️ Thank You
368
+
369
+ - acaldas @acaldas
370
+
371
+ ## 4.1.0-dev.7 (2025-08-06)
372
+
373
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
374
+
375
+ ## 4.1.0-dev.6 (2025-08-06)
376
+
377
+ ### 🚀 Features
378
+
379
+ - **reactor-mcp:** load local document models and reload when they change ([0408a017c](https://github.com/powerhouse-inc/powerhouse/commit/0408a017c))
380
+ - **reactor-local,reactor-api,document-drive:** reload local document models when they change ([5d9af3951](https://github.com/powerhouse-inc/powerhouse/commit/5d9af3951))
381
+
382
+ ### ❤️ Thank You
383
+
384
+ - acaldas @acaldas
385
+
1
386
  ## 4.1.0-dev.5 (2025-08-05)
2
387
 
3
388
  This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
@@ -782,4 +1167,4 @@ This was a version bump only for @powerhousedao/academy to align it with other p
782
1167
 
783
1168
  ### ❤️ Thank You
784
1169
 
785
- - Frank
1170
+ - Frank
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Website
2
2
 
3
3
  This documentation website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
4
- To contribute to the documentation please work on a feature branch in case of big refactors, and build & serve before pushing to the development branch.
5
- Pushing from the dev branch to the main branch will trigger an auto deployment in Heroku for the staging deployment.
4
+ To contribute to the documentation please work on a feature branch in case of big refactors, and build & serve before pushing to the development branch.
5
+ Pushing from the dev branch to the main branch will trigger an auto deployment in Heroku for the staging deployment.
6
6
 
7
7
  ### Installation
8
8
 
@@ -16,7 +16,7 @@ $ npm install
16
16
  $ npm run dev
17
17
  ```
18
18
 
19
- This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. The server will break upon broken links or big navigation/relinking.
19
+ This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. The server will break upon broken links or big navigation/relinking.
20
20
 
21
21
  ### Build
22
22
 
package/babel.config.js CHANGED
@@ -1,3 +1,3 @@
1
1
  module.exports = {
2
- presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
2
+ presets: [require.resolve("@docusaurus/core/lib/babel/preset")],
3
3
  };
@@ -3,7 +3,7 @@ title: Beyond Communication - A Blueprint for Development
3
3
  description: GraphQL Schema’s as a common language for software design
4
4
  slug: Graphql-schema-as-a-common-language
5
5
  authors:
6
- - name: Call me T.
6
+ - name: Call me T.
7
7
  title: Product Manager at Powerhouse
8
8
  image_url: https://avatars.githubusercontent.com/u/148560082?v=4
9
9
  socials:
@@ -12,6 +12,7 @@ tags: [Design thinking, Tooling, Product, GraphQL, Schema's]
12
12
  image: https://i.imgur.com/mErPwqL.png
13
13
  hide_table_of_contents: false
14
14
  ---
15
+
15
16
  GraphQL Schema’s as a common language for software design, bridging the gaps between all stakeholders with the help of a single source of truth document model.
16
17
 
17
18
  <!-- truncate -->
@@ -26,7 +27,7 @@ GraphQL Schema’s as a common language for software design, bridging the gaps b
26
27
 
27
28
  #### For non-technical contributors, schemas offer a clear, readable map of how data flows through a system. Business analysts, product managers, and designers can quickly grasp the relationships between data types and operations without needing to dive into code. “**For developers, schemas serve as a contract, reducing ambiguity during implementation**”. Queries and mutations clearly define how data can be fetched or modified, leaving little room for misinterpretation.
28
29
 
29
- ####
30
+ ####
30
31
 
31
32
  #### By bringing clarity to these conversations, GraphQL fosters collaboration within cross-functional teams and accelerates onboarding for new contributors.
32
33
 
@@ -34,12 +35,12 @@ GraphQL Schema’s as a common language for software design, bridging the gaps b
34
35
 
35
36
  The utility of GraphQL schemas extends far beyond communication. They act as a blueprint that shapes every phase of the development lifecycle:
36
37
 
37
- * **Planning and Design**:
38
- * During the design phase, schemas enable teams to validate assumptions early. Data requirements and workflows can be reviewed collaboratively, ensuring alignment before development begins.
39
- * **Implementation**:
40
- * Developers use schemas as a definitive source of truth, minimizing the need for rework caused by unclear specifications.
41
- * **Testing and Maintenance**:
42
- * When the schema evolves, it highlights changes or inconsistencies, making it easier to adapt systems without breaking existing functionality.
38
+ - **Planning and Design**:
39
+ - During the design phase, schemas enable teams to validate assumptions early. Data requirements and workflows can be reviewed collaboratively, ensuring alignment before development begins.
40
+ - **Implementation**:
41
+ - Developers use schemas as a definitive source of truth, minimizing the need for rework caused by unclear specifications.
42
+ - **Testing and Maintenance**:
43
+ - When the schema evolves, it highlights changes or inconsistencies, making it easier to adapt systems without breaking existing functionality.
43
44
 
44
45
  The result is a smoother development process, where every stakeholder operates with a shared understanding of the system’s architecture.
45
46
 
@@ -49,9 +50,9 @@ GraphQL's design pairs naturally with the Command Query Responsibility Segregati
49
50
 
50
51
  In a CQRS-driven architecture:
51
52
 
52
- * **Queries** retrieve data efficiently.
53
- * **Mutations** handle data modifications.
54
- * **Subscriptions** enable real-time updates.
53
+ - **Queries** retrieve data efficiently.
54
+ - **Mutations** handle data modifications.
55
+ - **Subscriptions** enable real-time updates.
55
56
 
56
57
  GraphQL’s separation of these operations ensures clarity and scalability, especially in distributed systems. Developers can optimize read and write models independently, leading to improved performance and maintainability. This structured approach also simplifies troubleshooting and ensures a smoother evolution of complex systems.
57
58
 
@@ -59,12 +60,12 @@ GraphQL’s separation of these operations ensures clarity and scalability, espe
59
60
 
60
61
  GraphQL’s strong typing makes it a natural ally for TypeScript, a language known for its type safety and developer-friendly features. Together, they form a powerful combination that enhances developer experience and system reliability.
61
62
 
62
- * **Type Safety Across the Stack**:
63
- * Developers can auto-generate TypeScript types from GraphQL schemas, ensuring consistency between client and server. This reduces boilerplate code and eliminates many common runtime errors.
64
- * **Improved Developer Productivity**:
65
- * With type safety built into both the API and the client code, developers can catch potential issues during development, saving time and reducing bugs.
66
- * **Seamless Front-End Integrations**:
67
- * For front-end teams, GraphQL and TypeScript streamline the process of building data-driven applications, ensuring that APIs and components stay in sync.
63
+ - **Type Safety Across the Stack**:
64
+ - Developers can auto-generate TypeScript types from GraphQL schemas, ensuring consistency between client and server. This reduces boilerplate code and eliminates many common runtime errors.
65
+ - **Improved Developer Productivity**:
66
+ - With type safety built into both the API and the client code, developers can catch potential issues during development, saving time and reducing bugs.
67
+ - **Seamless Front-End Integrations**:
68
+ - For front-end teams, GraphQL and TypeScript streamline the process of building data-driven applications, ensuring that APIs and components stay in sync.
68
69
 
69
70
  This synergy results in cleaner, more reliable code and a significantly improved development experience.
70
71
 
@@ -72,12 +73,12 @@ This synergy results in cleaner, more reliable code and a significantly improved
72
73
 
73
74
  Beyond fostering better communication and aligning stakeholders, GraphQL drives efficiency in several key ways:
74
75
 
75
- * **Streamlined API Development**:
76
- * With its declarative queries, GraphQL eliminates over-fetching and under-fetching of data, allowing front-end teams to request only what they need.
77
- * **Empowered Non-Technical Contributors**:
78
- * The interactive nature of GraphQL schemas makes them accessible to non-technical stakeholders, enabling them to explore APIs independently and contribute more effectively to design discussions. The ‘lingua franca’ characteristic now truly starts to live up to its promises as designer or business analysts now can interact with the base schema and steer and discuss potential solutions together with the development team.
79
- * **Real-Time Introspection**:
80
- * Tools like GraphQL Playground allow teams to inspect and test APIs dynamically, making development and debugging faster and more collaborative.
76
+ - **Streamlined API Development**:
77
+ - With its declarative queries, GraphQL eliminates over-fetching and under-fetching of data, allowing front-end teams to request only what they need.
78
+ - **Empowered Non-Technical Contributors**:
79
+ - The interactive nature of GraphQL schemas makes them accessible to non-technical stakeholders, enabling them to explore APIs independently and contribute more effectively to design discussions. The ‘lingua franca’ characteristic now truly starts to live up to its promises as designer or business analysts now can interact with the base schema and steer and discuss potential solutions together with the development team.
80
+ - **Real-Time Introspection**:
81
+ - Tools like GraphQL Playground allow teams to inspect and test APIs dynamically, making development and debugging faster and more collaborative.
81
82
 
82
83
  These features combine to create a more agile, responsive development environment, where teams can adapt quickly to changing requirements.
83
84
 
@@ -85,4 +86,4 @@ These features combine to create a more agile, responsive development environmen
85
86
 
86
87
  The success of any software project hinges on clear communication and shared understanding. GraphQL schemas provide the common language that teams need to align around a unified vision. From clarifying data relationships to supporting scalable architectures, GraphQL empowers organizations to overcome the "lost in translation" problem and focus on what truly matters: building great products.
87
88
 
88
- For teams seeking to improve collaboration, efficiency, and scalability, GraphQL is more than a tool—it’s a framework for shared success,
89
+ For teams seeking to improve collaboration, efficiency, and scalability, GraphQL is more than a tool—it’s a framework for shared success,
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  title: The Challenge of Change
3
- description: Rapid Application Development with document models.
3
+ description: Rapid Application Development with document models.
4
4
  slug: Rapid-Application-Development-with-document-models.
5
5
  authors:
6
- - name: Call me T.
6
+ - name: Call me T.
7
7
  title: Product Manager at Powerhouse
8
8
  image_url: https://avatars.githubusercontent.com/u/148560082?v=4
9
9
  socials:
@@ -12,6 +12,7 @@ tags: [Dao, Tooling]
12
12
  image: https://i.imgur.com/mErPwqL.png
13
13
  hide_table_of_contents: false
14
14
  ---
15
+
15
16
  ### **The Challenge of Change**
16
17
 
17
18
  The pace of innovation is relentless. Organizations today find themselves in a race to adapt to new technologies, shifting consumer demands, and evolving or opaque regulations. Yet, the traditional methods of building and maintaining software systems often lag behind the speed of change, creating bottlenecks that stifle growth and innovation.
@@ -20,10 +21,10 @@ The pace of innovation often outstrips an organization’s ability to adapt, kee
20
21
 
21
22
  <!-- truncate -->
22
23
 
23
- Across many industries, this comes down to a familiar struggle of common trade-offs in product and solution development.
24
+ Across many industries, this comes down to a familiar struggle of common trade-offs in product and solution development.
24
25
 
25
26
  **\- Speed vs. Accuracy:** The balance between haste or precision
26
- **\- Customizability vs. Scalability:** Meeting specific needs or relentless standardisation
27
+ **\- Customizability vs. Scalability:** Meeting specific needs or relentless standardisation
27
28
 
28
29
  As businesses push to innovate, they face a crucial question: how can they accelerate development without sacrificing quality or flexibility?
29
30
 
@@ -37,19 +38,18 @@ The answer lies in embracing methodologies that prioritize agility and adaptabil
37
38
 
38
39
  Key benefits of RAD include:
39
40
 
40
- * **Rapid Prototyping**: Organizations can quickly test ideas without committing to large-scale development, allowing for faster feedback and iteration.
41
- * **Iterative Development**: Instead of delivering a finished product all at once, RAD emphasizes incremental improvements, reducing the risk of misaligned expectations.
42
- * **Adaptability to Change**: By designing with flexibility in mind, RAD allows organizations to pivot and respond to new demands or challenges with ease.
43
-
44
- These principles have been widely embraced in industries ranging from DAO’s, incubators, tech startups to multinational corporations (in the case of the latter often with the help of a high ticket consultant). Other methodologies from adjacent domains of RAD, that you might be more familiar with include:
41
+ - **Rapid Prototyping**: Organizations can quickly test ideas without committing to large-scale development, allowing for faster feedback and iteration.
42
+ - **Iterative Development**: Instead of delivering a finished product all at once, RAD emphasizes incremental improvements, reducing the risk of misaligned expectations.
43
+ - **Adaptability to Change**: By designing with flexibility in mind, RAD allows organizations to pivot and respond to new demands or challenges with ease.
45
44
 
46
- * **Lean Start-up Methodology**: Focussing on finding product market fit early with a minimum viable product through a build, measure, learn cycle.
47
- * **Pre-totyping:** A method by Google's first engineering director focused on validating that you are building the ‘right it’ before you ‘build it’ right with the help of smoke tests or mock-ups.
48
- * **Design-thinking:** Where designers & developers go through non-linear, iterative processes of discovery, definition, development & delivery of their ideas with the help of prototyping together with end-users.
45
+ These principles have been widely embraced in industries ranging from DAO’s, incubators, tech startups to multinational corporations (in the case of the latter often with the help of a high ticket consultant). Other methodologies from adjacent domains of RAD, that you might be more familiar with include:
49
46
 
47
+ - **Lean Start-up Methodology**: Focussing on finding product market fit early with a minimum viable product through a build, measure, learn cycle.
48
+ - **Pre-totyping:** A method by Google's first engineering director focused on validating that you are building the ‘right it’ before you ‘build it’ right with the help of smoke tests or mock-ups.
49
+ - **Design-thinking:** Where designers & developers go through non-linear, iterative processes of discovery, definition, development & delivery of their ideas with the help of prototyping together with end-users.
50
50
 
51
51
  ![Iteration](./images/Iteration.png)
52
- *Figure 1: Notice how Design thinking, Lean Startup Methodology and Rapid Application Development all rely on tooling that put rapid iteration at the center of the methodology? It remains crucial to select the right tool with the correct prototype fidelity at any of the stages these methodologies prescribe*
52
+ _Figure 1: Notice how Design thinking, Lean Startup Methodology and Rapid Application Development all rely on tooling that put rapid iteration at the center of the methodology? It remains crucial to select the right tool with the correct prototype fidelity at any of the stages these methodologies prescribe_
53
53
 
54
54
  ---
55
55
 
@@ -57,9 +57,9 @@ These principles have been widely embraced in industries ranging from DAO’s, i
57
57
 
58
58
  Despite their success in simpler times, traditional development methodologies are currently often falling short in today’s dynamic environments.
59
59
 
60
- * **Long Lead Times**: Developing complex systems from scratch can take months or even years, by which time business requirements may have shifted.
61
- * **Limited Customization**: Off-the-shelf solutions may be fast to deploy but rarely align perfectly with an organization’s unique workflows.
62
- * **High Costs of Change**: Adjusting systems mid-development often incurs significant costs and delays, making organizations hesitant to pivot.
60
+ - **Long Lead Times**: Developing complex systems from scratch can take months or even years, by which time business requirements may have shifted.
61
+ - **Limited Customization**: Off-the-shelf solutions may be fast to deploy but rarely align perfectly with an organization’s unique workflows.
62
+ - **High Costs of Change**: Adjusting systems mid-development often incurs significant costs and delays, making organizations hesitant to pivot.
63
63
 
64
64
  To overcome these challenges, businesses need a new approach—one that combines speed, flexibility, and precision.
65
65
 
@@ -71,16 +71,16 @@ Powerhouse is proposing a framework built to address these very challenges, offe
71
71
 
72
72
  At the core of Powerhouse’s approach is its **document model-driven architecture**, a GraphQL schema based foundation that reimagines how data, workflows, and processes are structured. This architecture enables organizations to:
73
73
 
74
- * **Capture Data Effectively**: Modular document models allow organizations to define and adapt workflows with higher accuracy.
75
- * **Automate Workflows**: With tools to streamline even the most complex processes, so organizations can focus on innovation instead of repetitive tasks.
76
- * **Iterate and Evolve Rapidly**: Modular, reusable components reduce development times, enabling organizations to adapt to their most pressing challenges and changes.
74
+ - **Capture Data Effectively**: Modular document models allow organizations to define and adapt workflows with higher accuracy.
75
+ - **Automate Workflows**: With tools to streamline even the most complex processes, so organizations can focus on innovation instead of repetitive tasks.
76
+ - **Iterate and Evolve Rapidly**: Modular, reusable components reduce development times, enabling organizations to adapt to their most pressing challenges and changes.
77
77
 
78
78
  ---
79
79
 
80
80
  ### **From a front-end developers perspective**
81
81
 
82
- >“The coolest part is being able to plug into any document model and start building UI components for it without the hassle of managing a 'backend' or 'state management' for the components. All front-end devs use and love redux, the event driven architecture these document models are using. But the fact that as a front end dev, you don't have to set up any of it, and can just plug into the underlying framework saves time. It allows me to focus on my actual tasks \- building awesome UI components and experiences. I could start thinking of the same document model but with a 1000 different UI’s depending on the user's specific needs and preferences. Like swapping skins in my favorite video game”
82
+ > “The coolest part is being able to plug into any document model and start building UI components for it without the hassle of managing a 'backend' or 'state management' for the components. All front-end devs use and love redux, the event driven architecture these document models are using. But the fact that as a front end dev, you don't have to set up any of it, and can just plug into the underlying framework saves time. It allows me to focus on my actual tasks \- building awesome UI components and experiences. I could start thinking of the same document model but with a 1000 different UI’s depending on the user's specific needs and preferences. Like swapping skins in my favorite video game”
83
83
 
84
- The rapid application development process we’re setting up, allows us to move quicker from initial problem definition to potential prototype opens up time for designers and developers to actually test and iterate on their imagined solution.
84
+ The rapid application development process we’re setting up, allows us to move quicker from initial problem definition to potential prototype opens up time for designers and developers to actually test and iterate on their imagined solution.
85
85
 
86
86
  By prioritizing rapid, iterative development, Powerhouse aims to empower organizations to innovate faster, adapt more seamlessly, and achieve sustainable growth in even the most challenging environments.