@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

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 (386) hide show
  1. package/README.md +1 -14
  2. package/bin/detect-agents.js +1 -1
  3. package/bin/morph-spec.js +403 -40
  4. package/bin/validate.js +5 -5
  5. package/docs/getting-started.md +0 -5
  6. package/docs/next-generation/AGENTS.md +521 -0
  7. package/docs/next-generation/ANALYSIS.md +555 -0
  8. package/docs/next-generation/ARCHITECTURE.md +436 -0
  9. package/docs/next-generation/CONTEXT-OPTIMIZATION.md +267 -0
  10. package/docs/next-generation/EXECUTION-FLOW.md +274 -0
  11. package/docs/next-generation/FEATURES.md +688 -0
  12. package/docs/next-generation/META-PROMPTS.md +235 -0
  13. package/docs/next-generation/MIGRATION-GUIDE.md +253 -0
  14. package/docs/next-generation/README.md +231 -0
  15. package/docs/next-generation/ROADMAP.md +801 -0
  16. package/docs/next-generation/THREAD-MANAGEMENT.md +240 -0
  17. package/docs/validation-checklist.md +0 -1
  18. package/package.json +5 -5
  19. package/src/commands/agents/agents-fuse.js +96 -0
  20. package/src/commands/agents/index.js +4 -0
  21. package/src/commands/agents/micro-agent.js +112 -0
  22. package/src/commands/{spawn-team.js → agents/spawn-team.js} +237 -172
  23. package/src/commands/agents/squad-template.js +146 -0
  24. package/src/commands/analytics/analytics.js +176 -0
  25. package/src/commands/context/context-prime.js +63 -0
  26. package/src/commands/context/core-four.js +54 -0
  27. package/src/commands/{create-story.js → feature/create-story.js} +357 -354
  28. package/src/commands/feature/index.js +6 -0
  29. package/src/commands/{shard-spec.js → feature/shard-spec.js} +2 -2
  30. package/src/commands/{sprint-status.js → feature/sprint-status.js} +1 -1
  31. package/src/commands/{generate-context.js → generation/generate-context.js} +40 -40
  32. package/src/commands/{generate.js → generation/generate.js} +4 -4
  33. package/src/commands/generation/index.js +5 -0
  34. package/src/commands/index.js +16 -0
  35. package/src/commands/{capture-pattern.js → learning/capture-pattern.js} +121 -121
  36. package/src/commands/learning/index.js +5 -0
  37. package/src/commands/mcp/mcp.js +102 -0
  38. package/src/commands/{detect-agents.js → project/detect-agents.js} +178 -178
  39. package/src/commands/project/detect-workflow.js +174 -0
  40. package/src/commands/{detect.js → project/detect.js} +104 -104
  41. package/src/commands/{doctor.js → project/doctor.js} +221 -4
  42. package/src/commands/project/index.js +10 -0
  43. package/src/commands/{init.js → project/init.js} +305 -295
  44. package/src/commands/{sync.js → project/sync.js} +167 -167
  45. package/src/commands/{update.js → project/update.js} +240 -240
  46. package/src/commands/{advance-phase.js → state/advance-phase.js} +101 -25
  47. package/src/commands/{approve.js → state/approve.js} +221 -221
  48. package/src/commands/state/index.js +8 -0
  49. package/src/commands/{rollback-phase.js → state/rollback-phase.js} +185 -185
  50. package/src/commands/{state.js → state/state.js} +334 -334
  51. package/src/commands/{validate-phase.js → state/validate-phase.js} +221 -221
  52. package/src/commands/tasks/index.js +4 -0
  53. package/src/commands/{task.js → tasks/task.js} +78 -78
  54. package/src/commands/templates/index.js +8 -0
  55. package/src/commands/templates/template-customize.js +101 -0
  56. package/src/commands/templates/template-list.js +128 -0
  57. package/src/commands/templates/template-render.js +174 -0
  58. package/src/commands/templates/template-show.js +131 -0
  59. package/src/commands/templates/template-validate.js +91 -0
  60. package/src/commands/threads/thread-template.js +103 -0
  61. package/src/commands/threads/threads.js +261 -0
  62. package/src/commands/trust/trust.js +205 -0
  63. package/src/commands/utils/index.js +7 -0
  64. package/src/commands/{session-summary.js → utils/session-summary.js} +291 -291
  65. package/src/commands/{troubleshoot.js → utils/troubleshoot.js} +222 -222
  66. package/src/commands/{analyze-blazor-concurrency.js → validation/analyze-blazor-concurrency.js} +193 -193
  67. package/src/commands/validation/index.js +8 -0
  68. package/src/commands/{lint-fluent.js → validation/lint-fluent.js} +352 -352
  69. package/src/commands/{validate-blazor-state.js → validation/validate-blazor-state.js} +210 -210
  70. package/src/commands/{validate-blazor.js → validation/validate-blazor.js} +156 -156
  71. package/src/commands/{validate-css.js → validation/validate-css.js} +84 -84
  72. package/src/core/index.js +10 -0
  73. package/src/{orchestrator.js → core/orchestrator.js} +8 -8
  74. package/src/core/registry/command-registry.js +302 -0
  75. package/src/core/registry/index.js +8 -0
  76. package/src/core/registry/validator-registry.js +204 -0
  77. package/src/core/state/index.js +8 -0
  78. package/src/{lib → core/state}/phase-state-machine.js +214 -214
  79. package/src/{lib → core/state}/state-manager.js +588 -534
  80. package/src/core/templates/index.js +9 -0
  81. package/src/core/templates/template-registry.js +335 -0
  82. package/src/core/templates/template-renderer.js +477 -0
  83. package/src/core/templates/template-validator.js +296 -0
  84. package/src/core/workflows/index.js +7 -0
  85. package/src/core/workflows/workflow-detector.js +452 -0
  86. package/src/lib/agents/micro-agent-factory.js +161 -0
  87. package/src/lib/{complexity-analyzer.js → analysis/complexity-analyzer.js} +441 -441
  88. package/src/lib/analysis/index.js +7 -0
  89. package/src/lib/analytics/analytics-engine.js +345 -0
  90. package/src/lib/{checkpoint-hooks.js → checkpoints/checkpoint-hooks.js} +35 -0
  91. package/src/lib/checkpoints/index.js +7 -0
  92. package/src/lib/context/context-bundler.js +240 -0
  93. package/src/lib/context/context-optimizer.js +212 -0
  94. package/src/lib/context/context-tracker.js +273 -0
  95. package/src/lib/context/core-four-tracker.js +201 -0
  96. package/src/lib/context/mcp-optimizer.js +200 -0
  97. package/src/lib/detectors/config-detector.js +223 -223
  98. package/src/lib/detectors/conversation-analyzer.js +163 -163
  99. package/src/lib/{design-system-detector.js → detectors/design-system-detector.js} +187 -187
  100. package/src/lib/detectors/index.js +87 -84
  101. package/src/lib/detectors/standards-generator.js +275 -275
  102. package/src/lib/detectors/structure-detector.js +245 -245
  103. package/src/lib/execution/fusion-executor.js +304 -0
  104. package/src/lib/execution/parallel-executor.js +270 -0
  105. package/src/lib/{context-generator.js → generators/context-generator.js} +526 -516
  106. package/src/lib/generators/index.js +10 -0
  107. package/src/lib/{metadata-extractor.js → generators/metadata-extractor.js} +387 -380
  108. package/src/lib/{recap-generator.js → generators/recap-generator.js} +205 -205
  109. package/src/lib/hooks/hook-executor.js +169 -0
  110. package/src/lib/hooks/stop-hook-executor.js +286 -0
  111. package/src/lib/hops/hop-composer.js +221 -0
  112. package/src/lib/learning/index.js +7 -0
  113. package/src/lib/orchestration/index.js +7 -0
  114. package/src/lib/{team-orchestrator.js → orchestration/team-orchestrator.js} +323 -323
  115. package/src/lib/stacks/index.js +7 -0
  116. package/src/lib/{stack-resolver.js → stacks/stack-resolver.js} +180 -148
  117. package/src/lib/standards/index.js +7 -0
  118. package/src/lib/{standards-context-injector.js → standards/standards-context-injector.js} +298 -288
  119. package/src/lib/threads/thread-coordinator.js +238 -0
  120. package/src/lib/threads/thread-manager.js +317 -0
  121. package/src/lib/tracking/artifact-trail.js +202 -0
  122. package/src/lib/troubleshooting/index.js +8 -0
  123. package/src/lib/{troubleshoot-grep.js → troubleshooting/troubleshoot-grep.js} +204 -204
  124. package/src/lib/{troubleshoot-index.js → troubleshooting/troubleshoot-index.js} +144 -144
  125. package/src/lib/trust/trust-manager.js +269 -0
  126. package/src/lib/validators/{architecture-validator.js → architecture/architecture-validator.js} +8 -8
  127. package/src/lib/validators/architecture/index.js +7 -0
  128. package/src/lib/{blazor-concurrency-analyzer.js → validators/blazor/blazor-concurrency-analyzer.js} +277 -288
  129. package/src/lib/{blazor-state-validator.js → validators/blazor/blazor-state-validator.js} +279 -291
  130. package/src/lib/{blazor-validator.js → validators/blazor/blazor-validator.js} +369 -374
  131. package/src/lib/validators/blazor/index.js +9 -0
  132. package/src/lib/validators/{content-validator.js → content/content-validator.js} +351 -351
  133. package/src/lib/validators/content/index.js +7 -0
  134. package/src/lib/validators/{contract-compliance-validator.js → contracts/contract-compliance-validator.js} +273 -273
  135. package/src/lib/validators/contracts/index.js +7 -0
  136. package/src/lib/{css-validator.js → validators/css/css-validator.js} +352 -352
  137. package/src/lib/validators/css/index.js +7 -0
  138. package/src/lib/validators/{design-system-validator.js → design-system/design-system-validator.js} +231 -231
  139. package/src/lib/validators/design-system/index.js +7 -0
  140. package/src/lib/validators/packages/index.js +7 -0
  141. package/src/lib/validators/shared/index.js +12 -0
  142. package/src/lib/validators/shared/issue-counter.js +18 -0
  143. package/src/lib/validators/shared/result-formatter.js +124 -0
  144. package/src/lib/{spec-validator.js → validators/spec-validator.js} +258 -258
  145. package/src/lib/validators/ui/index.js +7 -0
  146. package/src/lib/{validation-runner.js → validators/validation-runner.js} +286 -284
  147. package/src/ui/wizard-questions.js +0 -2
  148. package/src/utils/color-utils.js +70 -0
  149. package/src/utils/file-copier.js +188 -189
  150. package/src/utils/process-handler.js +97 -0
  151. package/stacks/blazor-azure/.morph/config/agents.json +948 -764
  152. package/stacks/blazor-azure/.morph/hooks/{pre-commit-tests.sh → pre-commit/tests-csharp.sh} +3 -2
  153. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +41 -0
  154. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +24 -0
  155. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +23 -0
  156. package/stacks/nextjs-supabase/.morph/config/agents.json +345 -345
  157. package/stacks/nextjs-supabase/.morph/hooks/pre-commit/tests-typescript.sh +61 -0
  158. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +22 -0
  159. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +22 -0
  160. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +35 -0
  161. package/stacks/nextjs-supabase/README.md +6 -15
  162. package/CLAUDE.md +0 -648
  163. package/bin/render-template.js +0 -349
  164. package/bin/semantic-detect-agents.js +0 -247
  165. package/bin/validate-agents-skills.js +0 -257
  166. package/bin/validate-agents.js +0 -70
  167. package/bin/validate-phase.js +0 -263
  168. package/docs/examples.md +0 -328
  169. package/docs/llm-interaction-config.md +0 -735
  170. package/scripts/reorganize-skills.cjs +0 -175
  171. package/scripts/validate-agents-structure.cjs +0 -52
  172. package/scripts/validate-skills.cjs +0 -180
  173. package/src/commands/deploy.js +0 -780
  174. package/src/commands/migrate-state.js +0 -158
  175. package/src/commands/upgrade.js +0 -346
  176. package/src/lib/continuous-validator.js +0 -421
  177. package/src/lib/decision-constraint-loader.js +0 -109
  178. package/src/lib/design-system-scaffolder.js +0 -299
  179. package/src/lib/hook-executor.js +0 -257
  180. package/src/lib/mockup-generator.js +0 -366
  181. package/src/lib/ui-detector.js +0 -350
  182. package/src/llm/schema-validator.js +0 -121
  183. package/src/sanitizer/.gitkeep +0 -0
  184. package/src/scanner/.gitkeep +0 -0
  185. package/src/types/index.js +0 -477
  186. package/src/ui/.gitkeep +0 -0
  187. package/src/writer/.gitkeep +0 -0
  188. package/stacks/blazor-azure/.azure/README.md +0 -293
  189. package/stacks/blazor-azure/.azure/docs/azure-devops-setup.md +0 -454
  190. package/stacks/blazor-azure/.azure/docs/branch-strategy.md +0 -398
  191. package/stacks/blazor-azure/.azure/docs/local-development.md +0 -515
  192. package/stacks/blazor-azure/.azure/pipelines/pipeline-variables.yml +0 -34
  193. package/stacks/blazor-azure/.azure/pipelines/prod-pipeline.yml +0 -319
  194. package/stacks/blazor-azure/.azure/pipelines/staging-pipeline.yml +0 -234
  195. package/stacks/blazor-azure/.azure/pipelines/templates/build-dotnet.yml +0 -75
  196. package/stacks/blazor-azure/.azure/pipelines/templates/deploy-app-service.yml +0 -94
  197. package/stacks/blazor-azure/.azure/pipelines/templates/deploy-container-app.yml +0 -120
  198. package/stacks/blazor-azure/.azure/pipelines/templates/infra-deploy.yml +0 -90
  199. package/stacks/blazor-azure/.claude/commands/morph-apply.md +0 -221
  200. package/stacks/blazor-azure/.claude/commands/morph-archive.md +0 -79
  201. package/stacks/blazor-azure/.claude/commands/morph-deploy.md +0 -529
  202. package/stacks/blazor-azure/.claude/commands/morph-infra.md +0 -209
  203. package/stacks/blazor-azure/.claude/commands/morph-preflight.md +0 -227
  204. package/stacks/blazor-azure/.claude/commands/morph-proposal.md +0 -122
  205. package/stacks/blazor-azure/.claude/commands/morph-status.md +0 -86
  206. package/stacks/blazor-azure/.claude/commands/morph-troubleshoot.md +0 -122
  207. package/stacks/blazor-azure/.claude/settings.local.json +0 -15
  208. package/stacks/blazor-azure/.claude/skills/level-0-meta/README.md +0 -7
  209. package/stacks/blazor-azure/.claude/skills/level-0-meta/code-review.md +0 -226
  210. package/stacks/blazor-azure/.claude/skills/level-0-meta/morph-checklist.md +0 -117
  211. package/stacks/blazor-azure/.claude/skills/level-0-meta/simulation-checklist.md +0 -77
  212. package/stacks/blazor-azure/.claude/skills/level-1-workflows/README.md +0 -7
  213. package/stacks/blazor-azure/.claude/skills/level-1-workflows/morph-replicate.md +0 -213
  214. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-clarify.md +0 -131
  215. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-design.md +0 -213
  216. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-setup.md +0 -106
  217. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-tasks.md +0 -164
  218. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-uiux.md +0 -169
  219. package/stacks/blazor-azure/.claude/skills/level-2-domains/README.md +0 -14
  220. package/stacks/blazor-azure/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +0 -192
  221. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/po-pm-advisor.md +0 -197
  222. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/prompt-engineer.md +0 -189
  223. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/seo-growth-hacker.md +0 -320
  224. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/standards-architect.md +0 -156
  225. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/dotnet-senior.md +0 -287
  226. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ef-modeler.md +0 -113
  227. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/hangfire-orchestrator.md +0 -126
  228. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ms-agent-expert.md +0 -109
  229. package/stacks/blazor-azure/.claude/skills/level-2-domains/frontend/blazor-builder.md +0 -210
  230. package/stacks/blazor-azure/.claude/skills/level-2-domains/frontend/nextjs-expert.md +0 -154
  231. package/stacks/blazor-azure/.claude/skills/level-2-domains/frontend/ui-ux-designer.md +0 -191
  232. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/azure-architect.md +0 -142
  233. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/azure-deploy-specialist.md +0 -699
  234. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/bicep-architect.md +0 -126
  235. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/container-specialist.md +0 -131
  236. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/devops-engineer.md +0 -119
  237. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/asaas-financial.md +0 -130
  238. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/azure-identity.md +0 -142
  239. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/clerk-auth.md +0 -108
  240. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/resend-email.md +0 -119
  241. package/stacks/blazor-azure/.claude/skills/level-2-domains/quality/code-analyzer.md +0 -235
  242. package/stacks/blazor-azure/.claude/skills/level-2-domains/quality/testing-specialist.md +0 -126
  243. package/stacks/blazor-azure/.claude/skills/level-3-technologies/README.md +0 -7
  244. package/stacks/blazor-azure/.claude/skills/level-4-patterns/README.md +0 -7
  245. package/stacks/blazor-azure/.morph/archive/.gitkeep +0 -25
  246. package/stacks/blazor-azure/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -392
  247. package/stacks/blazor-azure/.morph/docs/workflows/design-impl.md +0 -37
  248. package/stacks/blazor-azure/.morph/docs/workflows/enforcement-pipeline.md +0 -668
  249. package/stacks/blazor-azure/.morph/docs/workflows/fast-track.md +0 -29
  250. package/stacks/blazor-azure/.morph/docs/workflows/full-morph.md +0 -76
  251. package/stacks/blazor-azure/.morph/docs/workflows/standard.md +0 -44
  252. package/stacks/blazor-azure/.morph/docs/workflows/ui-refresh.md +0 -39
  253. package/stacks/blazor-azure/.morph/examples/api-nextjs/README.md +0 -241
  254. package/stacks/blazor-azure/.morph/examples/api-nextjs/contracts.ts +0 -307
  255. package/stacks/blazor-azure/.morph/examples/api-nextjs/spec.md +0 -399
  256. package/stacks/blazor-azure/.morph/examples/api-nextjs/tasks.md +0 -168
  257. package/stacks/blazor-azure/.morph/examples/micro-saas/README.md +0 -125
  258. package/stacks/blazor-azure/.morph/examples/micro-saas/contracts.cs +0 -358
  259. package/stacks/blazor-azure/.morph/examples/micro-saas/decisions.md +0 -246
  260. package/stacks/blazor-azure/.morph/examples/micro-saas/spec.md +0 -236
  261. package/stacks/blazor-azure/.morph/examples/micro-saas/tasks.md +0 -150
  262. package/stacks/blazor-azure/.morph/examples/multi-agent/README.md +0 -309
  263. package/stacks/blazor-azure/.morph/examples/multi-agent/contracts.cs +0 -433
  264. package/stacks/blazor-azure/.morph/examples/multi-agent/spec.md +0 -479
  265. package/stacks/blazor-azure/.morph/examples/multi-agent/tasks.md +0 -185
  266. package/stacks/blazor-azure/.morph/examples/scheduled-reports/decisions.md +0 -158
  267. package/stacks/blazor-azure/.morph/examples/scheduled-reports/proposal.md +0 -95
  268. package/stacks/blazor-azure/.morph/examples/scheduled-reports/spec.md +0 -267
  269. package/stacks/blazor-azure/.morph/examples/state-v3.json +0 -188
  270. package/stacks/blazor-azure/.morph/features/.gitkeep +0 -25
  271. package/stacks/blazor-azure/.morph/hooks/README.md +0 -348
  272. package/stacks/blazor-azure/.morph/hooks/pre-commit-agents.sh +0 -24
  273. package/stacks/blazor-azure/.morph/hooks/pre-commit-all.sh +0 -48
  274. package/stacks/blazor-azure/.morph/hooks/pre-commit-specs.sh +0 -49
  275. package/stacks/blazor-azure/.morph/hooks/task-completed.js +0 -73
  276. package/stacks/blazor-azure/.morph/hooks/teammate-idle.js +0 -68
  277. package/stacks/blazor-azure/.morph/schemas/agent.schema.json +0 -296
  278. package/stacks/blazor-azure/.morph/schemas/tasks.schema.json +0 -220
  279. package/stacks/blazor-azure/.morph/specs/.gitkeep +0 -20
  280. package/stacks/blazor-azure/.morph/standards/agent-framework-blazor-ui.md +0 -359
  281. package/stacks/blazor-azure/.morph/standards/agent-framework-production.md +0 -410
  282. package/stacks/blazor-azure/.morph/standards/agent-framework-setup.md +0 -413
  283. package/stacks/blazor-azure/.morph/standards/agent-framework-workflows.md +0 -349
  284. package/stacks/blazor-azure/.morph/standards/agent-teams-workflow.md +0 -474
  285. package/stacks/blazor-azure/.morph/standards/architecture.md +0 -325
  286. package/stacks/blazor-azure/.morph/standards/azure.md +0 -605
  287. package/stacks/blazor-azure/.morph/standards/coding.md +0 -377
  288. package/stacks/blazor-azure/.morph/standards/dotnet10-migration.md +0 -520
  289. package/stacks/blazor-azure/.morph/standards/fluent-ui-setup.md +0 -590
  290. package/stacks/blazor-azure/.morph/standards/migration-guide.md +0 -514
  291. package/stacks/blazor-azure/.morph/standards/passkeys-auth.md +0 -423
  292. package/stacks/blazor-azure/.morph/standards/vector-search-rag.md +0 -536
  293. package/stacks/blazor-azure/.morph/templates/CONTEXT-FEATURE.md +0 -276
  294. package/stacks/blazor-azure/.morph/templates/CONTEXT.md +0 -170
  295. package/stacks/blazor-azure/.morph/templates/FluentDesignTheme.cs +0 -149
  296. package/stacks/blazor-azure/.morph/templates/MudTheme.cs +0 -281
  297. package/stacks/blazor-azure/.morph/templates/agent.cs +0 -163
  298. package/stacks/blazor-azure/.morph/templates/clarify-questions.md +0 -159
  299. package/stacks/blazor-azure/.morph/templates/component.razor +0 -239
  300. package/stacks/blazor-azure/.morph/templates/contracts/Commands.cs +0 -74
  301. package/stacks/blazor-azure/.morph/templates/contracts/Entities.cs +0 -25
  302. package/stacks/blazor-azure/.morph/templates/contracts/Queries.cs +0 -74
  303. package/stacks/blazor-azure/.morph/templates/contracts/README.md +0 -74
  304. package/stacks/blazor-azure/.morph/templates/contracts.cs +0 -217
  305. package/stacks/blazor-azure/.morph/templates/decisions.md +0 -123
  306. package/stacks/blazor-azure/.morph/templates/design-system.css +0 -226
  307. package/stacks/blazor-azure/.morph/templates/infra/.dockerignore.example +0 -89
  308. package/stacks/blazor-azure/.morph/templates/infra/Dockerfile.example +0 -82
  309. package/stacks/blazor-azure/.morph/templates/infra/README.md +0 -286
  310. package/stacks/blazor-azure/.morph/templates/infra/app-insights.bicep +0 -63
  311. package/stacks/blazor-azure/.morph/templates/infra/app-service.bicep +0 -164
  312. package/stacks/blazor-azure/.morph/templates/infra/azure-pipelines-deploy.yml +0 -480
  313. package/stacks/blazor-azure/.morph/templates/infra/container-app-env.bicep +0 -49
  314. package/stacks/blazor-azure/.morph/templates/infra/container-app.bicep +0 -156
  315. package/stacks/blazor-azure/.morph/templates/infra/deploy-checklist.md +0 -426
  316. package/stacks/blazor-azure/.morph/templates/infra/deploy.ps1 +0 -229
  317. package/stacks/blazor-azure/.morph/templates/infra/deploy.sh +0 -208
  318. package/stacks/blazor-azure/.morph/templates/infra/key-vault.bicep +0 -91
  319. package/stacks/blazor-azure/.morph/templates/infra/main.bicep +0 -189
  320. package/stacks/blazor-azure/.morph/templates/infra/parameters.dev.json +0 -29
  321. package/stacks/blazor-azure/.morph/templates/infra/parameters.prod.json +0 -29
  322. package/stacks/blazor-azure/.morph/templates/infra/parameters.staging.json +0 -29
  323. package/stacks/blazor-azure/.morph/templates/infra/sql-database.bicep +0 -103
  324. package/stacks/blazor-azure/.morph/templates/infra/storage.bicep +0 -106
  325. package/stacks/blazor-azure/.morph/templates/integrations/asaas-client.cs +0 -387
  326. package/stacks/blazor-azure/.morph/templates/integrations/asaas-webhook.cs +0 -351
  327. package/stacks/blazor-azure/.morph/templates/integrations/azure-identity-config.cs +0 -288
  328. package/stacks/blazor-azure/.morph/templates/integrations/clerk-config.cs +0 -258
  329. package/stacks/blazor-azure/.morph/templates/job.cs +0 -171
  330. package/stacks/blazor-azure/.morph/templates/migration.cs +0 -83
  331. package/stacks/blazor-azure/.morph/templates/proposal.md +0 -141
  332. package/stacks/blazor-azure/.morph/templates/recap.md +0 -94
  333. package/stacks/blazor-azure/.morph/templates/repository.cs +0 -141
  334. package/stacks/blazor-azure/.morph/templates/saas/subscription.cs +0 -347
  335. package/stacks/blazor-azure/.morph/templates/saas/tenant.cs +0 -338
  336. package/stacks/blazor-azure/.morph/templates/service.cs +0 -139
  337. package/stacks/blazor-azure/.morph/templates/simulation.md +0 -353
  338. package/stacks/blazor-azure/.morph/templates/spec.md +0 -149
  339. package/stacks/blazor-azure/.morph/templates/sprint-status.yaml +0 -68
  340. package/stacks/blazor-azure/.morph/templates/state.template.json +0 -222
  341. package/stacks/blazor-azure/.morph/templates/story.md +0 -143
  342. package/stacks/blazor-azure/.morph/templates/tasks.md +0 -257
  343. package/stacks/blazor-azure/.morph/templates/test.cs +0 -239
  344. package/stacks/blazor-azure/.morph/templates/ui-components.md +0 -362
  345. package/stacks/blazor-azure/.morph/templates/ui-design-system.md +0 -286
  346. package/stacks/blazor-azure/.morph/templates/ui-flows.md +0 -336
  347. package/stacks/blazor-azure/.morph/templates/ui-mockups.md +0 -133
  348. package/stacks/blazor-azure/.morph/test-infra/example.bicep +0 -59
  349. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/backend/dotnet-supabase.md +0 -244
  350. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/frontend/nextjs-supabase.md +0 -335
  351. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/infrastructure/easypanel-deployer.md +0 -189
  352. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/integrations/supabase-expert.md +0 -170
  353. package/stacks/nextjs-supabase/.morph/docs/easypanel-setup.md +0 -169
  354. package/stacks/nextjs-supabase/.morph/docs/supabase-mcp-setup.md +0 -247
  355. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/README.md +0 -697
  356. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/spec.md +0 -85
  357. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/tasks.md +0 -86
  358. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/README.md +0 -498
  359. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/decisions.md +0 -121
  360. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/spec.md +0 -138
  361. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/tasks.md +0 -162
  362. package/stacks/nextjs-supabase/.morph/standards/easypanel-deploy.md +0 -191
  363. package/stacks/nextjs-supabase/.morph/standards/nextjs-patterns.md +0 -193
  364. package/stacks/nextjs-supabase/.morph/standards/supabase-auth.md +0 -171
  365. package/stacks/nextjs-supabase/.morph/standards/supabase-pgvector.md +0 -164
  366. package/stacks/nextjs-supabase/.morph/standards/supabase-rls.md +0 -179
  367. package/stacks/nextjs-supabase/.morph/standards/supabase-storage.md +0 -148
  368. package/stacks/nextjs-supabase/.morph/templates/contracts.cs +0 -173
  369. package/stacks/nextjs-supabase/.morph/templates/contracts.ts +0 -168
  370. package/stacks/nextjs-supabase/.morph/templates/decisions.md +0 -115
  371. package/stacks/nextjs-supabase/.morph/templates/dockerfile-api.dockerfile +0 -38
  372. package/stacks/nextjs-supabase/.morph/templates/dockerfile-web.dockerfile +0 -48
  373. package/stacks/nextjs-supabase/.morph/templates/proposal.md +0 -145
  374. package/stacks/nextjs-supabase/.morph/templates/recap.md +0 -134
  375. package/stacks/nextjs-supabase/.morph/templates/rls-policy.sql +0 -57
  376. package/stacks/nextjs-supabase/.morph/templates/spec.md +0 -231
  377. package/stacks/nextjs-supabase/.morph/templates/supabase-migration.sql +0 -100
  378. package/stacks/nextjs-supabase/.morph/templates/tasks.md +0 -257
  379. /package/src/commands/{search-patterns.js → learning/search-patterns.js} +0 -0
  380. /package/src/{lib → core/templates}/template-data-sources.js +0 -0
  381. /package/src/lib/{design-system-generator.js → generators/design-system-generator.js} +0 -0
  382. /package/src/lib/{learning-system.js → learning/learning-system.js} +0 -0
  383. /package/src/lib/validators/{package-validator.js → packages/package-validator.js} +0 -0
  384. /package/src/lib/validators/{ui-contrast-validator.js → ui/ui-contrast-validator.js} +0 -0
  385. /package/{src/generator → stacks/blazor-azure/.morph/templates}/.gitkeep +0 -0
  386. /package/{src/llm → stacks/nextjs-supabase/.morph/templates}/.gitkeep +0 -0
