aios-core 2.1.5 → 2.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 (392) hide show
  1. package/.aios-core/core/README.md +229 -229
  2. package/.aios-core/core/data/agent-config-requirements.yaml +368 -368
  3. package/.aios-core/core/data/aios-kb.md +923 -923
  4. package/.aios-core/core/data/workflow-patterns.yaml +267 -267
  5. package/.aios-core/core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  6. package/.aios-core/core/docs/component-creation-guide.md +457 -457
  7. package/.aios-core/core/docs/session-update-pattern.md +307 -307
  8. package/.aios-core/core/docs/template-syntax.md +266 -266
  9. package/.aios-core/core/docs/troubleshooting-guide.md +624 -624
  10. package/.aios-core/core/elicitation/elicitation-engine.js +1 -1
  11. package/.aios-core/core/index.esm.js +42 -42
  12. package/.aios-core/core/index.js +1 -1
  13. package/.aios-core/core/migration/migration-config.yaml +83 -83
  14. package/.aios-core/core/migration/module-mapping.yaml +89 -89
  15. package/.aios-core/core/quality-gates/layer2-pr-automation.js +1 -1
  16. package/.aios-core/core/quality-gates/quality-gate-config.yaml +86 -86
  17. package/.aios-core/core/registry/README.md +179 -179
  18. package/.aios-core/core/utils/security-utils.js +1 -1
  19. package/.aios-core/core-config.yaml +391 -382
  20. package/.aios-core/data/agent-config-requirements.yaml +368 -368
  21. package/.aios-core/data/aios-kb.md +923 -923
  22. package/.aios-core/data/technical-preferences.md +3 -3
  23. package/.aios-core/data/workflow-patterns.yaml +267 -267
  24. package/.aios-core/development/README.md +142 -142
  25. package/.aios-core/development/agent-teams/team-all.yaml +15 -15
  26. package/.aios-core/development/agent-teams/team-fullstack.yaml +18 -18
  27. package/.aios-core/development/agent-teams/team-ide-minimal.yaml +10 -10
  28. package/.aios-core/development/agent-teams/team-no-ui.yaml +13 -13
  29. package/.aios-core/development/agent-teams/team-qa-focused.yaml +155 -155
  30. package/.aios-core/development/agents/aios-master.md +339 -339
  31. package/.aios-core/development/agents/analyst.md +195 -195
  32. package/.aios-core/development/agents/architect.md +359 -359
  33. package/.aios-core/development/agents/data-engineer.md +468 -468
  34. package/.aios-core/development/agents/dev.md +390 -390
  35. package/.aios-core/development/agents/devops.md +398 -398
  36. package/.aios-core/development/agents/pm.md +198 -198
  37. package/.aios-core/development/agents/po.md +256 -256
  38. package/.aios-core/development/agents/qa.md +312 -312
  39. package/.aios-core/development/agents/sm.md +220 -220
  40. package/.aios-core/development/agents/ux-design-expert.md +451 -451
  41. package/.aios-core/development/scripts/greeting-config-cli.js +85 -85
  42. package/.aios-core/development/tasks/add-mcp.md +319 -319
  43. package/.aios-core/development/tasks/advanced-elicitation.md +318 -318
  44. package/.aios-core/development/tasks/analyst-facilitate-brainstorming.md +341 -341
  45. package/.aios-core/development/tasks/analyze-brownfield.md +456 -0
  46. package/.aios-core/development/tasks/analyze-framework.md +696 -696
  47. package/.aios-core/development/tasks/analyze-performance.md +637 -637
  48. package/.aios-core/development/tasks/apply-qa-fixes.md +340 -340
  49. package/.aios-core/development/tasks/architect-analyze-impact.md +826 -826
  50. package/.aios-core/development/tasks/audit-codebase.md +429 -429
  51. package/.aios-core/development/tasks/audit-tailwind-config.md +270 -270
  52. package/.aios-core/development/tasks/audit-utilities.md +358 -358
  53. package/.aios-core/development/tasks/bootstrap-shadcn-library.md +286 -286
  54. package/.aios-core/development/tasks/brownfield-create-epic.md +485 -485
  55. package/.aios-core/development/tasks/brownfield-create-story.md +356 -356
  56. package/.aios-core/development/tasks/build-component.md +478 -478
  57. package/.aios-core/development/tasks/calculate-roi.md +455 -455
  58. package/.aios-core/development/tasks/ci-cd-configuration.md +764 -764
  59. package/.aios-core/development/tasks/cleanup-utilities.md +670 -670
  60. package/.aios-core/development/tasks/collaborative-edit.md +1108 -1108
  61. package/.aios-core/development/tasks/compose-molecule.md +284 -284
  62. package/.aios-core/development/tasks/consolidate-patterns.md +414 -414
  63. package/.aios-core/development/tasks/correct-course.md +279 -279
  64. package/.aios-core/development/tasks/create-agent.md +321 -321
  65. package/.aios-core/development/tasks/create-brownfield-story.md +726 -726
  66. package/.aios-core/development/tasks/create-deep-research-prompt.md +498 -498
  67. package/.aios-core/development/tasks/create-doc.md +316 -316
  68. package/.aios-core/development/tasks/create-next-story.md +774 -774
  69. package/.aios-core/development/tasks/create-suite.md +283 -283
  70. package/.aios-core/development/tasks/create-task.md +371 -371
  71. package/.aios-core/development/tasks/create-workflow.md +370 -370
  72. package/.aios-core/development/tasks/db-analyze-hotpaths.md +572 -572
  73. package/.aios-core/development/tasks/db-apply-migration.md +381 -381
  74. package/.aios-core/development/tasks/db-bootstrap.md +642 -642
  75. package/.aios-core/development/tasks/db-domain-modeling.md +693 -693
  76. package/.aios-core/development/tasks/db-dry-run.md +293 -293
  77. package/.aios-core/development/tasks/db-env-check.md +260 -260
  78. package/.aios-core/development/tasks/db-expansion-pack-integration.md +663 -663
  79. package/.aios-core/development/tasks/db-explain.md +631 -631
  80. package/.aios-core/development/tasks/db-impersonate.md +495 -495
  81. package/.aios-core/development/tasks/db-load-csv.md +593 -593
  82. package/.aios-core/development/tasks/db-policy-apply.md +653 -653
  83. package/.aios-core/development/tasks/db-rls-audit.md +411 -411
  84. package/.aios-core/development/tasks/db-rollback.md +739 -739
  85. package/.aios-core/development/tasks/db-run-sql.md +613 -613
  86. package/.aios-core/development/tasks/db-schema-audit.md +1011 -1011
  87. package/.aios-core/development/tasks/db-seed.md +390 -390
  88. package/.aios-core/development/tasks/db-smoke-test.md +351 -351
  89. package/.aios-core/development/tasks/db-snapshot.md +569 -569
  90. package/.aios-core/development/tasks/db-supabase-setup.md +712 -712
  91. package/.aios-core/development/tasks/db-verify-order.md +515 -515
  92. package/.aios-core/development/tasks/deprecate-component.md +956 -956
  93. package/.aios-core/development/tasks/dev-apply-qa-fixes.md +318 -318
  94. package/.aios-core/development/tasks/dev-backlog-debt.md +469 -469
  95. package/.aios-core/development/tasks/dev-develop-story.md +846 -846
  96. package/.aios-core/development/tasks/dev-improve-code-quality.md +872 -872
  97. package/.aios-core/development/tasks/dev-optimize-performance.md +1033 -1033
  98. package/.aios-core/development/tasks/dev-suggest-refactoring.md +870 -870
  99. package/.aios-core/development/tasks/dev-validate-next-story.md +348 -348
  100. package/.aios-core/development/tasks/document-project.md +552 -552
  101. package/.aios-core/development/tasks/environment-bootstrap.md +1311 -1311
  102. package/.aios-core/development/tasks/execute-checklist.md +301 -301
  103. package/.aios-core/development/tasks/export-design-tokens-dtcg.md +274 -274
  104. package/.aios-core/development/tasks/extend-pattern.md +269 -269
  105. package/.aios-core/development/tasks/extract-tokens.md +467 -467
  106. package/.aios-core/development/tasks/facilitate-brainstorming-session.md +518 -518
  107. package/.aios-core/development/tasks/generate-ai-frontend-prompt.md +260 -260
  108. package/.aios-core/development/tasks/generate-documentation.md +284 -284
  109. package/.aios-core/development/tasks/generate-migration-strategy.md +522 -522
  110. package/.aios-core/development/tasks/generate-shock-report.md +501 -501
  111. package/.aios-core/development/tasks/github-devops-github-pr-automation.md +427 -427
  112. package/.aios-core/development/tasks/github-devops-pre-push-quality-gate.md +733 -733
  113. package/.aios-core/development/tasks/github-devops-repository-cleanup.md +374 -374
  114. package/.aios-core/development/tasks/github-devops-version-management.md +483 -483
  115. package/.aios-core/development/tasks/improve-self.md +822 -822
  116. package/.aios-core/development/tasks/index-docs.md +387 -387
  117. package/.aios-core/development/tasks/init-project-status.md +506 -506
  118. package/.aios-core/development/tasks/integrate-expansion-pack.md +314 -314
  119. package/.aios-core/development/tasks/kb-mode-interaction.md +283 -283
  120. package/.aios-core/development/tasks/learn-patterns.md +900 -900
  121. package/.aios-core/development/tasks/mcp-workflow.md +437 -437
  122. package/.aios-core/development/tasks/modify-agent.md +381 -381
  123. package/.aios-core/development/tasks/modify-task.md +424 -424
  124. package/.aios-core/development/tasks/modify-workflow.md +465 -465
  125. package/.aios-core/development/tasks/po-backlog-add.md +370 -370
  126. package/.aios-core/development/tasks/po-manage-story-backlog.md +523 -523
  127. package/.aios-core/development/tasks/po-pull-story-from-clickup.md +540 -540
  128. package/.aios-core/development/tasks/po-pull-story.md +316 -316
  129. package/.aios-core/development/tasks/po-stories-index.md +351 -351
  130. package/.aios-core/development/tasks/po-sync-story-to-clickup.md +457 -457
  131. package/.aios-core/development/tasks/po-sync-story.md +303 -303
  132. package/.aios-core/development/tasks/pr-automation.md +701 -701
  133. package/.aios-core/development/tasks/propose-modification.md +842 -842
  134. package/.aios-core/development/tasks/qa-backlog-add-followup.md +425 -425
  135. package/.aios-core/development/tasks/qa-gate.md +373 -373
  136. package/.aios-core/development/tasks/qa-generate-tests.md +1174 -1174
  137. package/.aios-core/development/tasks/qa-nfr-assess.md +557 -557
  138. package/.aios-core/development/tasks/qa-review-proposal.md +1157 -1157
  139. package/.aios-core/development/tasks/qa-review-story.md +682 -682
  140. package/.aios-core/development/tasks/qa-risk-profile.md +566 -566
  141. package/.aios-core/development/tasks/qa-run-tests.md +277 -277
  142. package/.aios-core/development/tasks/qa-test-design.md +387 -387
  143. package/.aios-core/development/tasks/qa-trace-requirements.md +476 -476
  144. package/.aios-core/development/tasks/release-management.md +723 -723
  145. package/.aios-core/development/tasks/security-audit.md +554 -554
  146. package/.aios-core/development/tasks/security-scan.md +790 -790
  147. package/.aios-core/development/tasks/setup-database.md +741 -741
  148. package/.aios-core/development/tasks/setup-design-system.md +462 -462
  149. package/.aios-core/development/tasks/setup-github.md +874 -874
  150. package/.aios-core/development/tasks/setup-llm-routing.md +1 -1
  151. package/.aios-core/development/tasks/setup-mcp-docker.md +584 -584
  152. package/.aios-core/development/tasks/setup-project-docs.md +440 -0
  153. package/.aios-core/development/tasks/shard-doc.md +537 -537
  154. package/.aios-core/development/tasks/sm-create-next-story.md +480 -480
  155. package/.aios-core/development/tasks/sync-documentation.md +864 -864
  156. package/.aios-core/development/tasks/tailwind-upgrade.md +294 -294
  157. package/.aios-core/development/tasks/test-as-user.md +621 -621
  158. package/.aios-core/development/tasks/test-validation-task.md +171 -171
  159. package/.aios-core/development/tasks/undo-last.md +346 -346
  160. package/.aios-core/development/tasks/update-manifest.md +409 -409
  161. package/.aios-core/development/tasks/ux-create-wireframe.md +617 -617
  162. package/.aios-core/development/tasks/ux-ds-scan-artifact.md +672 -672
  163. package/.aios-core/development/tasks/ux-user-research.md +559 -559
  164. package/.aios-core/development/tasks/validate-next-story.md +422 -422
  165. package/.aios-core/development/workflows/README.md +83 -83
  166. package/.aios-core/development/workflows/brownfield-fullstack.yaml +297 -297
  167. package/.aios-core/development/workflows/brownfield-service.yaml +187 -187
  168. package/.aios-core/development/workflows/brownfield-ui.yaml +197 -197
  169. package/.aios-core/development/workflows/greenfield-fullstack.yaml +333 -333
  170. package/.aios-core/development/workflows/greenfield-service.yaml +206 -206
  171. package/.aios-core/development/workflows/greenfield-ui.yaml +235 -235
  172. package/.aios-core/docs/SHARD-TRANSLATION-GUIDE.md +335 -335
  173. package/.aios-core/docs/component-creation-guide.md +457 -457
  174. package/.aios-core/docs/session-update-pattern.md +307 -307
  175. package/.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +572 -572
  176. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md +185 -185
  177. package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md +354 -354
  178. package/.aios-core/docs/standards/AIOS-FRAMEWORK-MASTER.md +1963 -1963
  179. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md +821 -821
  180. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md +1190 -1190
  181. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1.md +439 -439
  182. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md +1339 -1339
  183. package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO.md +5398 -5398
  184. package/.aios-core/docs/standards/EXECUTOR-DECISION-TREE.md +697 -697
  185. package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +511 -511
  186. package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md +556 -556
  187. package/.aios-core/docs/standards/STANDARDS-INDEX.md +210 -210
  188. package/.aios-core/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +550 -550
  189. package/.aios-core/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md +1414 -1414
  190. package/.aios-core/docs/standards/V3-ARCHITECTURAL-DECISIONS.md +523 -523
  191. package/.aios-core/docs/template-syntax.md +266 -266
  192. package/.aios-core/docs/troubleshooting-guide.md +624 -624
  193. package/.aios-core/index.esm.js +15 -15
  194. package/.aios-core/index.js +1 -1
  195. package/.aios-core/infrastructure/README.md +126 -126
  196. package/.aios-core/infrastructure/integrations/pm-adapters/README.md +59 -59
  197. package/.aios-core/infrastructure/scripts/approval-workflow.js +1 -1
  198. package/.aios-core/infrastructure/scripts/batch-creator.js +1 -1
  199. package/.aios-core/infrastructure/scripts/component-generator.js +3 -3
  200. package/.aios-core/infrastructure/scripts/component-metadata.js +1 -1
  201. package/.aios-core/infrastructure/scripts/component-search.js +1 -1
  202. package/.aios-core/infrastructure/scripts/coverage-analyzer.js +1 -1
  203. package/.aios-core/infrastructure/scripts/dependency-analyzer.js +1 -1
  204. package/.aios-core/infrastructure/scripts/dependency-impact-analyzer.js +1 -1
  205. package/.aios-core/infrastructure/scripts/documentation-integrity/brownfield-analyzer.js +501 -0
  206. package/.aios-core/infrastructure/scripts/documentation-integrity/config-generator.js +368 -0
  207. package/.aios-core/infrastructure/scripts/documentation-integrity/deployment-config-loader.js +308 -0
  208. package/.aios-core/infrastructure/scripts/documentation-integrity/doc-generator.js +331 -0
  209. package/.aios-core/infrastructure/scripts/documentation-integrity/gitignore-generator.js +312 -0
  210. package/.aios-core/infrastructure/scripts/documentation-integrity/index.js +74 -0
  211. package/.aios-core/infrastructure/scripts/documentation-integrity/mode-detector.js +389 -0
  212. package/.aios-core/infrastructure/scripts/framework-analyzer.js +1 -1
  213. package/.aios-core/infrastructure/scripts/improvement-engine.js +1 -1
  214. package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js +26 -13
  215. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -0
  216. package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh +108 -0
  217. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -0
  218. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-proxy.sh +65 -0
  219. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -0
  220. package/.aios-core/infrastructure/scripts/llm-routing/templates/deepseek-usage.sh +16 -0
  221. package/.aios-core/infrastructure/scripts/llm-routing/usage-tracker/index.js +549 -0
  222. package/.aios-core/infrastructure/scripts/modification-risk-assessment.js +1 -1
  223. package/.aios-core/infrastructure/scripts/performance-analyzer.js +1 -1
  224. package/.aios-core/infrastructure/scripts/pm-adapter.js +134 -134
  225. package/.aios-core/infrastructure/scripts/repository-detector.js +3 -3
  226. package/.aios-core/infrastructure/scripts/template-engine.js +1 -1
  227. package/.aios-core/infrastructure/scripts/template-validator.js +1 -1
  228. package/.aios-core/infrastructure/scripts/test-generator.js +1 -1
  229. package/.aios-core/infrastructure/scripts/test-quality-assessment.js +1 -1
  230. package/.aios-core/infrastructure/scripts/transaction-manager.js +1 -1
  231. package/.aios-core/infrastructure/scripts/usage-analytics.js +1 -1
  232. package/.aios-core/infrastructure/scripts/visual-impact-generator.js +2 -2
  233. package/.aios-core/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +176 -0
  234. package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +127 -0
  235. package/.aios-core/infrastructure/templates/github-workflows/README.md +109 -109
  236. package/.aios-core/infrastructure/templates/gitignore/gitignore-aios-base.tmpl +63 -0
  237. package/.aios-core/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +18 -0
  238. package/.aios-core/infrastructure/templates/gitignore/gitignore-node.tmpl +85 -0
  239. package/.aios-core/infrastructure/templates/gitignore/gitignore-python.tmpl +145 -0
  240. package/.aios-core/infrastructure/templates/project-docs/coding-standards-tmpl.md +346 -0
  241. package/.aios-core/infrastructure/templates/project-docs/source-tree-tmpl.md +177 -0
  242. package/.aios-core/infrastructure/templates/project-docs/tech-stack-tmpl.md +267 -0
  243. package/.aios-core/infrastructure/tests/regression-suite-v2.md +621 -621
  244. package/.aios-core/infrastructure/tools/README.md +222 -222
  245. package/.aios-core/infrastructure/tools/cli/github-cli.yaml +200 -200
  246. package/.aios-core/infrastructure/tools/cli/railway-cli.yaml +260 -260
  247. package/.aios-core/infrastructure/tools/cli/supabase-cli.yaml +224 -224
  248. package/.aios-core/infrastructure/tools/local/ffmpeg.yaml +261 -261
  249. package/.aios-core/infrastructure/tools/mcp/21st-dev-magic.yaml +127 -127
  250. package/.aios-core/infrastructure/tools/mcp/browser.yaml +103 -103
  251. package/.aios-core/infrastructure/tools/mcp/clickup.yaml +534 -534
  252. package/.aios-core/infrastructure/tools/mcp/context7.yaml +78 -78
  253. package/.aios-core/infrastructure/tools/mcp/desktop-commander.yaml +180 -180
  254. package/.aios-core/infrastructure/tools/mcp/exa.yaml +103 -103
  255. package/.aios-core/infrastructure/tools/mcp/google-workspace.yaml +930 -930
  256. package/.aios-core/infrastructure/tools/mcp/n8n.yaml +551 -551
  257. package/.aios-core/infrastructure/tools/mcp/supabase.yaml +808 -808
  258. package/.aios-core/install-manifest.yaml +347 -347
  259. package/.aios-core/product/README.md +56 -56
  260. package/.aios-core/product/checklists/accessibility-wcag-checklist.md +80 -0
  261. package/.aios-core/product/checklists/architect-checklist.md +443 -443
  262. package/.aios-core/product/checklists/change-checklist.md +182 -182
  263. package/.aios-core/product/checklists/component-quality-checklist.md +74 -0
  264. package/.aios-core/product/checklists/database-design-checklist.md +119 -119
  265. package/.aios-core/product/checklists/dba-predeploy-checklist.md +97 -97
  266. package/.aios-core/product/checklists/dba-rollback-checklist.md +99 -99
  267. package/.aios-core/product/checklists/migration-readiness-checklist.md +75 -0
  268. package/.aios-core/product/checklists/pattern-audit-checklist.md +88 -0
  269. package/.aios-core/product/checklists/pm-checklist.md +375 -375
  270. package/.aios-core/product/checklists/po-master-checklist.md +441 -441
  271. package/.aios-core/product/checklists/pre-push-checklist.md +108 -108
  272. package/.aios-core/product/checklists/release-checklist.md +122 -122
  273. package/.aios-core/product/checklists/story-dod-checklist.md +101 -101
  274. package/.aios-core/product/checklists/story-draft-checklist.md +215 -215
  275. package/.aios-core/product/data/atomic-design-principles.md +108 -0
  276. package/.aios-core/product/data/brainstorming-techniques.md +36 -36
  277. package/.aios-core/product/data/consolidation-algorithms.md +142 -0
  278. package/.aios-core/product/data/database-best-practices.md +182 -0
  279. package/.aios-core/product/data/design-token-best-practices.md +107 -0
  280. package/.aios-core/product/data/elicitation-methods.md +134 -134
  281. package/.aios-core/product/data/integration-patterns.md +207 -0
  282. package/.aios-core/product/data/migration-safety-guide.md +329 -0
  283. package/.aios-core/product/data/mode-selection-best-practices.md +471 -471
  284. package/.aios-core/product/data/postgres-tuning-guide.md +300 -0
  285. package/.aios-core/product/data/rls-security-patterns.md +333 -0
  286. package/.aios-core/product/data/roi-calculation-guide.md +142 -0
  287. package/.aios-core/product/data/supabase-patterns.md +330 -0
  288. package/.aios-core/product/data/test-levels-framework.md +148 -148
  289. package/.aios-core/product/data/test-priorities-matrix.md +174 -174
  290. package/.aios-core/product/data/wcag-compliance-guide.md +267 -0
  291. package/.aios-core/product/templates/1mcp-config.yaml +225 -225
  292. package/.aios-core/product/templates/activation-instructions-inline-greeting.yaml +63 -63
  293. package/.aios-core/product/templates/activation-instructions-template.md +258 -258
  294. package/.aios-core/product/templates/agent-template.yaml +120 -120
  295. package/.aios-core/product/templates/architecture-tmpl.yaml +650 -650
  296. package/.aios-core/product/templates/brainstorming-output-tmpl.yaml +155 -155
  297. package/.aios-core/product/templates/brownfield-architecture-tmpl.yaml +475 -475
  298. package/.aios-core/product/templates/brownfield-prd-tmpl.yaml +279 -279
  299. package/.aios-core/product/templates/changelog-template.md +134 -134
  300. package/.aios-core/product/templates/command-rationalization-matrix.md +152 -152
  301. package/.aios-core/product/templates/competitor-analysis-tmpl.yaml +292 -292
  302. package/.aios-core/product/templates/design-story-tmpl.yaml +587 -587
  303. package/.aios-core/product/templates/ds-artifact-analysis.md +70 -70
  304. package/.aios-core/product/templates/front-end-architecture-tmpl.yaml +205 -205
  305. package/.aios-core/product/templates/front-end-spec-tmpl.yaml +348 -348
  306. package/.aios-core/product/templates/fullstack-architecture-tmpl.yaml +804 -804
  307. package/.aios-core/product/templates/github-pr-template.md +67 -67
  308. package/.aios-core/product/templates/gordon-mcp.yaml +140 -140
  309. package/.aios-core/product/templates/ide-rules/antigravity-rules.md +115 -115
  310. package/.aios-core/product/templates/ide-rules/claude-rules.md +221 -221
  311. package/.aios-core/product/templates/ide-rules/cline-rules.md +84 -84
  312. package/.aios-core/product/templates/ide-rules/copilot-rules.md +92 -92
  313. package/.aios-core/product/templates/ide-rules/cursor-rules.md +115 -115
  314. package/.aios-core/product/templates/ide-rules/gemini-rules.md +85 -85
  315. package/.aios-core/product/templates/ide-rules/roo-rules.md +86 -86
  316. package/.aios-core/product/templates/ide-rules/trae-rules.md +104 -104
  317. package/.aios-core/product/templates/ide-rules/windsurf-rules.md +80 -80
  318. package/.aios-core/product/templates/index-strategy-tmpl.yaml +53 -53
  319. package/.aios-core/product/templates/market-research-tmpl.yaml +251 -251
  320. package/.aios-core/product/templates/mcp-workflow.js +271 -271
  321. package/.aios-core/product/templates/migration-plan-tmpl.yaml +1022 -1022
  322. package/.aios-core/product/templates/migration-strategy-tmpl.md +524 -524
  323. package/.aios-core/product/templates/personalized-agent-template.md +258 -258
  324. package/.aios-core/product/templates/personalized-checklist-template.md +340 -340
  325. package/.aios-core/product/templates/personalized-task-template-v2.md +905 -905
  326. package/.aios-core/product/templates/personalized-task-template.md +344 -344
  327. package/.aios-core/product/templates/personalized-template-file.yaml +322 -322
  328. package/.aios-core/product/templates/personalized-workflow-template.yaml +460 -460
  329. package/.aios-core/product/templates/prd-tmpl.yaml +201 -201
  330. package/.aios-core/product/templates/project-brief-tmpl.yaml +220 -220
  331. package/.aios-core/product/templates/qa-gate-tmpl.yaml +240 -240
  332. package/.aios-core/product/templates/rls-policies-tmpl.yaml +1203 -1203
  333. package/.aios-core/product/templates/schema-design-tmpl.yaml +428 -428
  334. package/.aios-core/product/templates/state-persistence-tmpl.yaml +219 -219
  335. package/.aios-core/product/templates/story-tmpl.yaml +331 -331
  336. package/.aios-core/product/templates/task-execution-report.md +495 -495
  337. package/.aios-core/product/templates/task-template.md +122 -122
  338. package/.aios-core/product/templates/token-exports-tailwind-tmpl.js +395 -395
  339. package/.aios-core/product/templates/tokens-schema-tmpl.yaml +305 -305
  340. package/.aios-core/product/templates/workflow-template.yaml +133 -133
  341. package/.aios-core/scripts/README.md +354 -354
  342. package/.aios-core/scripts/aios-doc-template.md +325 -325
  343. package/.aios-core/scripts/elicitation-engine.js +1 -1
  344. package/.aios-core/scripts/test-template-system.js +1 -1
  345. package/.aios-core/scripts/workflow-management.md +69 -69
  346. package/.aios-core/user-guide.md +1413 -1413
  347. package/.aios-core/working-in-the-brownfield.md +361 -361
  348. package/LICENSE +1 -1
  349. package/README.md +702 -703
  350. package/bin/aios-init-old.js +3 -3
  351. package/bin/aios-init-v4.js +1 -1
  352. package/bin/aios-init.backup-v1.1.4.js +1 -1
  353. package/bin/aios-init.js +3 -3
  354. package/bin/aios.js +279 -279
  355. package/bin/utils/install-errors.js +339 -339
  356. package/bin/utils/install-transaction.js +445 -445
  357. package/index.d.ts +18 -18
  358. package/index.esm.js +20 -20
  359. package/index.js +6 -6
  360. package/package.json +8 -10
  361. package/packages/installer/src/config/templates/env-template.js +27 -4
  362. package/packages/installer/src/detection/detect-project-type.js +81 -81
  363. package/packages/installer/src/wizard/wizard.js +185 -34
  364. package/packages/installer/tests/integration/environment-configuration.test.js +2 -1
  365. package/packages/installer/tests/integration/wizard-detection.test.js +8 -6
  366. package/packages/installer/tests/unit/env-template.test.js +11 -10
  367. package/src/config/ide-configs.js +1 -1
  368. package/src/wizard/feedback.js +2 -2
  369. package/src/wizard/index.js +1 -1
  370. package/src/wizard/validation/report-generator.js +1 -1
  371. package/src/wizard/validation/troubleshooting-system.js +13 -13
  372. package/.aios-core/development/tasks/validate-structure.md +0 -243
  373. package/.aios-core/infrastructure/scripts/_archived/final-todo-count.js +0 -122
  374. package/.aios-core/infrastructure/scripts/_archived/fix-yaml-formatting.js +0 -89
  375. package/.aios-core/infrastructure/scripts/_archived/migration-generator.js +0 -780
  376. package/.aios-core/infrastructure/scripts/_archived/migration-path-generator.js +0 -950
  377. package/.aios-core/infrastructure/scripts/_archived/phase2-entrada-saida-errors.js +0 -425
  378. package/.aios-core/infrastructure/scripts/_archived/phase2-spot-check.js +0 -132
  379. package/.aios-core/infrastructure/scripts/_archived/phase3-tools-scripts-validation.js +0 -381
  380. package/.aios-core/infrastructure/scripts/_archived/phase4-metadata-performance.js +0 -203
  381. package/.aios-core/infrastructure/scripts/_archived/test-yaml-parsing.js +0 -24
  382. package/.aios-core/infrastructure/scripts/_archived/verify-yaml-fix.js +0 -51
  383. package/.aios-core/infrastructure/scripts/source-tree-guardian/index.js +0 -375
  384. package/.aios-core/infrastructure/scripts/source-tree-guardian/manifest-generator.js +0 -410
  385. package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/naming-rules.yaml +0 -285
  386. package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/placement-rules.yaml +0 -262
  387. package/.aios-core/infrastructure/scripts/source-tree-guardian/validator.js +0 -468
  388. package/.aios-core/tasks/find-component.md.legacy +0 -391
  389. package/.aios-core/tasks/generate-commit-message.md.legacy +0 -426
  390. package/.aios-core/tasks/generate-migration.md.legacy +0 -382
  391. package/.aios-core/tasks/rollback-modification.md.legacy +0 -307
  392. package/.aios-core/tasks/update-tests.md.legacy +0 -283
