agentic-dev 0.1.0 → 0.2.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 (677) hide show
  1. package/.agent/prd.json +29 -0
  2. package/.agent/progress.txt +1 -0
  3. package/.agent/prompt.md +21 -0
  4. package/.agent/ralph-loop-state.json +13 -0
  5. package/.agent/ralph-supervisor-state.json +12 -0
  6. package/.agent/ralph-supervisor.sh +238 -0
  7. package/.agent/ralph.sh +305 -0
  8. package/.agent/runs/README.md +7 -0
  9. package/.agent/sdd-build-ast-audit.json +13 -0
  10. package/.claude/CLAUDE.md +44 -0
  11. package/.claude/agentic-dev.json +3 -0
  12. package/.claude/agents/ai-dev.md +27 -0
  13. package/.claude/agents/backend-dev.md +26 -0
  14. package/.claude/agents/db-dev.md +26 -0
  15. package/.claude/agents/devops.md +27 -0
  16. package/.claude/agents/frontend-dev.md +25 -0
  17. package/.claude/agents/github-ops.md +25 -0
  18. package/.claude/agents/test-dev.md +26 -0
  19. package/.claude/agents/uiux-designer.md +25 -0
  20. package/.claude/settings.json +49 -0
  21. package/.claude/settings.local.json +8 -0
  22. package/.claude/skills/commit/SKILL.md +37 -0
  23. package/.claude/skills/dev-browser/SKILL.md +30 -0
  24. package/.claude/skills/otro/SKILL.md +43 -0
  25. package/.claude/skills/planning-with-files/SKILL.md +37 -0
  26. package/.claude/skills/prd/SKILL.md +27 -0
  27. package/.claude/skills/ralph-loop/SKILL.md +42 -0
  28. package/.claude/skills/sdd/SKILL.md +13 -0
  29. package/.claude/skills/sdd-dev/SKILL.md +71 -0
  30. package/.claude/skills/sdd-development/SKILL.md +13 -0
  31. package/.claude/workspace-config.json +3 -0
  32. package/.codex/agentic-dev.json +3 -0
  33. package/.codex/agents/README.md +22 -0
  34. package/.codex/agents/api.toml +11 -0
  35. package/.codex/agents/architecture.toml +11 -0
  36. package/.codex/agents/ci.toml +11 -0
  37. package/.codex/agents/gitops.toml +11 -0
  38. package/.codex/agents/orchestrator.toml +11 -0
  39. package/.codex/agents/quality.toml +11 -0
  40. package/.codex/agents/runtime.toml +11 -0
  41. package/.codex/agents/security.toml +11 -0
  42. package/.codex/agents/specs.toml +11 -0
  43. package/.codex/agents/ui.toml +11 -0
  44. package/.codex/config.toml +46 -0
  45. package/.codex/skills/SKILL.md +13 -0
  46. package/.codex/skills/agents/openai.yaml +4 -0
  47. package/.codex/skills/commit/SKILL.md +219 -0
  48. package/.codex/skills/commit/references/commit_examples.md +292 -0
  49. package/.codex/skills/dev-browser/SKILL.md +211 -0
  50. package/.codex/skills/dev-browser/bun.lock +443 -0
  51. package/.codex/skills/dev-browser/package-lock.json +2988 -0
  52. package/.codex/skills/dev-browser/package.json +31 -0
  53. package/.codex/skills/dev-browser/references/scraping.md +155 -0
  54. package/.codex/skills/dev-browser/scripts/start-relay.ts +32 -0
  55. package/.codex/skills/dev-browser/scripts/start-server.ts +117 -0
  56. package/.codex/skills/dev-browser/server.sh +24 -0
  57. package/.codex/skills/dev-browser/src/client.ts +474 -0
  58. package/.codex/skills/dev-browser/src/index.ts +287 -0
  59. package/.codex/skills/dev-browser/src/relay.ts +731 -0
  60. package/.codex/skills/dev-browser/src/snapshot/__tests__/snapshot.test.ts +223 -0
  61. package/.codex/skills/dev-browser/src/snapshot/browser-script.ts +877 -0
  62. package/.codex/skills/dev-browser/src/snapshot/index.ts +14 -0
  63. package/.codex/skills/dev-browser/src/snapshot/inject.ts +13 -0
  64. package/.codex/skills/dev-browser/src/types.ts +34 -0
  65. package/.codex/skills/dev-browser/tsconfig.json +36 -0
  66. package/.codex/skills/dev-browser/vitest.config.ts +12 -0
  67. package/.codex/skills/otro/SKILL.md +74 -0
  68. package/.codex/skills/otro/agents/openai.yaml +4 -0
  69. package/.codex/skills/otro/references/agent-prompts.md +61 -0
  70. package/.codex/skills/otro/references/contracts.md +146 -0
  71. package/.codex/skills/otro/references/orchestration-loop.md +51 -0
  72. package/.codex/skills/otro/references/runtime.md +79 -0
  73. package/.codex/skills/otro/runs/README.md +11 -0
  74. package/.codex/skills/otro/schemas/step_plan.schema.json +289 -0
  75. package/.codex/skills/otro/schemas/task_result.schema.json +142 -0
  76. package/.codex/skills/otro/schemas/wave_plan.schema.json +4 -0
  77. package/.codex/skills/otro/scripts/README.md +38 -0
  78. package/.codex/skills/otro/scripts/bump_validation_header.py +179 -0
  79. package/.codex/skills/otro/scripts/check_validation_header.py +84 -0
  80. package/.codex/skills/otro/scripts/common.py +303 -0
  81. package/.codex/skills/otro/scripts/init_run.sh +68 -0
  82. package/.codex/skills/otro/scripts/plan_loop.py +8 -0
  83. package/.codex/skills/otro/scripts/plan_step.py +367 -0
  84. package/.codex/skills/otro/scripts/plan_wave.py +8 -0
  85. package/.codex/skills/otro/scripts/reconcile_loop.py +8 -0
  86. package/.codex/skills/otro/scripts/reconcile_step.py +37 -0
  87. package/.codex/skills/otro/scripts/reconcile_wave.py +8 -0
  88. package/.codex/skills/otro/scripts/run_loop.py +300 -0
  89. package/.codex/skills/otro/scripts/run_loop_step.py +8 -0
  90. package/.codex/skills/otro/scripts/run_step.py +246 -0
  91. package/.codex/skills/otro/scripts/run_wave.py +8 -0
  92. package/.codex/skills/otro/validation/validation.md +15 -0
  93. package/.codex/skills/planning-with-files/SKILL.md +42 -0
  94. package/.codex/skills/planning-with-files/agents/openai.yaml +4 -0
  95. package/.codex/skills/planning-with-files/assets/plan-template.md +37 -0
  96. package/.codex/skills/planning-with-files/references/plan-rules.md +35 -0
  97. package/.codex/skills/planning-with-files/scripts/new_plan.sh +65 -0
  98. package/.codex/skills/prd/SKILL.md +235 -0
  99. package/.codex/skills/ralph-loop/SKILL.md +46 -0
  100. package/.codex/skills/ralph-loop/agents/openai.yaml +4 -0
  101. package/.codex/skills/ralph-loop/references/failure-triage.md +32 -0
  102. package/.codex/skills/ralph-loop/scripts/loop_until_success.sh +97 -0
  103. package/.codex/skills/sdd/SKILL.md +184 -0
  104. package/.codex/skills/sdd/agents/openai.yaml +4 -0
  105. package/.codex/skills/sdd/references/section-map.md +67 -0
  106. package/.dockerignore +8 -0
  107. package/.env.example +50 -0
  108. package/.gitignore +16 -0
  109. package/AGENTS.md +78 -0
  110. package/README.md +83 -47
  111. package/SDD_SKILL.md +589 -0
  112. package/bin/agentic-dev.mjs +97 -0
  113. package/client/admin/.dockerignore +3 -0
  114. package/client/admin/.env.example +1 -0
  115. package/client/admin/Dockerfile +16 -0
  116. package/client/admin/Dockerfile.dev +18 -0
  117. package/client/admin/README.md +20 -0
  118. package/client/admin/index.html +12 -0
  119. package/client/admin/package.json +41 -0
  120. package/client/admin/postcss.config.js +6 -0
  121. package/client/admin/scripts/ui-parity-admin-adapter.mjs +65 -0
  122. package/client/admin/src/api/alerts.ts +33 -0
  123. package/client/admin/src/api/client.ts +71 -0
  124. package/client/admin/src/api/orders.ts +33 -0
  125. package/client/admin/src/api/support.ts +11 -0
  126. package/client/admin/src/app/App.tsx +23 -0
  127. package/client/admin/src/auth/AuthProvider.tsx +122 -0
  128. package/client/admin/src/auth/ProtectedRoute.tsx +22 -0
  129. package/client/admin/src/auth/auth-client.ts +38 -0
  130. package/client/admin/src/auth/types.ts +18 -0
  131. package/client/admin/src/components/AdminNotificationsDrawer.tsx +162 -0
  132. package/client/admin/src/components/AdminShell.tsx +76 -0
  133. package/client/admin/src/components/ui/button.tsx +34 -0
  134. package/client/admin/src/components/ui/input.tsx +21 -0
  135. package/client/admin/src/lib/cn.ts +6 -0
  136. package/client/admin/src/lib/specRouteCatalog.json +30 -0
  137. package/client/admin/src/lib/specScreens.json +22 -0
  138. package/client/admin/src/main.tsx +17 -0
  139. package/client/admin/src/pages/AdminDashboardPage.tsx +171 -0
  140. package/client/admin/src/pages/AdminLoginPage.tsx +75 -0
  141. package/client/admin/src/pages/AdminQueuePage.tsx +107 -0
  142. package/client/admin/src/pages/AdminSupportPage.tsx +61 -0
  143. package/client/admin/src/styles/globals.css +17 -0
  144. package/client/admin/src/theme-vars.ts +18 -0
  145. package/client/admin/src/theme.ts +25 -0
  146. package/client/admin/src/vite-env.d.ts +1 -0
  147. package/client/admin/tailwind.config.js +8 -0
  148. package/client/admin/tsconfig.json +25 -0
  149. package/client/admin/vite.config.ts +12 -0
  150. package/client/landing/.dockerignore +3 -0
  151. package/client/landing/.env.example +1 -0
  152. package/client/landing/Dockerfile +16 -0
  153. package/client/landing/Dockerfile.dev +18 -0
  154. package/client/landing/README.md +18 -0
  155. package/client/landing/index.html +12 -0
  156. package/client/landing/package.json +41 -0
  157. package/client/landing/postcss.config.js +6 -0
  158. package/client/landing/scripts/ui-parity-landing-adapter.mjs +65 -0
  159. package/client/landing/src/App.tsx +21 -0
  160. package/client/landing/src/api/catalog.ts +30 -0
  161. package/client/landing/src/api/client.ts +30 -0
  162. package/client/landing/src/auth/AuthProvider.tsx +122 -0
  163. package/client/landing/src/auth/ProtectedRoute.tsx +22 -0
  164. package/client/landing/src/auth/auth-client.ts +38 -0
  165. package/client/landing/src/auth/types.ts +18 -0
  166. package/client/landing/src/components/LandingShell.tsx +34 -0
  167. package/client/landing/src/lib/specRouteCatalog.json +23 -0
  168. package/client/landing/src/lib/specScreens.json +17 -0
  169. package/client/landing/src/main.tsx +17 -0
  170. package/client/landing/src/pages/LandingHomePage.tsx +215 -0
  171. package/client/landing/src/pages/LandingLoginPage.tsx +90 -0
  172. package/client/landing/src/pages/LandingWorkspacePage.tsx +126 -0
  173. package/client/landing/src/styles/globals.css +17 -0
  174. package/client/landing/src/theme-vars.ts +16 -0
  175. package/client/landing/src/theme.ts +21 -0
  176. package/client/landing/src/vite-env.d.ts +1 -0
  177. package/client/landing/tailwind.config.js +8 -0
  178. package/client/landing/tsconfig.json +25 -0
  179. package/client/landing/vite.config.ts +12 -0
  180. package/client/mobile/.dockerignore +2 -0
  181. package/client/mobile/.env.example +1 -0
  182. package/client/mobile/Dockerfile +16 -0
  183. package/client/mobile/Dockerfile.dev +18 -0
  184. package/client/mobile/README.md +19 -0
  185. package/client/mobile/index.html +12 -0
  186. package/client/mobile/package.json +42 -0
  187. package/client/mobile/postcss.config.js +6 -0
  188. package/client/mobile/scripts/ui-parity-mobile-adapter.mjs +67 -0
  189. package/client/mobile/src/App.tsx +1 -0
  190. package/client/mobile/src/api/client.ts +62 -0
  191. package/client/mobile/src/api/fulfillment.ts +55 -0
  192. package/client/mobile/src/api/shipping.ts +56 -0
  193. package/client/mobile/src/app/App.tsx +23 -0
  194. package/client/mobile/src/auth/AuthProvider.tsx +122 -0
  195. package/client/mobile/src/auth/ProtectedRoute.tsx +27 -0
  196. package/client/mobile/src/auth/auth-client.ts +38 -0
  197. package/client/mobile/src/auth/types.ts +18 -0
  198. package/client/mobile/src/components/InShell.tsx +74 -0
  199. package/client/mobile/src/components/ui/button.tsx +35 -0
  200. package/client/mobile/src/components/ui/card.tsx +15 -0
  201. package/client/mobile/src/components/ui/input.tsx +21 -0
  202. package/client/mobile/src/lib/cn.ts +6 -0
  203. package/client/mobile/src/lib/specRouteCatalog.json +26 -0
  204. package/client/mobile/src/lib/specScreens.json +22 -0
  205. package/client/mobile/src/lib/useSpeechRecognitionInput.ts +271 -0
  206. package/client/mobile/src/main.tsx +17 -0
  207. package/client/mobile/src/pages/DashboardPage.tsx +172 -0
  208. package/client/mobile/src/pages/FulfillmentPage.tsx +138 -0
  209. package/client/mobile/src/pages/LoginPage.tsx +74 -0
  210. package/client/mobile/src/pages/ShippingPage.tsx +338 -0
  211. package/client/mobile/src/styles/globals.css +23 -0
  212. package/client/mobile/src/theme-vars.ts +16 -0
  213. package/client/mobile/src/theme.ts +21 -0
  214. package/client/mobile/src/vite-env.d.ts +1 -0
  215. package/client/mobile/tailwind.config.js +8 -0
  216. package/client/mobile/tsconfig.json +25 -0
  217. package/client/mobile/vite.config.ts +12 -0
  218. package/client/platform/.dockerignore +3 -0
  219. package/client/platform/.env.example +1 -0
  220. package/client/platform/Dockerfile +16 -0
  221. package/client/platform/Dockerfile.dev +18 -0
  222. package/client/platform/README.md +47 -0
  223. package/client/platform/index.html +12 -0
  224. package/client/platform/package.json +42 -0
  225. package/client/platform/postcss.config.js +6 -0
  226. package/client/platform/scripts/ui-parity-platform-adapter.mjs +66 -0
  227. package/client/platform/src/api/client.ts +30 -0
  228. package/client/platform/src/api/orders.ts +42 -0
  229. package/client/platform/src/app/App.tsx +21 -0
  230. package/client/platform/src/auth/AuthProvider.tsx +122 -0
  231. package/client/platform/src/auth/ProtectedRoute.tsx +22 -0
  232. package/client/platform/src/auth/auth-client.ts +38 -0
  233. package/client/platform/src/auth/types.ts +18 -0
  234. package/client/platform/src/components/AppShell.tsx +59 -0
  235. package/client/platform/src/components/ui/button.tsx +35 -0
  236. package/client/platform/src/components/ui/card.tsx +7 -0
  237. package/client/platform/src/components/ui/input.tsx +21 -0
  238. package/client/platform/src/lib/cn.ts +6 -0
  239. package/client/platform/src/lib/specRouteCatalog.json +23 -0
  240. package/client/platform/src/lib/specScreens.json +17 -0
  241. package/client/platform/src/main.tsx +17 -0
  242. package/client/platform/src/pages/DashboardPage.tsx +158 -0
  243. package/client/platform/src/pages/LoginPage.tsx +72 -0
  244. package/client/platform/src/pages/OrdersPage.tsx +123 -0
  245. package/client/platform/src/styles/globals.css +17 -0
  246. package/client/platform/src/theme-vars.ts +18 -0
  247. package/client/platform/src/theme.ts +25 -0
  248. package/client/platform/src/vite-env.d.ts +1 -0
  249. package/client/platform/tailwind.config.js +8 -0
  250. package/client/platform/tsconfig.json +25 -0
  251. package/client/platform/vite.config.ts +12 -0
  252. package/compose.yml +206 -0
  253. package/infra/compose/.env.dev.example +28 -0
  254. package/infra/compose/.env.prod.example +29 -0
  255. package/infra/compose/README.md +35 -0
  256. package/infra/compose/dev.yml +125 -0
  257. package/infra/compose/prod.yml +126 -0
  258. package/infra/terraform/README.md +34 -0
  259. package/infra/terraform/aws/data/.terraform.lock.hcl +25 -0
  260. package/infra/terraform/aws/data/README.md +18 -0
  261. package/infra/terraform/aws/data/main.tf +147 -0
  262. package/infra/terraform/aws/data/outputs.tf +14 -0
  263. package/infra/terraform/aws/data/variables.tf +57 -0
  264. package/infra/terraform/aws/data/versions.tf +10 -0
  265. package/infra/terraform/aws/domain/.terraform.lock.hcl +25 -0
  266. package/infra/terraform/aws/domain/README.md +20 -0
  267. package/infra/terraform/aws/domain/env/dev.tfvars.example +6 -0
  268. package/infra/terraform/aws/domain/env/prod.tfvars.example +7 -0
  269. package/infra/terraform/aws/domain/main.tf +149 -0
  270. package/infra/terraform/aws/domain/outputs.tf +29 -0
  271. package/infra/terraform/aws/domain/variables.tf +58 -0
  272. package/infra/terraform/aws/domain/versions.tf +10 -0
  273. package/infra/terraform/openstack/README.md +38 -0
  274. package/infra/terraform/openstack/dev/.terraform.lock.hcl +24 -0
  275. package/infra/terraform/openstack/dev/README.md +18 -0
  276. package/infra/terraform/openstack/dev/main.tf +49 -0
  277. package/infra/terraform/openstack/dev/providers.tf +15 -0
  278. package/infra/terraform/openstack/dev/terraform.tfvars.example +54 -0
  279. package/infra/terraform/openstack/dev/variables.tf +210 -0
  280. package/infra/terraform/openstack/dev/versions.tf +10 -0
  281. package/infra/terraform/openstack/modules/environment_host/main.tf +143 -0
  282. package/infra/terraform/openstack/modules/environment_host/outputs.tf +25 -0
  283. package/infra/terraform/openstack/modules/environment_host/templates/docker-host-user-data.sh.tftpl +40 -0
  284. package/infra/terraform/openstack/modules/environment_host/variables.tf +145 -0
  285. package/infra/terraform/openstack/modules/environment_host/versions.tf +7 -0
  286. package/infra/terraform/openstack/prod/.terraform.lock.hcl +24 -0
  287. package/infra/terraform/openstack/prod/README.md +18 -0
  288. package/infra/terraform/openstack/prod/main.tf +49 -0
  289. package/infra/terraform/openstack/prod/providers.tf +15 -0
  290. package/infra/terraform/openstack/prod/terraform.tfvars.example +55 -0
  291. package/infra/terraform/openstack/prod/variables.tf +210 -0
  292. package/infra/terraform/openstack/prod/versions.tf +10 -0
  293. package/infra/terraform/openstack/server/.terraform.lock.hcl +45 -0
  294. package/infra/terraform/openstack/server/README.md +47 -0
  295. package/infra/terraform/openstack/server/main.tf +161 -0
  296. package/infra/terraform/openstack/server/outputs.tf +30 -0
  297. package/infra/terraform/openstack/server/providers.tf +30 -0
  298. package/infra/terraform/openstack/server/templates/server-user-data.sh.tftpl +50 -0
  299. package/infra/terraform/openstack/server/variables.tf +233 -0
  300. package/infra/terraform/openstack/server/zz_aspace.auto.tfvars.example.json +29 -0
  301. package/lib/scaffold.mjs +373 -0
  302. package/package.json +33 -12
  303. package/pnpm-workspace.yaml +2 -0
  304. package/scripts/dev/audit_sdd_build_ast.py +277 -0
  305. package/sdd/01_planning/01_feature/INDEX.md +16 -0
  306. package/sdd/01_planning/01_feature/README.md +76 -0
  307. package/sdd/01_planning/01_feature/alerts_feature_spec.md +55 -0
  308. package/sdd/01_planning/01_feature/auth_feature_spec.md +57 -0
  309. package/sdd/01_planning/01_feature/catalog_feature_spec.md +61 -0
  310. package/sdd/01_planning/01_feature/fulfillment_feature_spec.md +58 -0
  311. package/sdd/01_planning/01_feature/health_feature_spec.md +52 -0
  312. package/sdd/01_planning/01_feature/inventory_feature_spec.md +60 -0
  313. package/sdd/01_planning/01_feature/order_feature_spec.md +63 -0
  314. package/sdd/01_planning/01_feature/shipping_feature_spec.md +55 -0
  315. package/sdd/01_planning/01_feature/support_feature_spec.md +53 -0
  316. package/sdd/01_planning/01_feature/user_feature_spec.md +54 -0
  317. package/sdd/01_planning/02_screen/INDEX.md +13 -0
  318. package/sdd/01_planning/02_screen/README.md +41 -0
  319. package/sdd/01_planning/02_screen/admin_screen_spec.pdf +0 -0
  320. package/sdd/01_planning/02_screen/assets/README.md +16 -0
  321. package/sdd/01_planning/02_screen/assets/example/README.md +13 -0
  322. package/sdd/01_planning/02_screen/landing_screen_spec.pdf +0 -0
  323. package/sdd/01_planning/02_screen/mobile_screen_spec.pdf +0 -0
  324. package/sdd/01_planning/02_screen/platform_screen_spec.pdf +0 -0
  325. package/sdd/01_planning/03_architecture/INDEX.md +9 -0
  326. package/sdd/01_planning/03_architecture/README.md +25 -0
  327. package/sdd/01_planning/03_architecture/architecture_document_structure.md +77 -0
  328. package/sdd/01_planning/03_architecture/backend/README.md +10 -0
  329. package/sdd/01_planning/03_architecture/frontend/README.md +12 -0
  330. package/sdd/01_planning/03_architecture/infra/README.md +10 -0
  331. package/sdd/01_planning/03_architecture/tech-research/README.md +4 -0
  332. package/sdd/01_planning/03_architecture/templates_system_architecture.md +84 -0
  333. package/sdd/01_planning/04_data/INDEX.md +4 -0
  334. package/sdd/01_planning/04_data/README.md +10 -0
  335. package/sdd/01_planning/04_data/templates_data_modeling.md +119 -0
  336. package/sdd/01_planning/05_api/README.md +12 -0
  337. package/sdd/01_planning/05_api/templates_api_contract.md +90 -0
  338. package/sdd/01_planning/06_iac/README.md +11 -0
  339. package/sdd/01_planning/06_iac/templates_runtime_and_cicd_baseline.md +46 -0
  340. package/sdd/01_planning/07_integration/README.md +11 -0
  341. package/sdd/01_planning/07_integration/templates_frontend_api_integration.md +46 -0
  342. package/sdd/01_planning/08_nonfunctional/README.md +7 -0
  343. package/sdd/01_planning/09_security/README.md +7 -0
  344. package/sdd/01_planning/10_test/README.md +12 -0
  345. package/sdd/01_planning/10_test/templates_test_strategy.md +60 -0
  346. package/sdd/01_planning/INDEX.md +19 -0
  347. package/sdd/01_planning/README.md +17 -0
  348. package/sdd/02_plan/01_feature/README.md +34 -0
  349. package/sdd/02_plan/01_feature/_feature_todo_template.md +29 -0
  350. package/sdd/02_plan/02_screen/INDEX.md +19 -0
  351. package/sdd/02_plan/02_screen/README.md +39 -0
  352. package/sdd/02_plan/02_screen/_screen_todo_template.md +60 -0
  353. package/sdd/02_plan/03_architecture/README.md +23 -0
  354. package/sdd/02_plan/03_architecture/architecture_document_governance.md +40 -0
  355. package/sdd/02_plan/03_architecture/build_ast_runtime_tree_governance.md +53 -0
  356. package/sdd/02_plan/03_architecture/repository_governance.md +39 -0
  357. package/sdd/02_plan/03_architecture/runtime_and_structure_governance.md +38 -0
  358. package/sdd/02_plan/03_architecture/templates-hexagonal-template-architecture.md +9 -0
  359. package/sdd/02_plan/03_architecture/toolchain_governance.md +98 -0
  360. package/sdd/02_plan/04_data/README.md +5 -0
  361. package/sdd/02_plan/05_api/README.md +5 -0
  362. package/sdd/02_plan/06_iac/README.md +11 -0
  363. package/sdd/02_plan/06_iac/dev_runtime_delivery.md +36 -0
  364. package/sdd/02_plan/06_iac/template_runtime_delivery.md +50 -0
  365. package/sdd/02_plan/07_integration/README.md +5 -0
  366. package/sdd/02_plan/07_integration/frontend_live_integration.md +31 -0
  367. package/sdd/02_plan/08_nonfunctional/README.md +5 -0
  368. package/sdd/02_plan/08_nonfunctional/repository_hygiene.md +26 -0
  369. package/sdd/02_plan/09_security/README.md +5 -0
  370. package/sdd/02_plan/10_test/README.md +11 -0
  371. package/sdd/02_plan/10_test/regression_verification.md +39 -0
  372. package/sdd/02_plan/10_test/templates/README.md +8 -0
  373. package/sdd/02_plan/10_test/templates/ui_parity_platform_contract.template.yaml +23 -0
  374. package/sdd/02_plan/10_test/verification_strategy.md +43 -0
  375. package/sdd/02_plan/99_generated/from_planning/ui_parity/.gitkeep +1 -0
  376. package/sdd/02_plan/README.md +40 -0
  377. package/sdd/03_build/01_feature/README.md +20 -0
  378. package/sdd/03_build/01_feature/domain/README.md +3 -0
  379. package/sdd/03_build/01_feature/domain/account_and_access.md +20 -0
  380. package/sdd/03_build/01_feature/domain/catalog_and_inventory.md +20 -0
  381. package/sdd/03_build/01_feature/domain/ordering_and_fulfillment.md +21 -0
  382. package/sdd/03_build/01_feature/domain/support_and_observability.md +21 -0
  383. package/sdd/03_build/01_feature/domain_surfaces.md +28 -0
  384. package/sdd/03_build/01_feature/service/README.md +3 -0
  385. package/sdd/03_build/01_feature/service/admin_surface.md +15 -0
  386. package/sdd/03_build/01_feature/service/landing_surface.md +13 -0
  387. package/sdd/03_build/01_feature/service/mobile_surface.md +14 -0
  388. package/sdd/03_build/01_feature/service/platform_surface.md +14 -0
  389. package/sdd/03_build/02_screen/README.md +25 -0
  390. package/sdd/03_build/02_screen/_screen_build_template.md +26 -0
  391. package/sdd/03_build/02_screen/admin/README.md +5 -0
  392. package/sdd/03_build/02_screen/landing/README.md +5 -0
  393. package/sdd/03_build/02_screen/mobile/README.md +5 -0
  394. package/sdd/03_build/02_screen/platform/README.md +5 -0
  395. package/sdd/03_build/03_architecture/README.md +10 -0
  396. package/sdd/03_build/03_architecture/architecture_document_governance.md +30 -0
  397. package/sdd/03_build/03_architecture/build_ast_runtime_tree_governance.md +24 -0
  398. package/sdd/03_build/03_architecture/repository_governance.md +18 -0
  399. package/sdd/03_build/03_architecture/toolchain_governance.md +36 -0
  400. package/sdd/03_build/06_iac/README.md +3 -0
  401. package/sdd/03_build/06_iac/dev_runtime_delivery.md +10 -0
  402. package/sdd/03_build/06_iac/template_runtime_delivery.md +49 -0
  403. package/sdd/03_build/07_integration/README.md +3 -0
  404. package/sdd/03_build/07_integration/frontend_live_integration.md +11 -0
  405. package/sdd/03_build/08_nonfunctional/README.md +3 -0
  406. package/sdd/03_build/08_nonfunctional/repository_hygiene.md +10 -0
  407. package/sdd/03_build/10_test/README.md +9 -0
  408. package/sdd/03_build/10_test/regression_verification.md +16 -0
  409. package/sdd/03_build/10_test/verification_harness.md +11 -0
  410. package/sdd/03_build/README.md +35 -0
  411. package/sdd/04_verify/01_feature/README.md +5 -0
  412. package/sdd/04_verify/01_feature/domain_verification.md +14 -0
  413. package/sdd/04_verify/01_feature/service_verification.md +22 -0
  414. package/sdd/04_verify/02_screen/README.md +6 -0
  415. package/sdd/04_verify/02_screen/_screen_verify_template.md +20 -0
  416. package/sdd/04_verify/02_screen/admin/README.md +4 -0
  417. package/sdd/04_verify/02_screen/landing/README.md +4 -0
  418. package/sdd/04_verify/02_screen/mobile/README.md +4 -0
  419. package/sdd/04_verify/02_screen/platform/README.md +4 -0
  420. package/sdd/04_verify/03_architecture/README.md +10 -0
  421. package/sdd/04_verify/03_architecture/architecture_document_governance.md +15 -0
  422. package/sdd/04_verify/03_architecture/build_ast_runtime_tree_governance.md +28 -0
  423. package/sdd/04_verify/03_architecture/repository_governance.md +16 -0
  424. package/sdd/04_verify/03_architecture/toolchain_governance.md +58 -0
  425. package/sdd/04_verify/06_iac/README.md +3 -0
  426. package/sdd/04_verify/06_iac/dev_runtime_delivery.md +10 -0
  427. package/sdd/04_verify/06_iac/template_runtime_delivery.md +42 -0
  428. package/sdd/04_verify/07_integration/README.md +3 -0
  429. package/sdd/04_verify/07_integration/frontend_live_integration.md +16 -0
  430. package/sdd/04_verify/08_nonfunctional/README.md +3 -0
  431. package/sdd/04_verify/08_nonfunctional/repository_hygiene.md +14 -0
  432. package/sdd/04_verify/10_test/README.md +9 -0
  433. package/sdd/04_verify/10_test/regression_verification.md +16 -0
  434. package/sdd/04_verify/10_test/ui_parity/README.md +4 -0
  435. package/sdd/04_verify/10_test/ui_parity/loop_runs/.gitkeep +0 -0
  436. package/sdd/04_verify/10_test/ui_parity/reference/.gitkeep +0 -0
  437. package/sdd/04_verify/10_test/ui_parity/staged_runs/.gitkeep +0 -0
  438. package/sdd/04_verify/10_test/verification_harness.md +17 -0
  439. package/sdd/04_verify/README.md +22 -0
  440. package/sdd/05_operate/01_runbooks/.gitkeep +1 -0
  441. package/sdd/05_operate/01_runbooks/README.md +4 -0
  442. package/sdd/05_operate/02_delivery_status/README.md +4 -0
  443. package/sdd/05_operate/02_delivery_status/service_status.md +16 -0
  444. package/sdd/05_operate/README.md +12 -0
  445. package/sdd/99_toolchain/01_automation/.gitkeep +1 -0
  446. package/sdd/99_toolchain/01_automation/README.md +76 -0
  447. package/sdd/99_toolchain/01_automation/agentic-dev/analyze_proof_results.py +132 -0
  448. package/sdd/99_toolchain/01_automation/agentic-dev/analyze_route_gap.py +85 -0
  449. package/sdd/99_toolchain/01_automation/agentic-dev/assets/repo-contract.template.json +75 -0
  450. package/sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh +84 -0
  451. package/sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh +33 -0
  452. package/sdd/99_toolchain/01_automation/agentic-dev/init_repo_contract.sh +51 -0
  453. package/sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json +76 -0
  454. package/sdd/99_toolchain/01_automation/agentic-dev/resolve_frontend_target.py +52 -0
  455. package/sdd/99_toolchain/01_automation/agentic-dev/resolve_repo_contract.py +56 -0
  456. package/sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh +100 -0
  457. package/sdd/99_toolchain/01_automation/agentic-dev/run_repo_phase.sh +140 -0
  458. package/sdd/99_toolchain/01_automation/agentic-dev/validate_json_schema.py +39 -0
  459. package/sdd/99_toolchain/01_automation/agentic-parity-harness-design.md +291 -0
  460. package/sdd/99_toolchain/01_automation/assets/admin_screen_capture/dashboard.png +0 -0
  461. package/sdd/99_toolchain/01_automation/assets/admin_screen_capture/login.png +0 -0
  462. package/sdd/99_toolchain/01_automation/assets/admin_screen_capture/queue.png +0 -0
  463. package/sdd/99_toolchain/01_automation/assets/admin_screen_capture/support.png +0 -0
  464. package/sdd/99_toolchain/01_automation/assets/landing_screen_capture/home.png +0 -0
  465. package/sdd/99_toolchain/01_automation/assets/landing_screen_capture/login.png +0 -0
  466. package/sdd/99_toolchain/01_automation/assets/landing_screen_capture/workspace.png +0 -0
  467. package/sdd/99_toolchain/01_automation/assets/mobile_screen_capture/dashboard.png +0 -0
  468. package/sdd/99_toolchain/01_automation/assets/mobile_screen_capture/fulfillment.png +0 -0
  469. package/sdd/99_toolchain/01_automation/assets/mobile_screen_capture/login.png +0 -0
  470. package/sdd/99_toolchain/01_automation/assets/platform_screen_capture/dashboard.png +0 -0
  471. package/sdd/99_toolchain/01_automation/assets/platform_screen_capture/login.png +0 -0
  472. package/sdd/99_toolchain/01_automation/assets/platform_screen_capture/orders.png +0 -0
  473. package/sdd/99_toolchain/01_automation/build_asset_recipes.py +10 -0
  474. package/sdd/99_toolchain/01_automation/build_screen_spec_pdf.py +427 -0
  475. package/sdd/99_toolchain/01_automation/capture_screen_assets.mjs +148 -0
  476. package/sdd/99_toolchain/01_automation/harness-layout.md +34 -0
  477. package/sdd/99_toolchain/01_automation/parity-execution-tooling-design.md +319 -0
  478. package/sdd/99_toolchain/01_automation/playwright_exactness_manifest.py +21 -0
  479. package/sdd/99_toolchain/01_automation/run_playwright_exactness.py +87 -0
  480. package/sdd/99_toolchain/01_automation/screen_spec_manifest.py +321 -0
  481. package/sdd/99_toolchain/01_automation/spec_asset_builder.py +274 -0
  482. package/sdd/99_toolchain/01_automation/ui-contract-projection.md +79 -0
  483. package/sdd/99_toolchain/01_automation/ui-parity/README.md +60 -0
  484. package/sdd/99_toolchain/01_automation/ui-parity/cli/extract-reference-pages.mjs +2 -0
  485. package/sdd/99_toolchain/01_automation/ui-parity/cli/materialize-reference-assets.mjs +58 -0
  486. package/sdd/99_toolchain/01_automation/ui-parity/cli/normalize-reference-assets.mjs +2 -0
  487. package/sdd/99_toolchain/01_automation/ui-parity/cli/route-gap-report.mjs +187 -0
  488. package/sdd/99_toolchain/01_automation/ui-parity/cli/run-proof.mjs +50 -0
  489. package/sdd/99_toolchain/01_automation/ui-parity/cli/scaffold-contract.mjs +62 -0
  490. package/sdd/99_toolchain/01_automation/ui-parity/cli/upload-parity1.mjs +2 -0
  491. package/sdd/99_toolchain/01_automation/ui-parity/contracts/collector-metadata.schema.json +33 -0
  492. package/sdd/99_toolchain/01_automation/ui-parity/contracts/proof-result.schema.json +76 -0
  493. package/sdd/99_toolchain/01_automation/ui-parity/contracts/route-gap-report.schema.json +95 -0
  494. package/sdd/99_toolchain/01_automation/ui-parity/core/capture-runner.mjs +55 -0
  495. package/sdd/99_toolchain/01_automation/ui-parity/core/load-adapter.mjs +25 -0
  496. package/sdd/99_toolchain/01_automation/ui-parity/core/load-contract.mjs +81 -0
  497. package/sdd/99_toolchain/01_automation/ui-parity/core/paths.mjs +23 -0
  498. package/sdd/99_toolchain/01_automation/ui-parity/core/proof-runner.mjs +255 -0
  499. package/sdd/99_toolchain/01_automation/ui-parity/interfaces/ui-parity-artifact-layout.md +23 -0
  500. package/sdd/99_toolchain/01_automation/ui-parity/interfaces/ui-parity-proof-interface.md +60 -0
  501. package/sdd/99_toolchain/01_automation/ui-parity/interfaces/ui-parity-route-gap-interface.md +82 -0
  502. package/sdd/99_toolchain/01_automation/ui-parity/runtime/playwright-runtime.mjs +16 -0
  503. package/sdd/99_toolchain/01_automation/ui-parity/runtime/static-runtime.mjs +6 -0
  504. package/sdd/99_toolchain/02_policies/.gitkeep +1 -0
  505. package/sdd/99_toolchain/02_policies/build-ast-governance-policy.md +22 -0
  506. package/sdd/99_toolchain/02_policies/compose-runtime-baseline-policy.md +24 -0
  507. package/sdd/99_toolchain/02_policies/convention-storage-policy.md +26 -0
  508. package/sdd/99_toolchain/02_policies/main-push-before-dev-deploy-policy.md +27 -0
  509. package/sdd/99_toolchain/02_policies/otro-orchestration-policy.md +30 -0
  510. package/sdd/99_toolchain/02_policies/regression-verification-policy.md +22 -0
  511. package/sdd/99_toolchain/03_templates/.gitkeep +1 -0
  512. package/sdd/99_toolchain/03_templates/asset_recipe_manifest.example.py +38 -0
  513. package/sdd/99_toolchain/03_templates/generated_assets/README.md +11 -0
  514. package/sdd/99_toolchain/03_templates/generated_assets/example-brand-lockup.svg +3 -0
  515. package/sdd/99_toolchain/03_templates/generated_assets/example-brand-mark.svg +3 -0
  516. package/sdd/99_toolchain/03_templates/generated_assets/example-brand-wordmark.svg +3 -0
  517. package/sdd/99_toolchain/03_templates/playwright_exactness_manifest.example.py +21 -0
  518. package/sdd/99_toolchain/README.md +23 -0
  519. package/sdd/README.md +21 -0
  520. package/server/.dockerignore +4 -0
  521. package/server/.env.example +19 -0
  522. package/server/Dockerfile +22 -0
  523. package/server/Dockerfile.dev +19 -0
  524. package/server/README.md +33 -0
  525. package/server/__init__.py +0 -0
  526. package/server/api/__init__.py +1 -0
  527. package/server/api/http/__init__.py +4 -0
  528. package/server/api/http/app.py +53 -0
  529. package/server/api/http/router.py +24 -0
  530. package/server/config.py +52 -0
  531. package/server/contexts/__init__.py +12 -0
  532. package/server/contexts/alerts/__init__.py +1 -0
  533. package/server/contexts/alerts/application/__init__.py +13 -0
  534. package/server/contexts/alerts/application/services.py +41 -0
  535. package/server/contexts/alerts/contracts/__init__.py +3 -0
  536. package/server/contexts/alerts/contracts/http/__init__.py +3 -0
  537. package/server/contexts/alerts/contracts/http/router.py +37 -0
  538. package/server/contexts/alerts/domain/__init__.py +15 -0
  539. package/server/contexts/alerts/domain/models.py +29 -0
  540. package/server/contexts/alerts/infrastructure/__init__.py +11 -0
  541. package/server/contexts/alerts/infrastructure/repository.py +41 -0
  542. package/server/contexts/auth/__init__.py +1 -0
  543. package/server/contexts/auth/application/__init__.py +3 -0
  544. package/server/contexts/auth/application/ports.py +10 -0
  545. package/server/contexts/auth/application/services.py +64 -0
  546. package/server/contexts/auth/contracts/__init__.py +4 -0
  547. package/server/contexts/auth/contracts/http/__init__.py +4 -0
  548. package/server/contexts/auth/contracts/http/dependencies.py +37 -0
  549. package/server/contexts/auth/contracts/http/router.py +19 -0
  550. package/server/contexts/auth/domain/__init__.py +3 -0
  551. package/server/contexts/auth/domain/models.py +24 -0
  552. package/server/contexts/auth/infrastructure/__init__.py +4 -0
  553. package/server/contexts/auth/infrastructure/adapters/memory.py +19 -0
  554. package/server/contexts/auth/infrastructure/adapters/mongodb.py +24 -0
  555. package/server/contexts/auth/infrastructure/adapters/sqlalchemy.py +74 -0
  556. package/server/contexts/auth/infrastructure/repository.py +28 -0
  557. package/server/contexts/catalog/__init__.py +1 -0
  558. package/server/contexts/catalog/application/__init__.py +28 -0
  559. package/server/contexts/catalog/application/ports.py +15 -0
  560. package/server/contexts/catalog/application/services.py +154 -0
  561. package/server/contexts/catalog/contracts/__init__.py +3 -0
  562. package/server/contexts/catalog/contracts/http/__init__.py +3 -0
  563. package/server/contexts/catalog/contracts/http/router.py +60 -0
  564. package/server/contexts/catalog/domain/__init__.py +45 -0
  565. package/server/contexts/catalog/domain/models.py +113 -0
  566. package/server/contexts/catalog/infrastructure/__init__.py +4 -0
  567. package/server/contexts/catalog/infrastructure/adapters/memory.py +62 -0
  568. package/server/contexts/catalog/infrastructure/repository.py +8 -0
  569. package/server/contexts/fulfillment/__init__.py +1 -0
  570. package/server/contexts/fulfillment/application/__init__.py +13 -0
  571. package/server/contexts/fulfillment/application/ports.py +20 -0
  572. package/server/contexts/fulfillment/application/services.py +85 -0
  573. package/server/contexts/fulfillment/contracts/__init__.py +3 -0
  574. package/server/contexts/fulfillment/contracts/http/__init__.py +3 -0
  575. package/server/contexts/fulfillment/contracts/http/router.py +40 -0
  576. package/server/contexts/fulfillment/domain/__init__.py +25 -0
  577. package/server/contexts/fulfillment/domain/models.py +73 -0
  578. package/server/contexts/fulfillment/infrastructure/__init__.py +13 -0
  579. package/server/contexts/fulfillment/infrastructure/adapters/memory.py +43 -0
  580. package/server/contexts/fulfillment/infrastructure/repository.py +97 -0
  581. package/server/contexts/health/__init__.py +1 -0
  582. package/server/contexts/health/application/__init__.py +3 -0
  583. package/server/contexts/health/application/services.py +2 -0
  584. package/server/contexts/health/contracts/__init__.py +3 -0
  585. package/server/contexts/health/contracts/http/__init__.py +3 -0
  586. package/server/contexts/health/contracts/http/router.py +10 -0
  587. package/server/contexts/inventory/__init__.py +1 -0
  588. package/server/contexts/inventory/application/__init__.py +28 -0
  589. package/server/contexts/inventory/application/ports.py +11 -0
  590. package/server/contexts/inventory/application/services.py +214 -0
  591. package/server/contexts/inventory/contracts/__init__.py +3 -0
  592. package/server/contexts/inventory/contracts/http/__init__.py +3 -0
  593. package/server/contexts/inventory/contracts/http/router.py +82 -0
  594. package/server/contexts/inventory/domain/__init__.py +33 -0
  595. package/server/contexts/inventory/domain/models.py +93 -0
  596. package/server/contexts/inventory/infrastructure/__init__.py +4 -0
  597. package/server/contexts/inventory/infrastructure/adapters/memory.py +24 -0
  598. package/server/contexts/inventory/infrastructure/repository.py +8 -0
  599. package/server/contexts/orders/__init__.py +1 -0
  600. package/server/contexts/orders/application/__init__.py +19 -0
  601. package/server/contexts/orders/application/services.py +127 -0
  602. package/server/contexts/orders/contracts/__init__.py +3 -0
  603. package/server/contexts/orders/contracts/http/__init__.py +3 -0
  604. package/server/contexts/orders/contracts/http/router.py +82 -0
  605. package/server/contexts/orders/domain/__init__.py +29 -0
  606. package/server/contexts/orders/domain/models.py +95 -0
  607. package/server/contexts/orders/infrastructure/__init__.py +7 -0
  608. package/server/contexts/orders/infrastructure/repository.py +104 -0
  609. package/server/contexts/shipping/__init__.py +1 -0
  610. package/server/contexts/shipping/application/__init__.py +13 -0
  611. package/server/contexts/shipping/application/services.py +92 -0
  612. package/server/contexts/shipping/contracts/__init__.py +3 -0
  613. package/server/contexts/shipping/contracts/http/__init__.py +3 -0
  614. package/server/contexts/shipping/contracts/http/router.py +40 -0
  615. package/server/contexts/shipping/domain/__init__.py +19 -0
  616. package/server/contexts/shipping/domain/models.py +48 -0
  617. package/server/contexts/shipping/infrastructure/__init__.py +9 -0
  618. package/server/contexts/shipping/infrastructure/repository.py +50 -0
  619. package/server/contexts/support/__init__.py +1 -0
  620. package/server/contexts/support/application/__init__.py +13 -0
  621. package/server/contexts/support/application/services.py +29 -0
  622. package/server/contexts/support/contracts/__init__.py +3 -0
  623. package/server/contexts/support/contracts/http/__init__.py +3 -0
  624. package/server/contexts/support/contracts/http/router.py +40 -0
  625. package/server/contexts/support/domain/__init__.py +13 -0
  626. package/server/contexts/support/domain/models.py +27 -0
  627. package/server/contexts/support/infrastructure/__init__.py +11 -0
  628. package/server/contexts/support/infrastructure/repository.py +70 -0
  629. package/server/contexts/user/__init__.py +1 -0
  630. package/server/contexts/user/application/__init__.py +3 -0
  631. package/server/contexts/user/application/ports.py +11 -0
  632. package/server/contexts/user/application/services.py +44 -0
  633. package/server/contexts/user/contracts/__init__.py +3 -0
  634. package/server/contexts/user/contracts/http/__init__.py +3 -0
  635. package/server/contexts/user/contracts/http/router.py +26 -0
  636. package/server/contexts/user/domain/__init__.py +3 -0
  637. package/server/contexts/user/domain/models.py +22 -0
  638. package/server/contexts/user/infrastructure/__init__.py +3 -0
  639. package/server/contexts/user/infrastructure/adapters/memory.py +27 -0
  640. package/server/contexts/user/infrastructure/adapters/mongodb.py +41 -0
  641. package/server/contexts/user/infrastructure/adapters/sqlalchemy.py +94 -0
  642. package/server/contexts/user/infrastructure/factory.py +28 -0
  643. package/server/data/README.md +24 -0
  644. package/server/data/bootstrap/alerts.json +38 -0
  645. package/server/data/bootstrap/auth_accounts.json +18 -0
  646. package/server/data/bootstrap/catalog_products.json +179 -0
  647. package/server/data/bootstrap/fulfillment_events.json +5 -0
  648. package/server/data/bootstrap/fulfillment_notes.json +5 -0
  649. package/server/data/bootstrap/fulfillment_tasks.json +50 -0
  650. package/server/data/bootstrap/inventory_levels.json +80 -0
  651. package/server/data/bootstrap/orders.json +62 -0
  652. package/server/data/bootstrap/shipping_shipments.json +50 -0
  653. package/server/data/bootstrap/support_faqs.json +26 -0
  654. package/server/data/bootstrap/users.json +20 -0
  655. package/server/data/bootstrap_loader.py +15 -0
  656. package/server/docker-entrypoint.sh +56 -0
  657. package/server/main.py +3 -0
  658. package/server/pyproject.toml +36 -0
  659. package/server/shared/__init__.py +1 -0
  660. package/server/shared/application/__init__.py +3 -0
  661. package/server/shared/application/health.py +2 -0
  662. package/server/shared/infrastructure/__init__.py +10 -0
  663. package/server/shared/infrastructure/runtime.py +6 -0
  664. package/server/shared/infrastructure/security.py +33 -0
  665. package/server/tests/e2e/test_domain_feature_flows.py +483 -0
  666. package/server/tests/test_health.py +49 -0
  667. package/server/uv.lock +1169 -0
  668. package/bin/agentic-dev.js +0 -9
  669. package/src/cli.js +0 -37
  670. package/src/init-command.js +0 -230
  671. package/src/lib/command.js +0 -14
  672. package/src/lib/fs.js +0 -92
  673. package/src/lib/git.js +0 -57
  674. package/src/lib/github.js +0 -77
  675. package/src/lib/prompt.js +0 -52
  676. package/src/lib/system.js +0 -15
  677. package/src/lib/template.js +0 -143