@@ -1,85 +0,0 @@
1
- # CRUD App - Specification
2
-
3
- ## 1. Overview
4
-
5
- Full-stack CRUD application demonstrating the Next.js + .NET API + Supabase stack. Users can manage products with authentication, file uploads, and paginated listings.
6
-
7
- ### 1.1 Objectives
8
-
9
- - .NET 10 Minimal API with Dapper for data access
10
- - Supabase Auth for authentication (email + OAuth)
11
- - Row Level Security for data isolation per user
12
- - File uploads via Supabase Storage
13
- - Next.js 15 Server Components for data fetching
14
-
15
- ### 1.2 Use Cases
16
-
17
- - Internal product catalogs
18
- - Personal inventory management
19
- - MVP product showcases
20
- - Learning reference for the Next.js + Supabase stack
21
-
22
- ## 2. Functional Requirements
23
-
24
- ### 2.1 Product CRUD
25
-
26
- | ID | Requirement |
27
- |----|-------------|
28
- | PROD-001 | Create product with name, description, price, and image |
29
- | PROD-002 | List products with pagination (20 items/page) |
30
- | PROD-003 | Search products by name (case-insensitive) |
31
- | PROD-004 | Update product fields |
32
- | PROD-005 | Delete product (soft or hard delete) |
33
- | PROD-006 | View product detail page |
34
-
35
- ### 2.2 Authentication
36
-
37
- | ID | Requirement |
38
- |----|-------------|
39
- | AUTH-001 | Email/password sign-up and sign-in via Supabase Auth |
40
- | AUTH-002 | OAuth login (Google, GitHub) |
41
- | AUTH-003 | Session management with cookie-based refresh |
42
- | AUTH-004 | Protected routes via Next.js middleware |
43
- | AUTH-005 | JWT forwarded to .NET API for endpoint authorization |
44
-
45
- ### 2.3 File Uploads
46
-
47
- | ID | Requirement |
48
- |----|-------------|
49
- | FILE-001 | Upload product image to Supabase Storage |
50
- | FILE-002 | Generate signed URL for private images |
51
- | FILE-003 | Validate file type (JPEG, PNG, WebP) and size (max 5MB) |
52
- | FILE-004 | Delete image from storage when product is deleted |
53
-
54
- ### 2.4 Data Isolation
55
-
56
- | ID | Requirement |
57
- |----|-------------|
58
- | RLS-001 | Users can only read their own products |
59
- | RLS-002 | Users can only insert products with their own user_id |
60
- | RLS-003 | Users can only update/delete their own products |
61
- | RLS-004 | RLS enforced at PostgreSQL level (not just application) |
62
-
63
- ## 3. Non-Functional Requirements
64
-
65
- ### 3.1 Performance
66
-
67
- | ID | Requirement |
68
- |----|-------------|
69
- | PERF-001 | API response < 100ms (P95) for CRUD endpoints |
70
- | PERF-002 | LCP < 2.5s (Core Web Vitals) |
71
- | PERF-003 | Pagination via LIMIT/OFFSET with indexed queries |
72
-
73
- ### 3.2 Security
74
-
75
- | ID | Requirement |
76
- |----|-------------|
77
- | SEC-001 | HTTPS in production |
78
- | SEC-002 | CORS restricted to known frontend origins |
79
- | SEC-003 | SQL injection prevention via parameterized queries (Dapper) |
80
- | SEC-004 | JWT validation with Supabase secret |
81
- | SEC-005 | Supabase service_role key never exposed to frontend |
82
-
83
- ---
84
-
85
- *MORPH-SPEC by Polymorphism Tech*
@@ -1,86 +0,0 @@
1
- # CRUD App - Tasks
2
-
3
- ## Phase 1: Supabase Setup
4
-
5
- | ID | Task | Dependencies | Estimate |
6
- |----|------|--------------|----------|
7
- | T001 | Create Supabase project and configure auth providers (email, Google, GitHub) | - | S |
8
- | T002 | Create products table migration with RLS policies | T001 | M |
9
- | T003 | Create Supabase Storage bucket for product images with access policies | T001 | S |
10
-
11
- ## Phase 2: .NET API Setup
12
-
13
- | ID | Task | Dependencies | Estimate |
14
- |----|------|--------------|----------|
15
- | T004 | Create .NET 10 Minimal API project with Dapper and Npgsql | - | S |
16
- | T005 | Configure JWT authentication with Supabase JWT secret validation | T001, T004 | M |
17
- | T006 | Implement ProductsEndpoints (GET list with pagination, GET by id, POST, PUT, DELETE) | T004, T005 | M |
18
-
19
- ## Phase 3: Auth Middleware and CORS
20
-
21
- | ID | Task | Dependencies | Estimate |
22
- |----|------|--------------|----------|
23
- | T007 | Configure CORS policy for Next.js frontend origin | T004 | S |
24
- | T008 | Add health check endpoint and OpenAPI documentation | T004 | S |
25
-
26
- ## Phase 4: Next.js Frontend
27
-
28
- | ID | Task | Dependencies | Estimate |
29
- |----|------|--------------|----------|
30
- | T009 | Create Next.js 15 project with Tailwind CSS and @supabase/ssr | - | S |
31
- | T010 | Implement Supabase client (browser) and server client with cookie handling | T009, T001 | M |
32
- | T011 | Create login page with email/password and OAuth buttons | T010 | M |
33
- | T012 | Create auth callback route handler and Next.js middleware for protected routes | T010 | M |
34
-
35
- ## Phase 5: Product Pages
36
-
37
- | ID | Task | Dependencies | Estimate |
38
- |----|------|--------------|----------|
39
- | T013 | Create products list page (Server Component) with pagination and search | T006, T012 | M |
40
- | T014 | Create product detail/edit page with form validation | T013 | M |
41
- | T015 | Create new product page with image upload to Supabase Storage | T003, T013 | M |
42
-
43
- ## Phase 6: Docker and Deploy
44
-
45
- | ID | Task | Dependencies | Estimate |
46
- |----|------|--------------|----------|
47
- | T016 | Create Dockerfile.api (multi-stage .NET build) | T006 | S |
48
- | T017 | Create Dockerfile.web (Next.js standalone output) | T015 | S |
49
- | T018 | Create docker-compose.yml for local development | T016, T017 | S |
50
-
51
- ## Checkpoints
52
-
53
- | Checkpoint | After Tasks | Validation |
54
- |------------|-------------|------------|
55
- | CP1 | T003 | Supabase project ready with table, RLS, and storage bucket |
56
- | CP2 | T008 | API compiles, health check responds, JWT validation works |
57
- | CP3 | T012 | Auth flow works: login, session, protected routes |
58
- | CP4 | T015 | Full CRUD works: list, create, edit, delete products |
59
- | CP5 | T018 | Docker Compose runs both services locally |
60
-
61
- ## Legend
62
-
63
- - **S** = Small (< 1h)
64
- - **M** = Medium (1-3h)
65
-
66
- ## Execution Order
67
-
68
- ```
69
- Supabase: T001 -> T002 -> T003 (CP1)
70
-
71
- API (after T001):
72
- T004 -> T005 -> T006 -> T007 -> T008 (CP2)
73
-
74
- Frontend (after T001):
75
- T009 -> T010 -> T011 -> T012 (CP3)
76
-
77
- Pages (after API + Auth):
78
- T013 -> T014 -> T015 (CP4)
79
-
80
- Docker:
81
- T016 -> T017 -> T018 (CP5)
82
- ```
83
-
84
- ---
85
-
86
- *MORPH-SPEC by Polymorphism Tech*
@@ -1,498 +0,0 @@
1
- # Multi-Tenant SaaS - Next.js + .NET API + Supabase
2
-
3
- Multi-tenant SaaS application with tenant isolation via RLS, Stripe billing, team management, and AI-powered search using pgvector.
4
-
5
- ## Architecture
6
-
7
- ```
8
- ┌─────────────────────────────────────────────────────────────┐
9
- │ Next.js 15 Frontend │
10
- │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
11
- │ │ App Router │ │ Tenant │ │ Supabase Auth │ │
12
- │ │ /dashboard │ │ Context │ │ + custom claims │ │
13
- │ │ /settings │ │ Provider │ │ (tenant_id) │ │
14
- │ │ /billing │ │ │ │ │ │
15
- │ │ /search │ │ │ │ │ │
16
- │ └──────────────┘ └──────────────┘ └──────────────────┘ │
17
- └────────────────────────────┬────────────────────────────────┘
18
- │ REST API (Bearer JWT with tenant_id claim)
19
-
20
- ┌─────────────────────────────────────────────────────────────┐
21
- │ .NET 10 Minimal API │
22
- │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
23
- │ │ Tenant │ │ Stripe │ │ pgvector │ │
24
- │ │ Middleware │ │ Webhooks │ │ Search │ │
25
- │ │ (from JWT) │ │ Handler │ │ Endpoints │ │
26
- │ └──────────────┘ └──────────────┘ └──────────────────┘ │
27
- │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
28
- │ │ Dapper │ │ JWT Auth │ │ Team Mgmt │ │
29
- │ │ + pgvector │ │ Middleware │ │ Endpoints │ │
30
- │ └──────────────┘ └──────────────┘ └──────────────────┘ │
31
- └────────────────────────────┬────────────────────────────────┘
32
-
33
-
34
- ┌─────────────────────────────────────────────────────────────┐
35
- │ Supabase Cloud (Pro) │
36
- │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
37
- │ │ PostgreSQL │ │ Auth │ │ Storage │ │
38
- │ │ + RLS │ │ + custom │ │ (per-tenant │ │
39
- │ │ + pgvector │ │ claims │ │ buckets) │ │
40
- │ └──────────────┘ └──────────────┘ └──────────────────┘ │
41
- └─────────────────────────────────────────────────────────────┘
42
-
43
-
44
- ┌─────────────────────────────────────────────────────────────┐
45
- │ External Services │
46
- │ ┌──────────────┐ ┌──────────────┐ │
47
- │ │ Stripe │ │ OpenAI │ │
48
- │ │ Billing │ │ Embeddings │ │
49
- │ └──────────────┘ └──────────────┘ │
50
- └─────────────────────────────────────────────────────────────┘
51
- ```
52
-
53
- ## What It Demonstrates
54
-
55
- - Multi-tenancy via PostgreSQL RLS (tenant_id from JWT app_metadata)
56
- - Supabase Auth with custom claims for tenant context
57
- - Stripe subscription billing with webhook handling
58
- - Team management (invite, roles, remove members)
59
- - AI-powered semantic search using pgvector
60
- - Per-tenant data isolation at the database level
61
- - Dashboard with tenant-scoped metrics
62
-
63
- ## Tech Stack
64
-
65
- | Layer | Technology |
66
- |-------|-----------|
67
- | **Frontend** | Next.js 15 (App Router, Server Components) |
68
- | **Backend** | .NET 10 Minimal APIs + Dapper |
69
- | **Database** | Supabase PostgreSQL (Pro) + pgvector |
70
- | **Auth** | Supabase Auth with custom claims |
71
- | **Billing** | Stripe (subscriptions, webhooks) |
72
- | **AI Search** | OpenAI text-embedding-3-small + pgvector |
73
- | **Deploy** | EasyPanel (VPS) + Supabase Cloud |
74
-
75
- ## Cost Estimate
76
-
77
- | Resource | Tier | Cost/month |
78
- |----------|------|------------|
79
- | Supabase | Pro (8GB DB, 100GB Storage) | $25 |
80
- | VPS (API + Web) | Hetzner/DigitalOcean 2GB | ~$5-6 |
81
- | Stripe | Pay-as-you-go (2.9% + $0.30/txn) | Variable |
82
- | OpenAI Embeddings | text-embedding-3-small | ~$0.02/1M tokens |
83
- | Domain | Optional | ~$1 |
84
-
85
- **Total**: ~$31/month base + Stripe transaction fees
86
-
87
- ---
88
-
89
- ## Code Reference
90
-
91
- ### Tenant Isolation RLS Policy
92
-
93
- The core of multi-tenancy: every table has a `tenant_id` column, and RLS policies read the tenant from the JWT's `app_metadata`.
94
-
95
- ```sql
96
- -- supabase/migrations/001_tenant_setup.sql
97
-
98
- -- Function to extract tenant_id from JWT app_metadata
99
- CREATE OR REPLACE FUNCTION auth.tenant_id()
100
- RETURNS UUID AS $$
101
- SELECT COALESCE(
102
- (current_setting('request.jwt.claims', true)::json
103
- -> 'app_metadata' ->> 'tenant_id')::uuid,
104
- '00000000-0000-0000-0000-000000000000'::uuid
105
- );
106
- $$ LANGUAGE sql STABLE;
107
-
108
- -- Tenants table (no RLS - managed by service_role)
109
- CREATE TABLE tenants (
110
- id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
111
- name TEXT NOT NULL,
112
- slug TEXT NOT NULL UNIQUE,
113
- stripe_customer_id TEXT,
114
- plan TEXT NOT NULL DEFAULT 'free',
115
- status TEXT NOT NULL DEFAULT 'active',
116
- created_at TIMESTAMPTZ NOT NULL DEFAULT now()
117
- );
118
-
119
- -- Tenant members
120
- CREATE TABLE tenant_members (
121
- id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
122
- tenant_id UUID NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
123
- user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
124
- role TEXT NOT NULL DEFAULT 'member',
125
- invited_by UUID REFERENCES auth.users(id),
126
- created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
127
- UNIQUE(tenant_id, user_id)
128
- );
129
-
130
- ALTER TABLE tenant_members ENABLE ROW LEVEL SECURITY;
131
-
132
- CREATE POLICY "Members can view own tenant members"
133
- ON tenant_members FOR SELECT
134
- USING (tenant_id = auth.tenant_id());
135
-
136
- CREATE POLICY "Admins can manage tenant members"
137
- ON tenant_members FOR ALL
138
- USING (
139
- tenant_id = auth.tenant_id()
140
- AND EXISTS (
141
- SELECT 1 FROM tenant_members tm
142
- WHERE tm.tenant_id = auth.tenant_id()
143
- AND tm.user_id = auth.uid()
144
- AND tm.role IN ('owner', 'admin')
145
- )
146
- );
147
-
148
- -- Example tenant-scoped data table
149
- CREATE TABLE documents (
150
- id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
151
- tenant_id UUID NOT NULL REFERENCES tenants(id) ON DELETE CASCADE,
152
- title TEXT NOT NULL,
153
- content TEXT,
154
- embedding vector(1536),
155
- created_by UUID NOT NULL REFERENCES auth.users(id),
156
- created_at TIMESTAMPTZ NOT NULL DEFAULT now()
157
- );
158
-
159
- ALTER TABLE documents ENABLE ROW LEVEL SECURITY;
160
-
161
- CREATE POLICY "Tenant members can view documents"
162
- ON documents FOR SELECT
163
- USING (tenant_id = auth.tenant_id());
164
-
165
- CREATE POLICY "Tenant members can insert documents"
166
- ON documents FOR INSERT
167
- WITH CHECK (tenant_id = auth.tenant_id());
168
-
169
- CREATE INDEX idx_documents_tenant ON documents(tenant_id);
170
- CREATE INDEX idx_documents_embedding ON documents
171
- USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);
172
- ```
173
-
174
- ### Supabase Auth Custom Claims for tenant_id
175
-
176
- After a user is added to a tenant, set their `app_metadata` so the JWT includes `tenant_id`:
177
-
178
- ```sql
179
- -- supabase/migrations/002_auth_hooks.sql
180
-
181
- -- Function called after user joins a tenant
182
- CREATE OR REPLACE FUNCTION set_tenant_claim()
183
- RETURNS TRIGGER AS $$
184
- BEGIN
185
- -- Update user's app_metadata with tenant_id
186
- UPDATE auth.users
187
- SET raw_app_meta_data =
188
- COALESCE(raw_app_meta_data, '{}'::jsonb)
189
- || jsonb_build_object('tenant_id', NEW.tenant_id::text)
190
- WHERE id = NEW.user_id;
191
-
192
- RETURN NEW;
193
- END;
194
- $$ LANGUAGE plpgsql SECURITY DEFINER;
195
-
196
- CREATE TRIGGER on_tenant_member_created
197
- AFTER INSERT ON tenant_members
198
- FOR EACH ROW
199
- EXECUTE FUNCTION set_tenant_claim();
200
- ```
201
-
202
- ### Stripe Webhook Handler (.NET)
203
-
204
- ```csharp
205
- using Stripe;
206
- using Stripe.Events;
207
- using Dapper;
208
- using Npgsql;
209
-
210
- public static class StripeWebhookEndpoints
211
- {
212
- public static void MapStripeWebhooks(this IEndpointRouteBuilder app)
213
- {
214
- app.MapPost("/webhooks/stripe", HandleWebhookAsync)
215
- .AllowAnonymous();
216
- }
217
-
218
- private static async Task<IResult> HandleWebhookAsync(
219
- HttpRequest request,
220
- IConfiguration config,
221
- NpgsqlConnection db,
222
- CancellationToken ct = default)
223
- {
224
- var json = await new StreamReader(request.Body).ReadToEndAsync(ct);
225
- var endpointSecret = config["Stripe:WebhookSecret"]!;
226
-
227
- Event stripeEvent;
228
- try
229
- {
230
- stripeEvent = EventUtility.ConstructEvent(
231
- json,
232
- request.Headers["Stripe-Signature"],
233
- endpointSecret);
234
- }
235
- catch (StripeException)
236
- {
237
- return Results.BadRequest("Invalid signature");
238
- }
239
-
240
- await db.OpenAsync(ct);
241
-
242
- switch (stripeEvent.Type)
243
- {
244
- case EventTypes.CustomerSubscriptionCreated:
245
- case EventTypes.CustomerSubscriptionUpdated:
246
- {
247
- var subscription = stripeEvent.Data.Object as Subscription;
248
- await db.ExecuteAsync("""
249
- UPDATE tenants
250
- SET plan = @Plan, status = @Status
251
- WHERE stripe_customer_id = @CustomerId
252
- """,
253
- new
254
- {
255
- Plan = subscription!.Items.Data[0].Price.Lookup_key ?? "pro",
256
- Status = subscription.Status == "active" ? "active" : "past_due",
257
- CustomerId = subscription.CustomerId
258
- });
259
- break;
260
- }
261
-
262
- case EventTypes.CustomerSubscriptionDeleted:
263
- {
264
- var subscription = stripeEvent.Data.Object as Subscription;
265
- await db.ExecuteAsync("""
266
- UPDATE tenants
267
- SET plan = 'free', status = 'active'
268
- WHERE stripe_customer_id = @CustomerId
269
- """,
270
- new { CustomerId = subscription!.CustomerId });
271
- break;
272
- }
273
-
274
- case EventTypes.InvoicePaymentFailed:
275
- {
276
- var invoice = stripeEvent.Data.Object as Invoice;
277
- await db.ExecuteAsync("""
278
- UPDATE tenants SET status = 'past_due'
279
- WHERE stripe_customer_id = @CustomerId
280
- """,
281
- new { CustomerId = invoice!.CustomerId });
282
- break;
283
- }
284
- }
285
-
286
- return Results.Ok();
287
- }
288
- }
289
- ```
290
-
291
- ### Dashboard with Tenant Context
292
-
293
- ```tsx
294
- // app/(dashboard)/dashboard/page.tsx
295
- import { createClient } from "@/lib/supabase/server";
296
- import { redirect } from "next/navigation";
297
-
298
- const API_URL = process.env.API_URL || "http://localhost:5000";
299
-
300
- interface DashboardMetrics {
301
- totalDocuments: number;
302
- totalMembers: number;
303
- storageUsedMb: number;
304
- plan: string;
305
- searchesThisMonth: number;
306
- }
307
-
308
- export default async function DashboardPage() {
309
- const supabase = await createClient();
310
- const { data: { session } } = await supabase.auth.getSession();
311
-
312
- if (!session) redirect("/login");
313
-
314
- const tenantId = session.user.app_metadata?.tenant_id;
315
- if (!tenantId) redirect("/onboarding");
316
-
317
- const response = await fetch(`${API_URL}/api/dashboard`, {
318
- headers: { Authorization: `Bearer ${session.access_token}` },
319
- cache: "no-store",
320
- });
321
-
322
- const metrics: DashboardMetrics = await response.json();
323
-
324
- return (
325
- <div className="p-6">
326
- <h1 className="mb-6 text-2xl font-bold">Dashboard</h1>
327
-
328
- <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4">
329
- <MetricCard title="Documents" value={metrics.totalDocuments} />
330
- <MetricCard title="Team Members" value={metrics.totalMembers} />
331
- <MetricCard title="Storage Used" value={`${metrics.storageUsedMb} MB`} />
332
- <MetricCard
333
- title="Plan"
334
- value={metrics.plan.charAt(0).toUpperCase() + metrics.plan.slice(1)}
335
- />
336
- </div>
337
-
338
- <div className="mt-8">
339
- <h2 className="mb-4 text-lg font-semibold">Searches This Month</h2>
340
- <p className="text-3xl font-bold">{metrics.searchesThisMonth}</p>
341
- </div>
342
- </div>
343
- );
344
- }
345
-
346
- function MetricCard({ title, value }: { title: string; value: string | number }) {
347
- return (
348
- <div className="rounded-lg border p-4">
349
- <p className="text-sm text-gray-500">{title}</p>
350
- <p className="mt-1 text-2xl font-bold">{value}</p>
351
- </div>
352
- );
353
- }
354
- ```
355
-
356
- ### pgvector Similarity Search Endpoint
357
-
358
- ```csharp
359
- using Dapper;
360
- using Npgsql;
361
- using System.Security.Claims;
362
- using System.Text;
363
- using System.Text.Json;
364
-
365
- public static class SearchEndpoints
366
- {
367
- public static void MapSearchEndpoints(this IEndpointRouteBuilder app)
368
- {
369
- app.MapPost("/api/search", SearchAsync)
370
- .WithTags("Search")
371
- .RequireAuthorization();
372
- }
373
-
374
- private static async Task<IResult> SearchAsync(
375
- SearchRequest request,
376
- NpgsqlConnection db,
377
- IConfiguration config,
378
- ClaimsPrincipal user,
379
- CancellationToken ct = default)
380
- {
381
- // 1. Generate embedding from query text via OpenAI
382
- var embedding = await GenerateEmbeddingAsync(
383
- request.Query, config["OpenAI:ApiKey"]!, ct);
384
-
385
- // 2. Query pgvector for similar documents (scoped by tenant via RLS)
386
- var tenantId = user.FindFirstValue("tenant_id");
387
- await db.OpenAsync(ct);
388
-
389
- var results = await db.QueryAsync<SearchResult>("""
390
- SELECT id, title, content,
391
- 1 - (embedding <=> @Embedding::vector) AS similarity
392
- FROM documents
393
- WHERE tenant_id = @TenantId
394
- AND 1 - (embedding <=> @Embedding::vector) > @Threshold
395
- ORDER BY embedding <=> @Embedding::vector
396
- LIMIT @Limit
397
- """,
398
- new
399
- {
400
- Embedding = $"[{string.Join(",", embedding)}]",
401
- TenantId = Guid.Parse(tenantId!),
402
- Threshold = request.Threshold ?? 0.7,
403
- Limit = request.Limit ?? 10
404
- });
405
-
406
- return Results.Ok(results);
407
- }
408
-
409
- private static async Task<float[]> GenerateEmbeddingAsync(
410
- string text, string apiKey, CancellationToken ct)
411
- {
412
- using var http = new HttpClient();
413
- http.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
414
-
415
- var payload = new
416
- {
417
- model = "text-embedding-3-small",
418
- input = text
419
- };
420
-
421
- var response = await http.PostAsJsonAsync(
422
- "https://api.openai.com/v1/embeddings", payload, ct);
423
- response.EnsureSuccessStatusCode();
424
-
425
- var json = await response.Content.ReadFromJsonAsync<JsonElement>(ct);
426
- var embeddingArray = json
427
- .GetProperty("data")[0]
428
- .GetProperty("embedding");
429
-
430
- return embeddingArray.EnumerateArray()
431
- .Select(e => e.GetSingle())
432
- .ToArray();
433
- }
434
- }
435
-
436
- public sealed record SearchRequest(
437
- string Query, double? Threshold = 0.7, int? Limit = 10);
438
-
439
- public sealed record SearchResult(
440
- Guid Id, string Title, string? Content, double Similarity);
441
- ```
442
-
443
- ## Folder Structure
444
-
445
- ```
446
- project/
447
- ├── src/
448
- │ ├── api/ # .NET Backend
449
- │ │ ├── Endpoints/
450
- │ │ │ ├── DashboardEndpoints.cs
451
- │ │ │ ├── TeamEndpoints.cs
452
- │ │ │ ├── SearchEndpoints.cs
453
- │ │ │ ├── StripeWebhookEndpoints.cs
454
- │ │ │ └── DocumentEndpoints.cs
455
- │ │ ├── Middleware/
456
- │ │ │ └── TenantMiddleware.cs
457
- │ │ ├── DTOs/
458
- │ │ ├── Program.cs
459
- │ │ └── Api.csproj
460
- │ │
461
- │ └── web/ # Next.js Frontend
462
- │ ├── app/
463
- │ │ ├── (auth)/
464
- │ │ │ ├── login/page.tsx
465
- │ │ │ └── signup/page.tsx
466
- │ │ ├── (dashboard)/
467
- │ │ │ ├── layout.tsx
468
- │ │ │ ├── dashboard/page.tsx
469
- │ │ │ ├── documents/page.tsx
470
- │ │ │ ├── search/page.tsx
471
- │ │ │ ├── team/page.tsx
472
- │ │ │ ├── billing/page.tsx
473
- │ │ │ └── settings/page.tsx
474
- │ │ ├── onboarding/page.tsx
475
- │ │ ├── auth/callback/route.ts
476
- │ │ ├── layout.tsx
477
- │ │ └── page.tsx
478
- │ ├── components/
479
- │ │ ├── tenant-provider.tsx
480
- │ │ └── ...
481
- │ ├── lib/
482
- │ │ └── supabase/
483
- │ └── types/
484
-
485
- ├── supabase/
486
- │ └── migrations/
487
- │ ├── 001_tenant_setup.sql
488
- │ ├── 002_auth_hooks.sql
489
- │ └── 003_pgvector_setup.sql
490
-
491
- ├── docker-compose.yml
492
- ├── Dockerfile.api
493
- └── Dockerfile.web
494
- ```
495
-
496
- ---
497
-
498
- *MORPH-SPEC by Polymorphism Tech*