@polymorphism-tech/morph-spec 3.0.1 → 3.1.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 (273) hide show
  1. package/CLAUDE.md +52 -88
  2. package/LICENSE +72 -72
  3. package/README.md +198 -76
  4. package/bin/detect-agents.js +3 -1
  5. package/bin/morph-spec.js +10 -0
  6. package/bin/render-template.js +5 -4
  7. package/bin/semantic-detect-agents.js +2 -1
  8. package/bin/{task-manager.js → task-manager.cjs} +12 -1
  9. package/bin/validate-agents-skills.js +10 -4
  10. package/bin/validate-agents.js +4 -3
  11. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  12. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  13. package/docs/api/scripts/collapse.js +38 -38
  14. package/docs/api/scripts/commonNav.js +28 -28
  15. package/docs/api/scripts/linenumber.js +25 -25
  16. package/docs/api/scripts/nav.js +12 -12
  17. package/docs/api/scripts/polyfill.js +3 -3
  18. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  19. package/docs/api/scripts/prettify/lang-css.js +2 -2
  20. package/docs/api/scripts/prettify/prettify.js +28 -28
  21. package/docs/api/scripts/search.js +98 -98
  22. package/docs/api/styles/jsdoc.css +776 -776
  23. package/docs/api/styles/prettify.css +80 -80
  24. package/docs/examples.md +328 -328
  25. package/docs/getting-started.md +3 -3
  26. package/docs/templates.md +418 -418
  27. package/package.json +3 -3
  28. package/scripts/postinstall.js +132 -132
  29. package/scripts/reorganize-skills.cjs +1 -1
  30. package/scripts/validate-agents-structure.cjs +1 -1
  31. package/scripts/validate-skills.cjs +2 -2
  32. package/src/commands/analyze-blazor-concurrency.js +193 -193
  33. package/src/commands/create-story.js +5 -2
  34. package/src/commands/deploy.js +780 -780
  35. package/src/commands/detect-agents.js +4 -2
  36. package/src/commands/generate.js +149 -149
  37. package/src/commands/lint-fluent.js +352 -352
  38. package/src/commands/rollback-phase.js +185 -185
  39. package/src/commands/session-summary.js +291 -291
  40. package/src/commands/shard-spec.js +224 -224
  41. package/src/commands/sprint-status.js +250 -250
  42. package/src/commands/task.js +1 -1
  43. package/src/commands/troubleshoot.js +222 -222
  44. package/src/commands/validate-blazor-state.js +210 -210
  45. package/src/commands/validate-blazor.js +156 -156
  46. package/src/commands/validate-css.js +84 -84
  47. package/src/commands/validate-phase.js +221 -221
  48. package/src/lib/blazor-concurrency-analyzer.js +288 -288
  49. package/src/lib/blazor-state-validator.js +291 -291
  50. package/src/lib/blazor-validator.js +374 -374
  51. package/src/lib/context-generator.js +7 -4
  52. package/src/lib/css-validator.js +352 -352
  53. package/src/lib/design-system-generator.js +298 -298
  54. package/src/lib/hook-executor.js +2 -1
  55. package/src/lib/learning-system.js +520 -520
  56. package/src/lib/mockup-generator.js +366 -366
  57. package/src/lib/stack-resolver.js +148 -0
  58. package/src/lib/standards-context-injector.js +4 -3
  59. package/src/lib/team-orchestrator.js +2 -1
  60. package/src/lib/troubleshoot-grep.js +204 -194
  61. package/src/lib/troubleshoot-index.js +144 -144
  62. package/src/lib/ui-detector.js +350 -350
  63. package/src/lib/validation-runner.js +2 -1
  64. package/src/lib/validators/architecture-validator.js +387 -387
  65. package/src/lib/validators/package-validator.js +360 -360
  66. package/src/lib/validators/ui-contrast-validator.js +422 -422
  67. package/src/utils/file-copier.js +3 -1
  68. package/src/utils/logger.js +32 -32
  69. package/src/utils/version-checker.js +175 -175
  70. package/{content → stacks/blazor-azure}/.azure/README.md +2 -2
  71. package/{content → stacks/blazor-azure}/.azure/pipelines/pipeline-variables.yml +1 -1
  72. package/{content → stacks/blazor-azure}/.azure/pipelines/prod-pipeline.yml +1 -1
  73. package/{content → stacks/blazor-azure}/.azure/pipelines/staging-pipeline.yml +1 -1
  74. package/{content → stacks/blazor-azure}/.claude/commands/morph-preflight.md +227 -227
  75. package/{content → stacks/blazor-azure}/.claude/commands/morph-troubleshoot.md +122 -122
  76. package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-setup.md +1 -1
  77. package/{content → stacks/blazor-azure}/.morph/docs/workflows/enforcement-pipeline.md +3 -3
  78. package/{content → stacks/blazor-azure}/.morph/hooks/README.md +12 -12
  79. package/{content → stacks/blazor-azure}/.morph/standards/agent-teams-workflow.md +2 -2
  80. package/{content → stacks/blazor-azure}/.morph/standards/migration-guide.md +2 -2
  81. package/{content → stacks/blazor-azure}/.morph/templates/infra/deploy-checklist.md +426 -426
  82. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/backend/dotnet-supabase.md +244 -0
  83. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/frontend/nextjs-supabase.md +335 -0
  84. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/infrastructure/easypanel-deployer.md +189 -0
  85. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/integrations/supabase-expert.md +170 -0
  86. package/stacks/nextjs-supabase/.morph/config/agents.json +345 -0
  87. package/stacks/nextjs-supabase/.morph/config/config.template.json +92 -0
  88. package/stacks/nextjs-supabase/.morph/docs/easypanel-setup.md +169 -0
  89. package/stacks/nextjs-supabase/.morph/docs/supabase-mcp-setup.md +247 -0
  90. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/README.md +697 -0
  91. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/spec.md +85 -0
  92. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/tasks.md +86 -0
  93. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/README.md +498 -0
  94. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/decisions.md +121 -0
  95. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/spec.md +138 -0
  96. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/tasks.md +162 -0
  97. package/stacks/nextjs-supabase/.morph/project.md +168 -0
  98. package/stacks/nextjs-supabase/.morph/standards/easypanel-deploy.md +191 -0
  99. package/stacks/nextjs-supabase/.morph/standards/nextjs-patterns.md +193 -0
  100. package/stacks/nextjs-supabase/.morph/standards/supabase-auth.md +171 -0
  101. package/stacks/nextjs-supabase/.morph/standards/supabase-pgvector.md +164 -0
  102. package/stacks/nextjs-supabase/.morph/standards/supabase-rls.md +179 -0
  103. package/stacks/nextjs-supabase/.morph/standards/supabase-storage.md +148 -0
  104. package/stacks/nextjs-supabase/.morph/templates/contracts.cs +173 -0
  105. package/stacks/nextjs-supabase/.morph/templates/contracts.ts +168 -0
  106. package/stacks/nextjs-supabase/.morph/templates/decisions.md +115 -0
  107. package/stacks/nextjs-supabase/.morph/templates/dockerfile-api.dockerfile +38 -0
  108. package/stacks/nextjs-supabase/.morph/templates/dockerfile-web.dockerfile +48 -0
  109. package/stacks/nextjs-supabase/.morph/templates/proposal.md +145 -0
  110. package/stacks/nextjs-supabase/.morph/templates/recap.md +134 -0
  111. package/stacks/nextjs-supabase/.morph/templates/rls-policy.sql +57 -0
  112. package/stacks/nextjs-supabase/.morph/templates/spec.md +231 -0
  113. package/stacks/nextjs-supabase/.morph/templates/supabase-migration.sql +100 -0
  114. package/stacks/nextjs-supabase/.morph/templates/tasks.md +257 -0
  115. package/stacks/nextjs-supabase/CLAUDE.md +149 -0
  116. package/stacks/nextjs-supabase/README.md +112 -0
  117. /package/{content → stacks/blazor-azure}/.azure/docs/azure-devops-setup.md +0 -0
  118. /package/{content → stacks/blazor-azure}/.azure/docs/branch-strategy.md +0 -0
  119. /package/{content → stacks/blazor-azure}/.azure/docs/local-development.md +0 -0
  120. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/build-dotnet.yml +0 -0
  121. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/deploy-app-service.yml +0 -0
  122. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/deploy-container-app.yml +0 -0
  123. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/infra-deploy.yml +0 -0
  124. /package/{content → stacks/blazor-azure}/.claude/commands/morph-apply.md +0 -0
  125. /package/{content → stacks/blazor-azure}/.claude/commands/morph-archive.md +0 -0
  126. /package/{content → stacks/blazor-azure}/.claude/commands/morph-deploy.md +0 -0
  127. /package/{content → stacks/blazor-azure}/.claude/commands/morph-infra.md +0 -0
  128. /package/{content → stacks/blazor-azure}/.claude/commands/morph-proposal.md +0 -0
  129. /package/{content → stacks/blazor-azure}/.claude/commands/morph-status.md +0 -0
  130. /package/{content → stacks/blazor-azure}/.claude/settings.local.json +0 -0
  131. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/README.md +0 -0
  132. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/code-review.md +0 -0
  133. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/morph-checklist.md +0 -0
  134. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/simulation-checklist.md +0 -0
  135. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/README.md +0 -0
  136. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/morph-replicate.md +0 -0
  137. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-clarify.md +0 -0
  138. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-design.md +0 -0
  139. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-tasks.md +0 -0
  140. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-uiux.md +0 -0
  141. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/README.md +0 -0
  142. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +0 -0
  143. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/po-pm-advisor.md +0 -0
  144. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/prompt-engineer.md +0 -0
  145. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/seo-growth-hacker.md +0 -0
  146. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/standards-architect.md +0 -0
  147. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/dotnet-senior.md +0 -0
  148. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/ef-modeler.md +0 -0
  149. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/hangfire-orchestrator.md +0 -0
  150. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/ms-agent-expert.md +0 -0
  151. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/frontend/blazor-builder.md +0 -0
  152. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/frontend/nextjs-expert.md +0 -0
  153. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/frontend/ui-ux-designer.md +0 -0
  154. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/azure-architect.md +0 -0
  155. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/azure-deploy-specialist.md +0 -0
  156. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/bicep-architect.md +0 -0
  157. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/container-specialist.md +0 -0
  158. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/devops-engineer.md +0 -0
  159. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/asaas-financial.md +0 -0
  160. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/azure-identity.md +0 -0
  161. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/clerk-auth.md +0 -0
  162. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/resend-email.md +0 -0
  163. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/quality/code-analyzer.md +0 -0
  164. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/quality/testing-specialist.md +0 -0
  165. /package/{content → stacks/blazor-azure}/.claude/skills/level-3-technologies/README.md +0 -0
  166. /package/{content → stacks/blazor-azure}/.claude/skills/level-4-patterns/README.md +0 -0
  167. /package/{content → stacks/blazor-azure}/.morph/.morphversion +0 -0
  168. /package/{content → stacks/blazor-azure}/.morph/archive/.gitkeep +0 -0
  169. /package/{content → stacks/blazor-azure}/.morph/config/agents.json +0 -0
  170. /package/{content → stacks/blazor-azure}/.morph/config/config.template.json +0 -0
  171. /package/{content → stacks/blazor-azure}/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -0
  172. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/design-impl.md +0 -0
  173. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/fast-track.md +0 -0
  174. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/full-morph.md +0 -0
  175. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/standard.md +0 -0
  176. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/ui-refresh.md +0 -0
  177. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/README.md +0 -0
  178. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/contracts.ts +0 -0
  179. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/spec.md +0 -0
  180. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/tasks.md +0 -0
  181. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/README.md +0 -0
  182. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/contracts.cs +0 -0
  183. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/decisions.md +0 -0
  184. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/spec.md +0 -0
  185. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/tasks.md +0 -0
  186. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/README.md +0 -0
  187. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/contracts.cs +0 -0
  188. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/spec.md +0 -0
  189. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/tasks.md +0 -0
  190. /package/{content → stacks/blazor-azure}/.morph/examples/scheduled-reports/decisions.md +0 -0
  191. /package/{content → stacks/blazor-azure}/.morph/examples/scheduled-reports/proposal.md +0 -0
  192. /package/{content → stacks/blazor-azure}/.morph/examples/scheduled-reports/spec.md +0 -0
  193. /package/{content → stacks/blazor-azure}/.morph/examples/state-v3.json +0 -0
  194. /package/{content → stacks/blazor-azure}/.morph/features/.gitkeep +0 -0
  195. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-agents.sh +0 -0
  196. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-all.sh +0 -0
  197. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-specs.sh +0 -0
  198. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-tests.sh +0 -0
  199. /package/{content → stacks/blazor-azure}/.morph/hooks/task-completed.js +0 -0
  200. /package/{content → stacks/blazor-azure}/.morph/hooks/teammate-idle.js +0 -0
  201. /package/{content → stacks/blazor-azure}/.morph/project.md +0 -0
  202. /package/{content → stacks/blazor-azure}/.morph/schemas/agent.schema.json +0 -0
  203. /package/{content → stacks/blazor-azure}/.morph/schemas/tasks.schema.json +0 -0
  204. /package/{content → stacks/blazor-azure}/.morph/specs/.gitkeep +0 -0
  205. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-blazor-ui.md +0 -0
  206. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-production.md +0 -0
  207. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-setup.md +0 -0
  208. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-workflows.md +0 -0
  209. /package/{content → stacks/blazor-azure}/.morph/standards/architecture.md +0 -0
  210. /package/{content → stacks/blazor-azure}/.morph/standards/azure.md +0 -0
  211. /package/{content → stacks/blazor-azure}/.morph/standards/coding.md +0 -0
  212. /package/{content → stacks/blazor-azure}/.morph/standards/dotnet10-migration.md +0 -0
  213. /package/{content → stacks/blazor-azure}/.morph/standards/fluent-ui-setup.md +0 -0
  214. /package/{content → stacks/blazor-azure}/.morph/standards/passkeys-auth.md +0 -0
  215. /package/{content → stacks/blazor-azure}/.morph/standards/vector-search-rag.md +0 -0
  216. /package/{content → stacks/blazor-azure}/.morph/state.json +0 -0
  217. /package/{content → stacks/blazor-azure}/.morph/templates/CONTEXT-FEATURE.md +0 -0
  218. /package/{content → stacks/blazor-azure}/.morph/templates/CONTEXT.md +0 -0
  219. /package/{content → stacks/blazor-azure}/.morph/templates/FluentDesignTheme.cs +0 -0
  220. /package/{content → stacks/blazor-azure}/.morph/templates/MudTheme.cs +0 -0
  221. /package/{content → stacks/blazor-azure}/.morph/templates/agent.cs +0 -0
  222. /package/{content → stacks/blazor-azure}/.morph/templates/clarify-questions.md +0 -0
  223. /package/{content → stacks/blazor-azure}/.morph/templates/component.razor +0 -0
  224. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/Commands.cs +0 -0
  225. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/Entities.cs +0 -0
  226. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/Queries.cs +0 -0
  227. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/README.md +0 -0
  228. /package/{content → stacks/blazor-azure}/.morph/templates/contracts.cs +0 -0
  229. /package/{content → stacks/blazor-azure}/.morph/templates/decisions.md +0 -0
  230. /package/{content → stacks/blazor-azure}/.morph/templates/design-system.css +0 -0
  231. /package/{content → stacks/blazor-azure}/.morph/templates/infra/.dockerignore.example +0 -0
  232. /package/{content → stacks/blazor-azure}/.morph/templates/infra/Dockerfile.example +0 -0
  233. /package/{content → stacks/blazor-azure}/.morph/templates/infra/README.md +0 -0
  234. /package/{content → stacks/blazor-azure}/.morph/templates/infra/app-insights.bicep +0 -0
  235. /package/{content → stacks/blazor-azure}/.morph/templates/infra/app-service.bicep +0 -0
  236. /package/{content → stacks/blazor-azure}/.morph/templates/infra/azure-pipelines-deploy.yml +0 -0
  237. /package/{content → stacks/blazor-azure}/.morph/templates/infra/container-app-env.bicep +0 -0
  238. /package/{content → stacks/blazor-azure}/.morph/templates/infra/container-app.bicep +0 -0
  239. /package/{content → stacks/blazor-azure}/.morph/templates/infra/deploy.ps1 +0 -0
  240. /package/{content → stacks/blazor-azure}/.morph/templates/infra/deploy.sh +0 -0
  241. /package/{content → stacks/blazor-azure}/.morph/templates/infra/key-vault.bicep +0 -0
  242. /package/{content → stacks/blazor-azure}/.morph/templates/infra/main.bicep +0 -0
  243. /package/{content → stacks/blazor-azure}/.morph/templates/infra/parameters.dev.json +0 -0
  244. /package/{content → stacks/blazor-azure}/.morph/templates/infra/parameters.prod.json +0 -0
  245. /package/{content → stacks/blazor-azure}/.morph/templates/infra/parameters.staging.json +0 -0
  246. /package/{content → stacks/blazor-azure}/.morph/templates/infra/sql-database.bicep +0 -0
  247. /package/{content → stacks/blazor-azure}/.morph/templates/infra/storage.bicep +0 -0
  248. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/asaas-client.cs +0 -0
  249. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/asaas-webhook.cs +0 -0
  250. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/azure-identity-config.cs +0 -0
  251. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/clerk-config.cs +0 -0
  252. /package/{content → stacks/blazor-azure}/.morph/templates/job.cs +0 -0
  253. /package/{content → stacks/blazor-azure}/.morph/templates/migration.cs +0 -0
  254. /package/{content → stacks/blazor-azure}/.morph/templates/proposal.md +0 -0
  255. /package/{content → stacks/blazor-azure}/.morph/templates/recap.md +0 -0
  256. /package/{content → stacks/blazor-azure}/.morph/templates/repository.cs +0 -0
  257. /package/{content → stacks/blazor-azure}/.morph/templates/saas/subscription.cs +0 -0
  258. /package/{content → stacks/blazor-azure}/.morph/templates/saas/tenant.cs +0 -0
  259. /package/{content → stacks/blazor-azure}/.morph/templates/service.cs +0 -0
  260. /package/{content → stacks/blazor-azure}/.morph/templates/simulation.md +0 -0
  261. /package/{content → stacks/blazor-azure}/.morph/templates/spec.md +0 -0
  262. /package/{content → stacks/blazor-azure}/.morph/templates/sprint-status.yaml +0 -0
  263. /package/{content → stacks/blazor-azure}/.morph/templates/state.template.json +0 -0
  264. /package/{content → stacks/blazor-azure}/.morph/templates/story.md +0 -0
  265. /package/{content → stacks/blazor-azure}/.morph/templates/tasks.md +0 -0
  266. /package/{content → stacks/blazor-azure}/.morph/templates/test.cs +0 -0
  267. /package/{content → stacks/blazor-azure}/.morph/templates/ui-components.md +0 -0
  268. /package/{content → stacks/blazor-azure}/.morph/templates/ui-design-system.md +0 -0
  269. /package/{content → stacks/blazor-azure}/.morph/templates/ui-flows.md +0 -0
  270. /package/{content → stacks/blazor-azure}/.morph/templates/ui-mockups.md +0 -0
  271. /package/{content → stacks/blazor-azure}/.morph/test-infra/example.bicep +0 -0
  272. /package/{content → stacks/blazor-azure}/CLAUDE.md +0 -0
  273. /package/{content → stacks/blazor-azure}/README.md +0 -0
@@ -0,0 +1,85 @@
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*
@@ -0,0 +1,86 @@
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*
@@ -0,0 +1,498 @@
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*