package/client/admin/.dockerignore ADDED
@@ -0,0 +1,3 @@
1
+ node_modules
2
+ dist
3
+ .env
package/client/admin/.env.example ADDED
@@ -0,0 +1 @@
1
+ VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
package/client/admin/Dockerfile ADDED
@@ -0,0 +1,16 @@
1
+ FROM node:20-slim
2
+
3
+ WORKDIR /app
4
+
5
+ COPY pnpm-lock.yaml pnpm-workspace.yaml ./
6
+ COPY client/admin/package.json ./client/admin/package.json
7
+
8
+ RUN npm install -g pnpm@10.32.0 && pnpm install --filter @do4ai/client-admin-template...
9
+
10
+ COPY . .
11
+
12
+ WORKDIR /app/client/admin
13
+
14
+ EXPOSE 4000
15
+
16
+ CMD ["pnpm", "dev", "--host", "0.0.0.0", "--port", "4000"]
package/client/admin/Dockerfile.dev ADDED
@@ -0,0 +1,18 @@
1
+ FROM node:20-slim
2
+
3
+ WORKDIR /app
4
+
5
+ RUN npm install -g pnpm@10.32.0
6
+
7
+ COPY pnpm-lock.yaml pnpm-workspace.yaml ./
8
+ COPY client/admin/package.json ./client/admin/package.json
9
+
10
+ RUN pnpm install --frozen-lockfile --filter @do4ai/client-admin-template...
11
+
12
+ COPY client/admin ./client/admin
13
+
14
+ WORKDIR /app/client/admin
15
+
16
+ EXPOSE 4000
17
+
18
+ CMD ["sh", "-lc", "pnpm exec vite --host 0.0.0.0 --port ${PORT:-4000}"]
package/client/admin/README.md ADDED
@@ -0,0 +1,20 @@
1
+ # admin
2
+
3
+ 운영 콘솔형 관리자 UI 보일러플레이트다.
4
+
5
+ 포함 패턴:
6
+
7
+ - 좌측 sidebar + 상단 topbar
8
+ - route 이동 대신 열리는 알림 drawer
9
+ - 목록형 운영 테이블
10
+ - modal/drawer를 제품 shell에서 직접 제어하는 구조
11
+ - CSS variable 기반 parity-friendly token surface
12
+
13
+ 시작:
14
+
15
+ ```bash
16
+ npm install
17
+ npm run dev
18
+ ```
19
+
20
+ 기본 DEV 포트는 `4000`이다.
package/client/admin/index.html ADDED
@@ -0,0 +1,12 @@
1
+ <!doctype html>
2
+ <html lang="ko">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>client-admin template</title>
7
+ </head>
8
+ <body>
9
+ <div id="root"></div>
10
+ <script type="module" src="/src/main.tsx"></script>
11
+ </body>
12
+ </html>
package/client/admin/package.json ADDED
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "@do4ai/client-admin-template",
3
+ "private": true,
4
+ "version": "0.1.0",
5
+ "type": "module",
6
+ "packageManager": "pnpm@10.32.0",
7
+ "scripts": {
8
+ "dev": "vite --host 0.0.0.0 --port 4000",
9
+ "build": "tsc -b && vite build",
10
+ "preview": "vite preview --host 0.0.0.0 --port 4400",
11
+ "ui:parity:init": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh ../.. admin",
12
+ "ui:parity:bootstrap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh ../.. admin",
13
+ "ui:parity:scaffold": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh scaffold ../.. admin",
14
+ "ui:parity:materialize-references": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh materialize_references ../.. admin",
15
+ "ui:parity:route-gap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh route_gap ../.. admin",
16
+ "ui:parity:proof": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof ../.. admin"
17
+ },
18
+ "dependencies": {
19
+ "class-variance-authority": "^0.7.1",
20
+ "clsx": "^2.1.1",
21
+ "lucide-react": "^0.576.0",
22
+ "react": "^18.3.1",
23
+ "react-dom": "^18.3.1",
24
+ "react-router-dom": "^6.30.1",
25
+ "tailwind-merge": "^3.5.0"
26
+ },
27
+ "devDependencies": {
28
+ "@playwright/test": "^1.58.2",
29
+ "@types/react": "^18.3.18",
30
+ "@types/react-dom": "^18.3.5",
31
+ "@vitejs/plugin-react": "^4.7.0",
32
+ "autoprefixer": "^10.4.21",
33
+ "pixelmatch": "^7.1.0",
34
+ "pngjs": "^7.0.0",
35
+ "postcss": "^8.5.3",
36
+ "tailwindcss": "^3.4.17",
37
+ "typescript": "^5.8.3",
38
+ "vite": "^5.4.19",
39
+ "yaml": "^2.8.1"
40
+ }
41
+ }
package/client/admin/postcss.config.js ADDED
@@ -0,0 +1,6 @@
1
+ export default {
2
+ plugins: {
3
+ tailwindcss: {},
4
+ autoprefixer: {},
5
+ },
6
+ };
package/client/admin/scripts/ui-parity-admin-adapter.mjs ADDED
@@ -0,0 +1,65 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { fileURLToPath } from "node:url";
4
+
5
+ const scriptDir = path.dirname(fileURLToPath(import.meta.url));
6
+ const screens = JSON.parse(
7
+ fs.readFileSync(path.resolve(scriptDir, "../src/lib/specScreens.json"), "utf8"),
8
+ );
9
+ const routes = JSON.parse(
10
+ fs.readFileSync(path.resolve(scriptDir, "../src/lib/specRouteCatalog.json"), "utf8"),
11
+ );
12
+
13
+ const routeMap = new Map(routes.map((entry) => [entry.id, entry.route]));
14
+
15
+ export default {
16
+ service: "templates-admin",
17
+ targetBaseUrl: "http://127.0.0.1:4400",
18
+ viewport: {
19
+ width: 1440,
20
+ height: 1024,
21
+ },
22
+ screens: screens.map((screen) => ({
23
+ id: screen.id,
24
+ title: screen.title,
25
+ route: routeMap.get(screen.id) ?? "/",
26
+ referenceImage: `sdd/04_verify/10_test/ui_parity/reference/${screen.id}.png`,
27
+ readySelector: "body",
28
+ readyTimeoutMs: 10000,
29
+ tags: ["template", "admin"],
30
+ })),
31
+ async preparePage(page, { route }) {
32
+ await page.route("**/auth/me", async (routeRequest) => {
33
+ await routeRequest.fulfill({
34
+ status: 200,
35
+ contentType: "application/json",
36
+ body: JSON.stringify({
37
+ id: "tmpl-admin",
38
+ name: "Template Admin",
39
+ email: "admin@example.com",
40
+ role: "admin",
41
+ }),
42
+ });
43
+ });
44
+ await page.addInitScript(() => {
45
+ window.localStorage.setItem(
46
+ "admin.auth.token",
47
+ JSON.stringify({
48
+ access_token: "template-access-token",
49
+ token_type: "bearer",
50
+ }),
51
+ );
52
+ });
53
+ if (route === "/login") {
54
+ await page.addInitScript(() => {
55
+ window.localStorage.removeItem("admin.auth.token");
56
+ });
57
+ }
58
+ },
59
+ async waitForReady(page) {
60
+ await page.waitForLoadState("networkidle");
61
+ },
62
+ async resolveMaskRects() {
63
+ return [];
64
+ },
65
+ };
package/client/admin/src/api/alerts.ts ADDED
@@ -0,0 +1,33 @@
1
+ import { apiGet, apiPost } from "@/api/client";
2
+
3
+ export interface AlertItem {
4
+ id: string;
5
+ source: string;
6
+ title: string;
7
+ message: string;
8
+ tone: string;
9
+ created_at: string;
10
+ read: boolean;
11
+ }
12
+
13
+ export interface AlertsPayload {
14
+ unread_count: number;
15
+ items: AlertItem[];
16
+ }
17
+
18
+ export interface AlertsReadAllResult {
19
+ updated_count: number;
20
+ unread_count: number;
21
+ }
22
+
23
+ export function fetchAlerts(accessToken: string) {
24
+ return apiGet<AlertsPayload>("/alerts", { accessToken });
25
+ }
26
+
27
+ export function markAlertRead(alertId: string, accessToken: string) {
28
+ return apiPost<AlertItem>(`/alerts/${alertId}/read`, { accessToken });
29
+ }
30
+
31
+ export function markAllAlertsRead(accessToken: string) {
32
+ return apiPost<AlertsReadAllResult>("/alerts/read-all", { accessToken });
33
+ }
package/client/admin/src/api/client.ts ADDED
@@ -0,0 +1,71 @@
1
+ const API_BASE_URL =
2
+ (import.meta.env.VITE_API_BASE_URL as string | undefined)?.replace(/\/$/, "") ??
3
+ "";
4
+
5
+ interface RequestOptions {
6
+ accessToken?: string;
7
+ }
8
+
9
+ interface WriteOptions extends RequestOptions {
10
+ body?: unknown;
11
+ }
12
+
13
+ async function readJson<T>(response: Response): Promise<T> {
14
+ if (!response.ok) {
15
+ let message = "Request failed";
16
+ try {
17
+ const data = (await response.json()) as { detail?: string };
18
+ if (typeof data.detail === "string" && data.detail.length > 0) {
19
+ message = data.detail;
20
+ }
21
+ } catch {
22
+ message = response.statusText || message;
23
+ }
24
+ throw new Error(message);
25
+ }
26
+
27
+ return (await response.json()) as T;
28
+ }
29
+
30
+ export async function apiGet<T>(
31
+ path: string,
32
+ options?: RequestOptions,
33
+ ): Promise<T> {
34
+ const response = await fetch(`${API_BASE_URL}${path}`, {
35
+ headers: options?.accessToken
36
+ ? { Authorization: `Bearer ${options.accessToken}` }
37
+ : undefined,
38
+ });
39
+
40
+ return readJson<T>(response);
41
+ }
42
+
43
+ async function writeJson<T>(
44
+ method: "POST" | "PATCH",
45
+ path: string,
46
+ options?: WriteOptions,
47
+ ): Promise<T> {
48
+ const headers: Record<string, string> = {
49
+ "Content-Type": "application/json",
50
+ };
51
+
52
+ if (options?.accessToken) {
53
+ headers.Authorization = `Bearer ${options.accessToken}`;
54
+ }
55
+
56
+ const response = await fetch(`${API_BASE_URL}${path}`, {
57
+ method,
58
+ headers,
59
+ body: JSON.stringify(options?.body ?? {}),
60
+ });
61
+
62
+ return readJson<T>(response);
63
+ }
64
+
65
+ export function apiPost<T>(path: string, options?: WriteOptions): Promise<T> {
66
+ return writeJson("POST", path, options);
67
+ }
68
+
69
+ export function apiPatch<T>(path: string, options?: WriteOptions): Promise<T> {
70
+ return writeJson("PATCH", path, options);
71
+ }
package/client/admin/src/api/orders.ts ADDED
@@ -0,0 +1,33 @@
1
+ import { apiGet } from "@/api/client";
2
+
3
+ export interface DashboardCard {
4
+ label: string;
5
+ value: string;
6
+ tone?: string | null;
7
+ }
8
+
9
+ export interface StageStatus {
10
+ label: string;
11
+ value: string;
12
+ }
13
+
14
+ export interface AdminOverviewResponse {
15
+ cards: DashboardCard[];
16
+ stage_statuses: StageStatus[];
17
+ }
18
+
19
+ export interface AdminQueueItem {
20
+ order_id: string;
21
+ product_name: string;
22
+ customer_name: string;
23
+ status: string;
24
+ sla: string;
25
+ }
26
+
27
+ export function fetchAdminOverview(accessToken: string) {
28
+ return apiGet<AdminOverviewResponse>("/orders/admin/overview", { accessToken });
29
+ }
30
+
31
+ export function fetchAdminQueue(accessToken: string) {
32
+ return apiGet<AdminQueueItem[]>("/orders/admin/queue", { accessToken });
33
+ }
package/client/admin/src/api/support.ts ADDED
@@ -0,0 +1,11 @@
1
+ import { apiGet } from "@/api/client";
2
+
3
+ export interface SupportFaq {
4
+ id: string;
5
+ question: string;
6
+ visibility: string;
7
+ }
8
+
9
+ export function fetchSupportFaqs(accessToken: string) {
10
+ return apiGet<SupportFaq[]>("/support/faqs", { accessToken });
11
+ }
package/client/admin/src/app/App.tsx ADDED
@@ -0,0 +1,23 @@
1
+ import { Route, Routes } from "react-router-dom";
2
+
3
+ import { ProtectedRoute } from "@/auth/ProtectedRoute";
4
+ import { AdminShell } from "@/components/AdminShell";
5
+ import { AdminDashboardPage } from "@/pages/AdminDashboardPage";
6
+ import { AdminLoginPage } from "@/pages/AdminLoginPage";
7
+ import { AdminQueuePage } from "@/pages/AdminQueuePage";
8
+ import { AdminSupportPage } from "@/pages/AdminSupportPage";
9
+
10
+ export function App() {
11
+ return (
12
+ <Routes>
13
+ <Route path="/login" element={<AdminLoginPage />} />
14
+ <Route element={<ProtectedRoute />}>
15
+ <Route element={<AdminShell />}>
16
+ <Route path="/" element={<AdminDashboardPage />} />
17
+ <Route path="/queue" element={<AdminQueuePage />} />
18
+ <Route path="/support" element={<AdminSupportPage />} />
19
+ </Route>
20
+ </Route>
21
+ </Routes>
22
+ );
23
+ }
package/client/admin/src/auth/AuthProvider.tsx ADDED
@@ -0,0 +1,122 @@
1
+ import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from "react";
2
+
3
+ import { getMe, login as loginRequest } from "@/auth/auth-client";
4
+ import type { AuthToken, AuthUser, LoginCommand } from "@/auth/types";
5
+
6
+ const STORAGE_KEY = "admin.auth.token";
7
+
8
+ interface AuthContextValue {
9
+ user: AuthUser | null;
10
+ token: AuthToken | null;
11
+ initializing: boolean;
12
+ authenticating: boolean;
13
+ login: (command: LoginCommand) => Promise<void>;
14
+ logout: () => void;
15
+ }
16
+
17
+ const AuthContext = createContext<AuthContextValue | undefined>(undefined);
18
+
19
+ function readStoredToken(): AuthToken | null {
20
+ const raw = window.localStorage.getItem(STORAGE_KEY);
21
+ if (!raw) {
22
+ return null;
23
+ }
24
+
25
+ try {
26
+ return JSON.parse(raw) as AuthToken;
27
+ } catch {
28
+ window.localStorage.removeItem(STORAGE_KEY);
29
+ return null;
30
+ }
31
+ }
32
+
33
+ function storeToken(token: AuthToken | null) {
34
+ if (token) {
35
+ window.localStorage.setItem(STORAGE_KEY, JSON.stringify(token));
36
+ return;
37
+ }
38
+
39
+ window.localStorage.removeItem(STORAGE_KEY);
40
+ }
41
+
42
+ export function AuthProvider({ children }: { children: ReactNode }) {
43
+ const [token, setToken] = useState<AuthToken | null>(() => readStoredToken());
44
+ const [user, setUser] = useState<AuthUser | null>(null);
45
+ const [initializing, setInitializing] = useState(true);
46
+ const [authenticating, setAuthenticating] = useState(false);
47
+
48
+ useEffect(() => {
49
+ let cancelled = false;
50
+
51
+ async function bootstrap() {
52
+ if (!token) {
53
+ setUser(null);
54
+ setInitializing(false);
55
+ return;
56
+ }
57
+
58
+ try {
59
+ const currentUser = await getMe(token.access_token);
60
+ if (!cancelled) {
61
+ setUser(currentUser);
62
+ }
63
+ } catch {
64
+ if (!cancelled) {
65
+ setToken(null);
66
+ setUser(null);
67
+ storeToken(null);
68
+ }
69
+ } finally {
70
+ if (!cancelled) {
71
+ setInitializing(false);
72
+ }
73
+ }
74
+ }
75
+
76
+ void bootstrap();
77
+
78
+ return () => {
79
+ cancelled = true;
80
+ };
81
+ }, [token]);
82
+
83
+ const value = useMemo<AuthContextValue>(
84
+ () => ({
85
+ user,
86
+ token,
87
+ initializing,
88
+ authenticating,
89
+ async login(command) {
90
+ setAuthenticating(true);
91
+ try {
92
+ const nextToken = await loginRequest(command);
93
+ storeToken(nextToken);
94
+ setToken(nextToken);
95
+ const currentUser = await getMe(nextToken.access_token);
96
+ setUser(currentUser);
97
+ } finally {
98
+ setAuthenticating(false);
99
+ setInitializing(false);
100
+ }
101
+ },
102
+ logout() {
103
+ storeToken(null);
104
+ setToken(null);
105
+ setUser(null);
106
+ setInitializing(false);
107
+ },
108
+ }),
109
+ [authenticating, initializing, token, user],
110
+ );
111
+
112
+ return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
113
+ }
114
+
115
+ export function useAuth() {
116
+ const context = useContext(AuthContext);
117
+ if (!context) {
118
+ throw new Error("useAuth must be used within an AuthProvider");
119
+ }
120
+
121
+ return context;
122
+ }
package/client/admin/src/auth/ProtectedRoute.tsx ADDED
@@ -0,0 +1,22 @@
1
+ import { Navigate, Outlet, useLocation } from "react-router-dom";
2
+
3
+ import { useAuth } from "@/auth/AuthProvider";
4
+
5
+ export function ProtectedRoute() {
6
+ const { initializing, user } = useAuth();
7
+ const location = useLocation();
8
+
9
+ if (initializing) {
10
+ return (
11
+ <div className="flex min-h-screen items-center justify-center bg-[var(--admin-shell-bg)] text-sm font-medium text-[#5d6879]">
12
+ 관리자 세션을 확인하는 중입니다.
13
+ </div>
14
+ );
15
+ }
16
+
17
+ if (!user) {
18
+ return <Navigate to="/login" replace state={{ from: location }} />;
19
+ }
20
+
21
+ return <Outlet />;
22
+ }
package/client/admin/src/auth/auth-client.ts ADDED
@@ -0,0 +1,38 @@
1
+ import type { AuthToken, AuthUser, LoginCommand } from "@/auth/types";
2
+
3
+ const API_BASE_URL = (import.meta.env.VITE_API_BASE_URL as string | undefined)?.replace(/\/$/, "") ?? "";
4
+
5
+ async function readJson<T>(response: Response): Promise<T> {
6
+ if (!response.ok) {
7
+ let message = "Request failed";
8
+ try {
9
+ const data = (await response.json()) as { detail?: string };
10
+ if (typeof data.detail === "string" && data.detail.length > 0) {
11
+ message = data.detail;
12
+ }
13
+ } catch {
14
+ message = response.statusText || message;
15
+ }
16
+ throw new Error(message);
17
+ }
18
+
19
+ return (await response.json()) as T;
20
+ }
21
+
22
+ export async function login(command: LoginCommand): Promise<AuthToken> {
23
+ const response = await fetch(`${API_BASE_URL}/auth/login`, {
24
+ method: "POST",
25
+ headers: { "Content-Type": "application/json" },
26
+ body: JSON.stringify(command),
27
+ });
28
+
29
+ return readJson<AuthToken>(response);
30
+ }
31
+
32
+ export async function getMe(accessToken: string): Promise<AuthUser> {
33
+ const response = await fetch(`${API_BASE_URL}/auth/me`, {
34
+ headers: { Authorization: `Bearer ${accessToken}` },
35
+ });
36
+
37
+ return readJson<AuthUser>(response);
38
+ }
package/client/admin/src/auth/types.ts ADDED
@@ -0,0 +1,18 @@
1
+ export interface AuthToken {
2
+ access_token: string;
3
+ token_type: string;
4
+ user_id: string;
5
+ }
6
+
7
+ export interface AuthUser {
8
+ id: string;
9
+ name: string;
10
+ email: string;
11
+ role: string;
12
+ status: string;
13
+ }
14
+
15
+ export interface LoginCommand {
16
+ email: string;
17
+ password: string;
18
+ }