package/index.d.ts CHANGED
@@ -1,19 +1,19 @@
1
- // AIOS-FullStack Workspace - TypeScript Definitions
2
- declare module '@aios-fullstack/workspace' {
3
- export class AIOS {
4
- constructor(config?: any);
5
- initialize(): Promise<AIOS>;
6
- createAgent(config: any): Promise<any>;
7
- createTask(taskConfig: any): Promise<any>;
8
- search(query: string, options?: any): Promise<any[]>;
9
- healthCheck(): Promise<any>;
10
- }
11
-
12
- export * as core from '@aios-fullstack/core';
13
- export * as memory from '@aios-fullstack/memory';
14
- export * as security from '@aios-fullstack/security';
15
- export * as performance from '@aios-fullstack/performance';
16
- export * as telemetry from '@aios-fullstack/telemetry';
17
-
18
- export default AIOS;
1
+ // Synkra AIOS - TypeScript Definitions
2
+ declare module '@synkra/aios-core/workspace' {
3
+ export class AIOS {
4
+ constructor(config?: any);
5
+ initialize(): Promise<AIOS>;
6
+ createAgent(config: any): Promise<any>;
7
+ createTask(taskConfig: any): Promise<any>;
8
+ search(query: string, options?: any): Promise<any[]>;
9
+ healthCheck(): Promise<any>;
10
+ }
11
+
12
+ export * as core from '@synkra/aios-core/core';
13
+ export * as memory from '@synkra/aios-core/memory';
14
+ export * as security from '@synkra/aios-core/security';
15
+ export * as performance from '@synkra/aios-core/performance';
16
+ export * as telemetry from '@synkra/aios-core/telemetry';
17
+
18
+ export default AIOS;
19
19
  }
package/index.esm.js CHANGED
@@ -1,21 +1,21 @@
1
- // AIOS-FullStack Workspace - ES Module Entry Point
2
- import * as core from '@aios-fullstack/core';
3
- import * as memory from '@aios-fullstack/memory';
4
- import * as security from '@aios-fullstack/security';
5
- import * as performance from '@aios-fullstack/performance';
6
- import * as telemetry from '@aios-fullstack/telemetry';
7
-
8
- // Re-export the AIOS class from CommonJS version
9
- import workspace from './index.js';
10
- const { AIOS } = workspace;
11
-
12
- export {
13
- AIOS,
14
- core,
15
- memory,
16
- security,
17
- performance,
18
- telemetry
19
- };
20
-
1
+ // Synkra AIOS - ES Module Entry Point
2
+ import * as core from '@synkra/aios-core/core';
3
+ import * as memory from '@synkra/aios-core/memory';
4
+ import * as security from '@synkra/aios-core/security';
5
+ import * as performance from '@synkra/aios-core/performance';
6
+ import * as telemetry from '@synkra/aios-core/telemetry';
7
+
8
+ // Re-export the AIOS class from CommonJS version
9
+ import workspace from './index.js';
10
+ const { AIOS } = workspace;
11
+
12
+ export {
13
+ AIOS,
14
+ core,
15
+ memory,
16
+ security,
17
+ performance,
18
+ telemetry
19
+ };
20
+
21
21
  export default AIOS;
package/index.js CHANGED
@@ -1,9 +1,9 @@
1
- // AIOS-FullStack Workspace - Complete Framework Entry Point
2
- const core = require('@aios-fullstack/core');
3
- const memory = require('@aios-fullstack/memory');
4
- const security = require('@aios-fullstack/security');
5
- const performance = require('@aios-fullstack/performance');
6
- const telemetry = require('@aios-fullstack/telemetry');
1
+ // Synkra AIOS - Complete Framework Entry Point
2
+ const core = require('@synkra/aios-core/core');
3
+ const memory = require('@synkra/aios-core/memory');
4
+ const security = require('@synkra/aios-core/security');
5
+ const performance = require('@synkra/aios-core/performance');
6
+ const telemetry = require('@synkra/aios-core/telemetry');
7
7
 
8
8
  // Main AIOS class that orchestrates all components
9
9
  class AIOS {
package/package.json CHANGED
@@ -1,16 +1,14 @@
1
1
  {
2
2
  "name": "aios-core",
3
- "version": "2.1.5",
4
- "description": "AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
3
+ "version": "2.2.0",
4
+ "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
5
5
  "main": "index.js",
6
6
  "module": "index.esm.js",
7
7
  "types": "index.d.ts",
8
8
  "bin": {
9
- "aios": "./bin/aios.js",
10
- "aios-core": "./bin/aios.js",
11
- "aios-fullstack": "./bin/aios.js",
12
- "aios-fullstack-minimal": "./bin/aios-minimal.js",
13
- "aios-minimal": "./bin/aios-minimal.js"
9
+ "aios": "bin/aios.js",
10
+ "aios-core": "bin/aios.js",
11
+ "aios-minimal": "bin/aios-minimal.js"
14
12
  },
15
13
  "preferGlobal": false,
16
14
  "workspaces": [
@@ -33,7 +31,7 @@
33
31
  ".claude/CLAUDE.md",
34
32
  ".claude/rules/",
35
33
  "common/",
36
- "expansion-packs/",
34
+ "squads/",
37
35
  "index.js",
38
36
  "index.esm.js",
39
37
  "index.d.ts",
@@ -119,7 +117,7 @@
119
117
  "vite-style",
120
118
  "automation"
121
119
  ],
122
- "author": "AIOS Fullstack Team",
120
+ "author": "Synkra AIOS Team",
123
121
  "license": "MIT",
124
122
  "repository": {
125
123
  "type": "git",
@@ -146,7 +144,7 @@
146
144
  "jest": "^30.2.0",
147
145
  "lint-staged": "^16.1.1",
148
146
  "prettier": "^3.5.3",
149
- "semantic-release": "^22.0.0",
147
+ "semantic-release": "^25.0.2",
150
148
  "typescript": "^5.9.3",
151
149
  "yaml-lint": "^1.7.0"
152
150
  },
@@ -7,6 +7,29 @@
7
7
  * @module env-template
8
8
  */
9
9
 
10
+ const path = require('path');
11
+ const fs = require('fs');
12
+
13
+ /**
14
+ * Get the current AIOS version from package.json
15
+ * @returns {string} The version string
16
+ */
17
+ function getAiosVersion() {
18
+ try {
19
+ // Try to find the root package.json
20
+ const rootPkgPath = path.resolve(__dirname, '../../../../package.json');
21
+ if (fs.existsSync(rootPkgPath)) {
22
+ const pkg = JSON.parse(fs.readFileSync(rootPkgPath, 'utf8'));
23
+ return pkg.version || '2.2.0';
24
+ }
25
+ } catch {
26
+ // Ignore errors
27
+ }
28
+ return '2.2.0';
29
+ }
30
+
31
+ const AIOS_VERSION = getAiosVersion();
32
+
10
33
  /**
11
34
  * Generate .env file content
12
35
  *
@@ -24,7 +47,7 @@
24
47
  */
25
48
  function generateEnvContent(apiKeys = {}) {
26
49
  const content = `# ============================================
27
- # AIOS-FULLSTACK Environment Configuration
50
+ # Synkra AIOS Environment Configuration
28
51
  # ============================================
29
52
  # Generated by AIOS Installer
30
53
  # DO NOT commit this file - it contains sensitive credentials
@@ -118,7 +141,7 @@ VERCEL_TOKEN=
118
141
  # AIOS Core Configuration
119
142
  # --------------------------------------------
120
143
  NODE_ENV=development
121
- AIOS_VERSION=2.1.5
144
+ AIOS_VERSION=${AIOS_VERSION}
122
145
 
123
146
  # --------------------------------------------
124
147
  # Custom Configuration
@@ -136,7 +159,7 @@ AIOS_VERSION=2.1.5
136
159
  */
137
160
  function generateEnvExample() {
138
161
  const content = `# ============================================
139
- # AIOS-FULLSTACK Environment Configuration
162
+ # Synkra AIOS Environment Configuration
140
163
  # ============================================
141
164
  # Copy this file to .env and fill in your actual values
142
165
  # DO NOT commit .env with real credentials
@@ -230,7 +253,7 @@ VERCEL_TOKEN=
230
253
  # AIOS Core Configuration
231
254
  # --------------------------------------------
232
255
  NODE_ENV=development
233
- AIOS_VERSION=2.1.5
256
+ AIOS_VERSION=${AIOS_VERSION}
234
257
 
235
258
  # --------------------------------------------
236
259
  # Custom Configuration
@@ -1,81 +1,81 @@
1
- const fs = require('fs');
2
- const path = require('path');
3
-
4
- /**
5
- * Detects the type of project in the current directory
6
- *
7
- * Detection Priority Order:
8
- * 1. EXISTING_AIOS - .aios-core/ directory exists
9
- * 2. GREENFIELD - directory is empty
10
- * 3. BROWNFIELD - package.json OR .git exists
11
- * 4. UNKNOWN - directory has files but no recognized markers
12
- *
13
- * @param {string} targetDir - Directory to analyze (defaults to process.cwd())
14
- * @returns {string} 'GREENFIELD' | 'BROWNFIELD' | 'EXISTING_AIOS' | 'UNKNOWN'
15
- * @throws {Error} If directory cannot be accessed
16
- *
17
- * @example
18
- * // Detect current directory
19
- * const type = detectProjectType();
20
- * console.log(type); // 'GREENFIELD'
21
- *
22
- * @example
23
- * // Detect specific directory
24
- * const type = detectProjectType('/path/to/project');
25
- * console.log(type); // 'BROWNFIELD'
26
- */
27
- function detectProjectType(targetDir = process.cwd()) {
28
- try {
29
- // Validate targetDir parameter
30
- if (!targetDir || typeof targetDir !== 'string') {
31
- throw new Error('Invalid targetDir parameter: must be a non-empty string');
32
- }
33
-
34
- // Normalize path for cross-platform compatibility
35
- const normalizedDir = path.resolve(targetDir);
36
-
37
- // Check if directory exists before attempting to read
38
- if (!fs.existsSync(normalizedDir)) {
39
- throw new Error(`Directory does not exist: ${normalizedDir}`);
40
- }
41
-
42
- // Check for AIOS installation markers (use path.join for security)
43
- const hasAiosCore = fs.existsSync(path.join(normalizedDir, '.aios-core'));
44
-
45
- // If AIOS already installed, return immediately (highest priority)
46
- if (hasAiosCore) {
47
- return 'EXISTING_AIOS';
48
- }
49
-
50
- // Check directory contents
51
- const dirContents = fs.readdirSync(normalizedDir);
52
- const isEmpty = dirContents.length === 0;
53
-
54
- // Empty directory = greenfield (second priority)
55
- if (isEmpty) {
56
- return 'GREENFIELD';
57
- }
58
-
59
- // Check for project markers (third priority)
60
- const hasPackageJson = fs.existsSync(path.join(normalizedDir, 'package.json'));
61
- const hasGit = fs.existsSync(path.join(normalizedDir, '.git'));
62
-
63
- // Existing project markers = brownfield
64
- if (hasPackageJson || hasGit) {
65
- return 'BROWNFIELD';
66
- }
67
-
68
- // Directory has files but no recognized markers = unknown
69
- return 'UNKNOWN';
70
-
71
- } catch (error) {
72
- // Log error with context for debugging
73
- console.error(`[detect-project-type] Error detecting project type in '${targetDir}': ${error.message}`);
74
-
75
- // Re-throw with more context for caller to handle
76
- throw new Error(`Failed to detect project type: ${error.message}`);
77
- }
78
- }
79
-
80
- module.exports = { detectProjectType };
81
-
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+
4
+ /**
5
+ * Detects the type of project in the current directory
6
+ *
7
+ * Detection Priority Order:
8
+ * 1. EXISTING_AIOS - .aios-core/ directory exists
9
+ * 2. GREENFIELD - directory is empty
10
+ * 3. BROWNFIELD - package.json OR .git exists
11
+ * 4. UNKNOWN - directory has files but no recognized markers
12
+ *
13
+ * @param {string} targetDir - Directory to analyze (defaults to process.cwd())
14
+ * @returns {string} 'GREENFIELD' | 'BROWNFIELD' | 'EXISTING_AIOS' | 'UNKNOWN'
15
+ * @throws {Error} If directory cannot be accessed
16
+ *
17
+ * @example
18
+ * // Detect current directory
19
+ * const type = detectProjectType();
20
+ * console.log(type); // 'GREENFIELD'
21
+ *
22
+ * @example
23
+ * // Detect specific directory
24
+ * const type = detectProjectType('/path/to/project');
25
+ * console.log(type); // 'BROWNFIELD'
26
+ */
27
+ function detectProjectType(targetDir = process.cwd()) {
28
+ try {
29
+ // Validate targetDir parameter
30
+ if (!targetDir || typeof targetDir !== 'string') {
31
+ throw new Error('Invalid targetDir parameter: must be a non-empty string');
32
+ }
33
+
34
+ // Normalize path for cross-platform compatibility
35
+ const normalizedDir = path.resolve(targetDir);
36
+
37
+ // Check if directory exists before attempting to read
38
+ if (!fs.existsSync(normalizedDir)) {
39
+ throw new Error(`Directory does not exist: ${normalizedDir}`);
40
+ }
41
+
42
+ // Check for AIOS installation markers (use path.join for security)
43
+ const hasAiosCore = fs.existsSync(path.join(normalizedDir, '.aios-core'));
44
+
45
+ // If AIOS already installed, return immediately (highest priority)
46
+ if (hasAiosCore) {
47
+ return 'EXISTING_AIOS';
48
+ }
49
+
50
+ // Check directory contents
51
+ const dirContents = fs.readdirSync(normalizedDir);
52
+ const isEmpty = dirContents.length === 0;
53
+
54
+ // Empty directory = greenfield (second priority)
55
+ if (isEmpty) {
56
+ return 'GREENFIELD';
57
+ }
58
+
59
+ // Check for project markers (third priority)
60
+ const hasPackageJson = fs.existsSync(path.join(normalizedDir, 'package.json'));
61
+ const hasGit = fs.existsSync(path.join(normalizedDir, '.git'));
62
+
63
+ // Existing project markers = brownfield
64
+ if (hasPackageJson || hasGit) {
65
+ return 'BROWNFIELD';
66
+ }
67
+
68
+ // Directory has files but no recognized markers = unknown
69
+ return 'UNKNOWN';
70
+
71
+ } catch (error) {
72
+ // Log error with context for debugging
73
+ console.error(`[detect-project-type] Error detecting project type in '${targetDir}': ${error.message}`);
74
+
75
+ // Re-throw with more context for caller to handle
76
+ throw new Error(`Failed to detect project type: ${error.message}`);
77
+ }
78
+ }
79
+
80
+ module.exports = { detectProjectType };
81
+
@@ -1,46 +1,70 @@
1
1
  const { detectProjectType } = require('../detection/detect-project-type');
2
+ const {
3
+ detectInstallationMode,
4
+ getModeOptions,
5
+ validateModeSelection,
6
+ InstallationMode,
7
+ } = require('../../../../.aios-core/infrastructure/scripts/documentation-integrity/mode-detector');
2
8
 
3
9
  /**
4
10
  * Interactive Wizard for AIOS Installation
5
- *
6
- * This is a stub implementation that demonstrates the integration
7
- * with the project type detection module (Story 1.3).
8
- * Full wizard implementation is part of Story 1.2.
9
- *
11
+ *
12
+ * Supports three installation modes:
13
+ * - GREENFIELD: New project - generates all docs and config
14
+ * - BROWNFIELD: Existing project - analyzes and adapts
15
+ * - FRAMEWORK_DEV: Contributing to aios-core itself
16
+ *
10
17
  * @module wizard
18
+ * @version 2.0.0
19
+ * @story 6.9
11
20
  */
12
21
 
13
22
  /**
14
23
  * Run the interactive installer wizard
15
- *
24
+ *
16
25
  * @param {Object} options - Wizard options
17
26
  * @param {string} options.targetDir - Target directory for installation
27
+ * @param {string} options.mode - Pre-selected mode (skip detection)
18
28
  * @returns {Promise<Object>} Installation configuration
19
29
  */
20
30
  async function runWizard(options = {}) {
21
31
  const targetDir = options.targetDir || process.cwd();
22
-
32
+
23
33
  try {
24
- // Step 1: Welcome screen (Story 1.2)
34
+ // Step 1: Welcome screen
25
35
  console.log('🚀 Welcome to AIOS Installer\n');
26
-
27
- // Step 2: Detect project type (THIS STORY - Story 1.3)
28
- console.log('📊 Detecting project type...');
29
- const detectedType = detectProjectType(targetDir);
30
- console.log(`✅ Detected: ${detectedType}\n`);
31
-
32
- // Step 3: Confirm with user (Story 1.2)
33
- const confirmedType = await confirmProjectType(detectedType);
34
-
35
- // Step 4: Continue with installation (Stories 1.4-1.8)
36
+
37
+ // Step 2: Detect installation mode (Story 6.9)
38
+ console.log('📊 Analyzing project directory...');
39
+ const detected = detectInstallationMode(targetDir);
40
+ console.log(`✅ Detected: ${detected.mode} (${detected.reason})\n`);
41
+
42
+ // Step 3: Select installation mode (with user override)
43
+ const selectedMode = options.mode || (await selectInstallationMode(detected));
44
+
45
+ // Step 4: Validate selection
46
+ const validation = validateModeSelection(selectedMode, detected);
47
+ if (validation.warnings.length > 0) {
48
+ console.log('\n⚠️ Warnings:');
49
+ validation.warnings.forEach((w) => console.log(` - ${w}`));
50
+ console.log('');
51
+ }
52
+
53
+ // Step 5: Mode-specific configuration
54
+ const modeConfig = await configureModeSpecific(selectedMode, targetDir, detected);
55
+
56
+ // Step 6: Continue with installation (Stories 1.4-1.8)
36
57
  // - IDE Selection (Story 1.4)
37
58
  // - MCP Installation (Story 1.5)
38
59
  // - Environment Config (Story 1.6)
39
60
  // - Validation (Story 1.8)
40
-
61
+
41
62
  return {
42
- projectType: confirmedType,
63
+ projectType: detected.legacyType, // Backward compatibility
64
+ installationMode: selectedMode,
43
65
  targetDir,
66
+ detected,
67
+ modeConfig,
44
68
  // Other configuration will be added by downstream stories
45
69
  };
46
70
  } catch (error) {
@@ -49,29 +73,152 @@ async function runWizard(options = {}) {
49
73
  }
50
74
  }
51
75
 
76
+ /**
77
+ * Select installation mode with user input
78
+ *
79
+ * @param {Object} detected - Detection result from mode detector
80
+ * @returns {Promise<string>} Selected installation mode
81
+ */
82
+ async function selectInstallationMode(detected) {
83
+ const options = getModeOptions(detected);
84
+
85
+ console.log('Select installation type:\n');
86
+ options.forEach((opt, index) => {
87
+ const marker = opt.value === detected.mode ? '→' : ' ';
88
+ console.log(`${marker} ${index + 1}. ${opt.label}`);
89
+ console.log(` ${opt.hint}\n`);
90
+ });
91
+
92
+ // Stub: In real implementation, use @clack/prompts select()
93
+ // For now, return detected mode or first option
94
+ console.log(`(Using detected mode: ${detected.mode})`);
95
+ console.log('(Interactive selection via @clack/prompts in Story 1.2)\n');
96
+
97
+ return detected.mode !== InstallationMode.UNKNOWN ? detected.mode : InstallationMode.GREENFIELD;
98
+ }
99
+
100
+ /**
101
+ * Configure mode-specific settings
102
+ *
103
+ * @param {string} mode - Selected installation mode
104
+ * @param {string} targetDir - Target directory
105
+ * @param {Object} detected - Detection result
106
+ * @returns {Promise<Object>} Mode-specific configuration
107
+ */
108
+ async function configureModeSpecific(mode, _targetDir, _detected) {
109
+ const config = {
110
+ mode,
111
+ generateDocs: true,
112
+ generateConfig: true,
113
+ generateGitignore: true,
114
+ runSetupGithub: false,
115
+ deployment: null,
116
+ };
117
+
118
+ switch (mode) {
119
+ case InstallationMode.FRAMEWORK_DEV:
120
+ // Framework development - skip project setup
121
+ console.log('🔧 Framework Development Mode');
122
+ console.log(' → Using existing framework standards');
123
+ console.log(' → Skipping project documentation generation');
124
+ console.log(' → Skipping infrastructure setup\n');
125
+ config.generateDocs = false;
126
+ config.generateConfig = false;
127
+ config.generateGitignore = false;
128
+ break;
129
+
130
+ case InstallationMode.GREENFIELD:
131
+ // New project - full scaffolding
132
+ console.log('🆕 Greenfield Mode');
133
+ console.log(' → Will generate project documentation');
134
+ console.log(' → Will create project-specific core-config');
135
+ console.log(' → Will generate .gitignore based on tech stack');
136
+ console.log(' → Will offer *setup-github for infrastructure\n');
137
+ config.runSetupGithub = true;
138
+ // Deployment config will be elicited in Phase 3
139
+ config.deployment = await elicitDeploymentConfig();
140
+ break;
141
+
142
+ case InstallationMode.BROWNFIELD:
143
+ // Existing project - analyze and adapt
144
+ console.log('📂 Brownfield Mode');
145
+ console.log(' → Will analyze existing source tree');
146
+ console.log(' → Will detect existing coding standards');
147
+ console.log(' → Will merge with existing .gitignore');
148
+ console.log(' → Will analyze existing GitHub workflows\n');
149
+ // Deployment config will be elicited based on analysis in Phase 3
150
+ config.deployment = await elicitDeploymentConfig();
151
+ break;
152
+
153
+ default:
154
+ console.log('❓ Unknown mode - using greenfield defaults\n');
155
+ }
156
+
157
+ return config;
158
+ }
159
+
160
+ /**
161
+ * Elicit deployment configuration from user
162
+ * Implements Task 3.3 from Story 6.9
163
+ *
164
+ * @returns {Promise<Object>} Deployment configuration
165
+ */
166
+ async function elicitDeploymentConfig() {
167
+ // Stub implementation - will be fully implemented in Phase 3
168
+ console.log('📦 Deployment Configuration');
169
+ console.log(' (Full elicitation will be implemented in Phase 3)\n');
170
+
171
+ // Return default staging-first workflow
172
+ return {
173
+ workflow: 'staging-first',
174
+ branches: {
175
+ staging_targets: ['feature/*', 'fix/*', 'docs/*', 'chore/*', 'refactor/*', 'test/*'],
176
+ production_targets: ['hotfix/*'],
177
+ staging_branch: 'staging',
178
+ production_branch: 'main',
179
+ default_target: 'staging',
180
+ },
181
+ environments: {
182
+ staging: {
183
+ name: 'Staging',
184
+ auto_deploy: true,
185
+ platform: null, // To be detected/elicited
186
+ },
187
+ production: {
188
+ name: 'Production',
189
+ auto_deploy: true,
190
+ platform: null,
191
+ },
192
+ },
193
+ quality_gates: {
194
+ lint: true,
195
+ typecheck: true,
196
+ tests: true,
197
+ security_scan: false,
198
+ },
199
+ };
200
+ }
201
+
52
202
  /**
53
203
  * Confirm project type with user or allow override
54
- *
204
+ * @deprecated Use selectInstallationMode instead
205
+ *
55
206
  * @param {string} detectedType - Detected project type
56
207
  * @returns {Promise<string>} Confirmed project type
57
208
  */
58
209
  async function confirmProjectType(detectedType) {
59
- // Stub implementation - full implementation in Story 1.2
60
- // In real implementation, this would use @clack/prompts to ask user
61
-
210
+ // Kept for backward compatibility
62
211
  const typeDescriptions = {
63
- 'GREENFIELD': 'New project - AIOS will create complete structure',
64
- 'BROWNFIELD': 'Existing project - AIOS will integrate with current setup',
65
- 'EXISTING_AIOS': 'AIOS already installed - Would you like to update or reinstall?',
66
- 'UNKNOWN': 'Unknown project type - Manual selection required',
212
+ GREENFIELD: 'New project - AIOS will create complete structure',
213
+ BROWNFIELD: 'Existing project - AIOS will integrate with current setup',
214
+ EXISTING_AIOS: 'AIOS already installed - Would you like to update or reinstall?',
215
+ UNKNOWN: 'Unknown project type - Manual selection required',
67
216
  };
68
-
217
+
69
218
  console.log(`Project Type: ${detectedType}`);
70
219
  console.log(`Description: ${typeDescriptions[detectedType]}`);
71
- console.log('(Interactive confirmation will be added in Story 1.2)\n');
72
-
73
- // For now, return the detected type
74
- // Real implementation would prompt user to confirm or override
220
+ console.log('(Use selectInstallationMode for new three-mode selection)\n');
221
+
75
222
  return detectedType;
76
223
  }
77
224
 
@@ -87,7 +234,11 @@ function getProjectType(targetDir) {
87
234
 
88
235
  module.exports = {
89
236
  runWizard,
90
- confirmProjectType,
237
+ selectInstallationMode,
238
+ configureModeSpecific,
239
+ elicitDeploymentConfig,
240
+ confirmProjectType, // Deprecated - kept for backward compatibility
91
241
  getProjectType,
242
+ InstallationMode,
92
243
  };
93
244
 
@@ -9,6 +9,7 @@ const fs = require('fs-extra');
9
9
  const path = require('path');
10
10
  const os = require('os');
11
11
  const { configureEnvironment, updateGitignore } = require('../../src/config/configure-environment');
12
+ const pkg = require('../../../../package.json');
12
13
 
13
14
  /**
14
15
  * Cleanup helper with retry logic for flaky file system operations
@@ -72,7 +73,7 @@ describe('Environment Configuration Integration', () => {
72
73
 
73
74
  const content = await fs.readFile(envPath, 'utf8');
74
75
  expect(content).toContain('NODE_ENV=development');
75
- expect(content).toContain('AIOS_VERSION=2.1.0');
76
+ expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
76
77
  });
77
78
 
78
79
  it('should create .env.example file', async () => {