@polymorphism-tech/morph-spec 4.7.2 → 4.8.1

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 (346) hide show
  1. package/.morph/analytics/threads-log.jsonl +54 -5
  2. package/.morph/state.json +152 -2
  3. package/LICENSE +1 -2
  4. package/README.md +379 -414
  5. package/bin/morph-spec.js +57 -394
  6. package/bin/validate.js +2 -26
  7. package/claude-plugin.json +2 -2
  8. package/docs/ARCHITECTURE.md +43 -46
  9. package/docs/CHEATSHEET.md +203 -221
  10. package/docs/COMMAND-FLOWS.md +319 -289
  11. package/docs/QUICKSTART.md +2 -8
  12. package/docs/plans/2026-02-22-claude-docs-morph-alignment-analysis.md +2 -0
  13. package/docs/plans/2026-02-22-claude-settings.md +2 -0
  14. package/docs/plans/2026-02-22-morph-cc-alignment-impl.md +2 -0
  15. package/docs/plans/2026-02-22-morph-spec-next.md +2 -0
  16. package/docs/plans/2026-02-22-native-alignment-design.md +2 -0
  17. package/docs/plans/2026-02-22-native-alignment-impl.md +2 -0
  18. package/docs/plans/2026-02-22-native-enrichment-design.md +2 -0
  19. package/docs/plans/2026-02-22-native-enrichment.md +2 -0
  20. package/docs/plans/2026-02-23-ddd-architecture-refactor.md +2 -0
  21. package/docs/plans/2026-02-23-ddd-nextsteps.md +2 -0
  22. package/docs/plans/2026-02-23-infra-architect-refactor.md +2 -0
  23. package/docs/plans/2026-02-23-nextjs-code-review-design.md +2 -1
  24. package/docs/plans/2026-02-23-nextjs-code-review-impl.md +2 -0
  25. package/docs/plans/2026-02-23-nextjs-standards-design.md +2 -1
  26. package/docs/plans/2026-02-23-nextjs-standards-impl.md +2 -0
  27. package/docs/plans/2026-02-24-cli-radical-simplification.md +592 -0
  28. package/docs/plans/2026-02-24-framework-failure-points.md +125 -0
  29. package/docs/plans/2026-02-24-morph-init-design.md +337 -0
  30. package/docs/plans/2026-02-24-morph-init-impl.md +1269 -0
  31. package/docs/plans/2026-02-24-tutorial-command-design.md +71 -0
  32. package/docs/plans/2026-02-24-tutorial-command.md +298 -0
  33. package/framework/CLAUDE.md +1 -1
  34. package/framework/commands/morph-proposal.md +3 -3
  35. package/framework/hooks/README.md +2 -5
  36. package/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js +4 -55
  37. package/framework/hooks/claude-code/session-start/inject-morph-context.js +20 -5
  38. package/framework/hooks/claude-code/statusline.py +6 -1
  39. package/framework/hooks/dev/check-sync-health.js +117 -0
  40. package/framework/hooks/dev/guard-version-numbers.js +57 -0
  41. package/framework/hooks/dev/sync-standards-registry.js +60 -0
  42. package/framework/hooks/dev/sync-template-registry.js +60 -0
  43. package/framework/hooks/dev/validate-skill-format.js +70 -0
  44. package/framework/hooks/dev/validate-standard-format.js +73 -0
  45. package/framework/hooks/shared/payload-utils.js +39 -0
  46. package/framework/hooks/shared/state-reader.js +25 -1
  47. package/framework/rules/morph-workflow.md +1 -1
  48. package/framework/skills/level-0-meta/morph-init/SKILL.md +216 -0
  49. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +4 -4
  50. package/framework/skills/level-0-meta/tool-usage-guide/SKILL.md +4 -4
  51. package/framework/skills/level-0-meta/verification-before-completion/SKILL.md +1 -1
  52. package/framework/skills/level-1-workflows/phase-clarify/SKILL.md +192 -191
  53. package/framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md +181 -180
  54. package/framework/skills/level-1-workflows/phase-design/SKILL.md +339 -338
  55. package/framework/skills/level-1-workflows/phase-implement/SKILL.md +254 -253
  56. package/framework/skills/level-1-workflows/phase-setup/SKILL.md +168 -170
  57. package/framework/skills/level-1-workflows/phase-tasks/SKILL.md +284 -283
  58. package/framework/skills/level-1-workflows/phase-uiux/SKILL.md +246 -245
  59. package/framework/templates/examples/design-system-examples.md +1 -1
  60. package/framework/templates/ui/FluentDesignTheme.cs +1 -1
  61. package/framework/templates/ui/MudTheme.cs +1 -1
  62. package/framework/templates/ui/design-system.css +1 -1
  63. package/package.json +4 -2
  64. package/scripts/bump-version.js +248 -0
  65. package/scripts/install-dev-hooks.js +138 -0
  66. package/src/commands/agents/index.js +1 -2
  67. package/src/commands/index.js +13 -16
  68. package/src/commands/project/doctor.js +100 -14
  69. package/src/commands/project/index.js +7 -10
  70. package/src/commands/project/init.js +398 -528
  71. package/src/commands/project/install-plugin-cmd.js +28 -0
  72. package/src/commands/project/setup-infra-cmd.js +12 -0
  73. package/src/commands/project/tutorial.js +115 -0
  74. package/src/commands/state/approve.js +213 -221
  75. package/src/commands/state/index.js +0 -1
  76. package/src/commands/state/state.js +337 -365
  77. package/src/commands/templates/index.js +0 -4
  78. package/src/commands/trust/trust.js +1 -93
  79. package/src/commands/utils/index.js +1 -5
  80. package/src/commands/validation/index.js +1 -5
  81. package/src/core/registry/command-registry.js +11 -285
  82. package/src/core/state/state-manager.js +5 -2
  83. package/src/lib/detectors/index.js +81 -87
  84. package/src/lib/detectors/structure-detector.js +275 -273
  85. package/src/lib/generators/recap-generator.js +232 -225
  86. package/src/scripts/global-install.js +34 -0
  87. package/src/scripts/install-plugin.js +126 -0
  88. package/src/scripts/setup-infra.js +203 -0
  89. package/src/utils/agents-installer.js +10 -1
  90. package/src/utils/hooks-installer.js +66 -3
  91. package/.morph/.morphversion +0 -5
  92. package/.morph/config/config.json +0 -8
  93. package/.morph/framework/agents.json +0 -1815
  94. package/.morph/framework/hooks/README.md +0 -205
  95. package/.morph/framework/hooks/claude-code/notification/approval-reminder.js +0 -54
  96. package/.morph/framework/hooks/claude-code/post-tool-use/dispatch.js +0 -83
  97. package/.morph/framework/hooks/claude-code/post-tool-use/handle-tool-failure.js +0 -42
  98. package/.morph/framework/hooks/claude-code/pre-compact/save-morph-context.js +0 -61
  99. package/.morph/framework/hooks/claude-code/pre-tool-use/enforce-phase-writes.js +0 -71
  100. package/.morph/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js +0 -58
  101. package/.morph/framework/hooks/claude-code/pre-tool-use/protect-spec-files.js +0 -64
  102. package/.morph/framework/hooks/claude-code/session-start/inject-morph-context.js +0 -94
  103. package/.morph/framework/hooks/claude-code/statusline.py +0 -538
  104. package/.morph/framework/hooks/claude-code/statusline.sh +0 -7
  105. package/.morph/framework/hooks/claude-code/stop/validate-completion.js +0 -88
  106. package/.morph/framework/hooks/claude-code/user-prompt/enrich-prompt.js +0 -91
  107. package/.morph/framework/hooks/git/commit-msg/conventional-commits.sh +0 -33
  108. package/.morph/framework/hooks/git/pre-commit/agents.sh +0 -25
  109. package/.morph/framework/hooks/git/pre-commit/orchestrator.sh +0 -64
  110. package/.morph/framework/hooks/git/pre-commit/specs.sh +0 -50
  111. package/.morph/framework/hooks/git/pre-push/run-tests.sh +0 -44
  112. package/.morph/framework/hooks/shared/hook-response.js +0 -45
  113. package/.morph/framework/hooks/shared/phase-utils.js +0 -129
  114. package/.morph/framework/hooks/shared/state-reader.js +0 -138
  115. package/.morph/framework/hooks/shared/stdin-reader.js +0 -26
  116. package/.morph/framework/standards/STANDARDS.json +0 -933
  117. package/.morph/framework/standards/ai-agents/blazor-ui.md +0 -364
  118. package/.morph/framework/standards/ai-agents/production.md +0 -415
  119. package/.morph/framework/standards/ai-agents/setup.md +0 -418
  120. package/.morph/framework/standards/ai-agents/team-orchestration.md +0 -479
  121. package/.morph/framework/standards/ai-agents/workflows.md +0 -354
  122. package/.morph/framework/standards/architecture/ddd/aggregates.md +0 -120
  123. package/.morph/framework/standards/architecture/ddd/bounded-contexts.md +0 -105
  124. package/.morph/framework/standards/architecture/ddd/complexity-levels.md +0 -108
  125. package/.morph/framework/standards/architecture/ddd/entities.md +0 -99
  126. package/.morph/framework/standards/architecture/ddd/ubiquitous-language.md +0 -58
  127. package/.morph/framework/standards/architecture/ddd/value-objects.md +0 -124
  128. package/.morph/framework/standards/backend/api/minimal-api.md +0 -494
  129. package/.morph/framework/standards/backend/api/rest.md +0 -492
  130. package/.morph/framework/standards/backend/api/validation.md +0 -88
  131. package/.morph/framework/standards/backend/authentication/passkeys.md +0 -428
  132. package/.morph/framework/standards/backend/database/ef-core.md +0 -199
  133. package/.morph/framework/standards/backend/database/migrations.md +0 -393
  134. package/.morph/framework/standards/backend/database/postgresql/database.md +0 -352
  135. package/.morph/framework/standards/backend/database/repository-patterns.md +0 -528
  136. package/.morph/framework/standards/backend/database/vector-search-rag.md +0 -541
  137. package/.morph/framework/standards/backend/dotnet/async.md +0 -366
  138. package/.morph/framework/standards/backend/dotnet/core.md +0 -117
  139. package/.morph/framework/standards/backend/dotnet/di.md +0 -439
  140. package/.morph/framework/standards/backend/dotnet/program-cs-checklist.md +0 -92
  141. package/.morph/framework/standards/backend/integrations/asaas/asaas-api.md +0 -216
  142. package/.morph/framework/standards/backend/integrations/clerk/clerk-auth.md +0 -290
  143. package/.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -350
  144. package/.morph/framework/standards/backend/integrations/resend/resend-email.md +0 -385
  145. package/.morph/framework/standards/context/analytics.md +0 -96
  146. package/.morph/framework/standards/context/bundles.md +0 -110
  147. package/.morph/framework/standards/context/priming.md +0 -78
  148. package/.morph/framework/standards/core/architecture.md +0 -185
  149. package/.morph/framework/standards/core/coding.md +0 -214
  150. package/.morph/framework/standards/core/git-branching-strategy.md +0 -403
  151. package/.morph/framework/standards/core/git.md +0 -185
  152. package/.morph/framework/standards/core/testing.md +0 -295
  153. package/.morph/framework/standards/data/nosql/blob-storage.md +0 -102
  154. package/.morph/framework/standards/data/nosql/cache/redis.md +0 -97
  155. package/.morph/framework/standards/data/nosql/cosmos-db.md +0 -118
  156. package/.morph/framework/standards/data/vector-search/azure-ai-search.md +0 -121
  157. package/.morph/framework/standards/data/vector-search/rag-chunking.md +0 -104
  158. package/.morph/framework/standards/frontend/blazor/design-checklist.md +0 -222
  159. package/.morph/framework/standards/frontend/blazor/fluent-ui-setup.md +0 -595
  160. package/.morph/framework/standards/frontend/blazor/fluent-ui.md +0 -137
  161. package/.morph/framework/standards/frontend/blazor/html-conversion.md +0 -184
  162. package/.morph/framework/standards/frontend/blazor/lifecycle.md +0 -195
  163. package/.morph/framework/standards/frontend/blazor/pitfalls.md +0 -198
  164. package/.morph/framework/standards/frontend/blazor/state.md +0 -191
  165. package/.morph/framework/standards/frontend/design-system/animations.md +0 -151
  166. package/.morph/framework/standards/frontend/design-system/naming.md +0 -64
  167. package/.morph/framework/standards/frontend/nextjs/app-router.md +0 -123
  168. package/.morph/framework/standards/frontend/nextjs/components.md +0 -132
  169. package/.morph/framework/standards/frontend/nextjs/data-fetching.md +0 -126
  170. package/.morph/framework/standards/frontend/nextjs/forms.md +0 -128
  171. package/.morph/framework/standards/frontend/nextjs/naming-conventions.md +0 -67
  172. package/.morph/framework/standards/frontend/nextjs/nextjs-patterns.md +0 -215
  173. package/.morph/framework/standards/frontend/nextjs/project-structure.md +0 -102
  174. package/.morph/framework/standards/frontend/nextjs/state-management.md +0 -72
  175. package/.morph/framework/standards/frontend/nextjs/testing.md +0 -111
  176. package/.morph/framework/standards/infrastructure/azure/azure.md +0 -624
  177. package/.morph/framework/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -422
  178. package/.morph/framework/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -516
  179. package/.morph/framework/standards/infrastructure/azure/devops/local-development.md +0 -520
  180. package/.morph/framework/standards/infrastructure/azure/services/functions.md +0 -486
  181. package/.morph/framework/standards/infrastructure/azure/services/service-bus.md +0 -459
  182. package/.morph/framework/standards/infrastructure/azure/services/storage.md +0 -407
  183. package/.morph/framework/standards/infrastructure/docker/easypanel-deploy.md +0 -196
  184. package/.morph/framework/standards/infrastructure/supabase/mcp-setup.md +0 -252
  185. package/.morph/framework/standards/infrastructure/supabase/supabase-auth.md +0 -176
  186. package/.morph/framework/standards/infrastructure/supabase/supabase-pgvector.md +0 -169
  187. package/.morph/framework/standards/infrastructure/supabase/supabase-rls.md +0 -184
  188. package/.morph/framework/standards/infrastructure/supabase/supabase-storage.md +0 -153
  189. package/.morph/framework/standards/integration/api/graphql.md +0 -91
  190. package/.morph/framework/standards/integration/api/grpc.md +0 -114
  191. package/.morph/framework/standards/integration/api/rest-design.md +0 -95
  192. package/.morph/framework/standards/integration/event-driven/cqrs.md +0 -101
  193. package/.morph/framework/standards/integration/event-driven/event-sourcing.md +0 -124
  194. package/.morph/framework/standards/integration/event-driven/service-bus.md +0 -95
  195. package/.morph/framework/standards/integration/mcp/mcp-tools.md +0 -384
  196. package/.morph/framework/standards/observability/logging.md +0 -131
  197. package/.morph/framework/standards/observability/metrics.md +0 -121
  198. package/.morph/framework/standards/observability/monitoring.md +0 -114
  199. package/.morph/framework/standards/observability/tracing.md +0 -132
  200. package/.morph/framework/standards/workflows/parallel-execution.md +0 -112
  201. package/.morph/framework/standards/workflows/thread-management.md +0 -113
  202. package/.morph/framework/templates/.idea/morph-templates.xml +0 -92
  203. package/.morph/framework/templates/.vscode/morph-templates.code-snippets +0 -186
  204. package/.morph/framework/templates/IDE-SNIPPETS.md +0 -266
  205. package/.morph/framework/templates/README.md +0 -814
  206. package/.morph/framework/templates/REGISTRY.json +0 -1888
  207. package/.morph/framework/templates/code/dotnet/backend/repository.cs +0 -141
  208. package/.morph/framework/templates/code/dotnet/backend/service.cs +0 -139
  209. package/.morph/framework/templates/code/dotnet/contracts/Commands.cs +0 -74
  210. package/.morph/framework/templates/code/dotnet/contracts/Entities.cs +0 -25
  211. package/.morph/framework/templates/code/dotnet/contracts/Queries.cs +0 -74
  212. package/.morph/framework/templates/code/dotnet/contracts/README.md +0 -74
  213. package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs +0 -173
  214. package/.morph/framework/templates/code/dotnet/contracts/contracts-level1.cs +0 -69
  215. package/.morph/framework/templates/code/dotnet/contracts/contracts-level2.cs +0 -86
  216. package/.morph/framework/templates/code/dotnet/contracts/contracts-level3.cs +0 -41
  217. package/.morph/framework/templates/code/dotnet/database/migration.cs +0 -83
  218. package/.morph/framework/templates/code/dotnet/frontend/component.razor +0 -239
  219. package/.morph/framework/templates/code/dotnet/jobs/agent.cs +0 -163
  220. package/.morph/framework/templates/code/dotnet/jobs/job.cs +0 -171
  221. package/.morph/framework/templates/code/dotnet/test.cs +0 -239
  222. package/.morph/framework/templates/code/sql/rls-policy.sql +0 -57
  223. package/.morph/framework/templates/code/sql/supabase-migration.sql +0 -100
  224. package/.morph/framework/templates/code/sql/supabase-migration.template.sql +0 -113
  225. package/.morph/framework/templates/code/typescript/contracts.ts +0 -168
  226. package/.morph/framework/templates/context/CONTEXT-FEATURE.md +0 -276
  227. package/.morph/framework/templates/context/CONTEXT.md +0 -181
  228. package/.morph/framework/templates/docs/clarifications.md +0 -253
  229. package/.morph/framework/templates/docs/onboarding.md +0 -123
  230. package/.morph/framework/templates/docs/proposal.md +0 -182
  231. package/.morph/framework/templates/docs/schema-analysis.md +0 -119
  232. package/.morph/framework/templates/docs/spec.md +0 -198
  233. package/.morph/framework/templates/docs/ui-components.md +0 -124
  234. package/.morph/framework/templates/docs/ui-design-system.md +0 -76
  235. package/.morph/framework/templates/docs/ui-flows.md +0 -167
  236. package/.morph/framework/templates/docs/ui-mockups.md +0 -98
  237. package/.morph/framework/templates/docs/user-stories.md +0 -34
  238. package/.morph/framework/templates/examples/design-system-examples.md +0 -357
  239. package/.morph/framework/templates/examples/spec-examples.md +0 -90
  240. package/.morph/framework/templates/feature/decisions.md +0 -187
  241. package/.morph/framework/templates/feature/recap.md +0 -146
  242. package/.morph/framework/templates/feature/tasks.md +0 -199
  243. package/.morph/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +0 -43
  244. package/.morph/framework/templates/frontend/nextjs/client-component.tsx.hbs +0 -26
  245. package/.morph/framework/templates/frontend/nextjs/env.mjs.hbs +0 -32
  246. package/.morph/framework/templates/frontend/nextjs/feature-form.tsx.hbs +0 -56
  247. package/.morph/framework/templates/frontend/nextjs/page.tsx.hbs +0 -22
  248. package/.morph/framework/templates/frontend/nextjs/tsconfig.json.hbs +0 -26
  249. package/.morph/framework/templates/frontend/nextjs/use-feature.ts.hbs +0 -54
  250. package/.morph/framework/templates/infrastructure/azure/Dockerfile.example +0 -82
  251. package/.morph/framework/templates/infrastructure/azure/README.md +0 -286
  252. package/.morph/framework/templates/infrastructure/azure/app-insights.bicep +0 -63
  253. package/.morph/framework/templates/infrastructure/azure/app-service.bicep +0 -164
  254. package/.morph/framework/templates/infrastructure/azure/container-app-env.bicep +0 -49
  255. package/.morph/framework/templates/infrastructure/azure/container-app.bicep +0 -156
  256. package/.morph/framework/templates/infrastructure/azure/deploy-checklist.md +0 -426
  257. package/.morph/framework/templates/infrastructure/azure/deploy.ps1 +0 -229
  258. package/.morph/framework/templates/infrastructure/azure/deploy.sh +0 -208
  259. package/.morph/framework/templates/infrastructure/azure/key-vault.bicep +0 -91
  260. package/.morph/framework/templates/infrastructure/azure/main.bicep +0 -189
  261. package/.morph/framework/templates/infrastructure/azure/parameters.dev.json +0 -29
  262. package/.morph/framework/templates/infrastructure/azure/parameters.prod.json +0 -29
  263. package/.morph/framework/templates/infrastructure/azure/parameters.staging.json +0 -29
  264. package/.morph/framework/templates/infrastructure/azure/sql-database.bicep +0 -103
  265. package/.morph/framework/templates/infrastructure/azure/storage.bicep +0 -106
  266. package/.morph/framework/templates/infrastructure/docker/Dockerfile.template +0 -58
  267. package/.morph/framework/templates/infrastructure/docker/docker-compose.template.yml +0 -67
  268. package/.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +0 -38
  269. package/.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +0 -48
  270. package/.morph/framework/templates/infrastructure/docker/easypanel.template.json +0 -54
  271. package/.morph/framework/templates/infrastructure/github/README.md +0 -593
  272. package/.morph/framework/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +0 -22
  273. package/.morph/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +0 -45
  274. package/.morph/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +0 -27
  275. package/.morph/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +0 -61
  276. package/.morph/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +0 -31
  277. package/.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +0 -59
  278. package/.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +0 -39
  279. package/.morph/framework/templates/integrations/asaas-client.cs +0 -387
  280. package/.morph/framework/templates/integrations/asaas-webhook.cs +0 -351
  281. package/.morph/framework/templates/integrations/azure-identity-config.cs +0 -288
  282. package/.morph/framework/templates/integrations/clerk-config.cs +0 -258
  283. package/.morph/framework/templates/meta-prompts/fusion/fusion-agent.md +0 -76
  284. package/.morph/framework/templates/meta-prompts/fusion/fusion-aggregator.md +0 -100
  285. package/.morph/framework/templates/meta-prompts/hops/hop-retry.md +0 -78
  286. package/.morph/framework/templates/meta-prompts/hops/hop-validation.md +0 -97
  287. package/.morph/framework/templates/meta-prompts/hops/hop-wrapper.md +0 -36
  288. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  289. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  290. package/.morph/framework/templates/meta-prompts/squad-leaders/backend-squad.md +0 -90
  291. package/.morph/framework/templates/meta-prompts/squad-leaders/frontend-squad.md +0 -126
  292. package/.morph/framework/templates/meta-prompts/squad-leaders/squad-leader.md +0 -43
  293. package/.morph/framework/templates/meta-prompts/validators/checkpoint-validator.md +0 -107
  294. package/.morph/framework/templates/meta-prompts/validators/pre-commit-validator.md +0 -95
  295. package/.morph/framework/templates/project-structure/dotnet-ddd.md +0 -70
  296. package/.morph/framework/templates/saas/subscription.cs +0 -347
  297. package/.morph/framework/templates/saas/tenant.cs +0 -338
  298. package/.morph/framework/templates/state.template.json +0 -17
  299. package/.morph/framework/templates/ui/FluentDesignTheme.cs +0 -149
  300. package/.morph/framework/templates/ui/MudTheme.cs +0 -281
  301. package/.morph/framework/templates/ui/design-system.css +0 -226
  302. package/.morph/logs/tool-failures.log +0 -17
  303. package/.morph/memory/pre-compact-2026-02-24T17-43-30-049Z.json +0 -16
  304. package/.morph/plans/eager-watching-bunny.md +0 -105
  305. package/.morph/plans/temporal-seeking-nebula.md +0 -45
  306. package/CLAUDE.md +0 -77
  307. package/docs/claude-alignment-report.md +0 -137
  308. package/docs/examples/order-management/contracts.cs +0 -84
  309. package/docs/examples/order-management/proposal.md +0 -24
  310. package/docs/examples/order-management/spec.md +0 -162
  311. package/src/commands/feature/create-story.js +0 -362
  312. package/src/commands/feature/index.js +0 -6
  313. package/src/commands/feature/shard-spec.js +0 -225
  314. package/src/commands/feature/sprint-status.js +0 -250
  315. package/src/commands/generation/generate-onboarding.js +0 -169
  316. package/src/commands/generation/generate.js +0 -276
  317. package/src/commands/generation/index.js +0 -5
  318. package/src/commands/learning/capture-pattern.js +0 -121
  319. package/src/commands/learning/index.js +0 -5
  320. package/src/commands/learning/search-patterns.js +0 -126
  321. package/src/commands/mcp/mcp.js +0 -102
  322. package/src/commands/project/changes.js +0 -66
  323. package/src/commands/project/cost.js +0 -179
  324. package/src/commands/project/diff.js +0 -278
  325. package/src/commands/project/revert.js +0 -173
  326. package/src/commands/project/standards.js +0 -80
  327. package/src/commands/project/sync.js +0 -167
  328. package/src/commands/project/update-agents.js +0 -23
  329. package/src/commands/state/rollback-phase.js +0 -185
  330. package/src/commands/templates/template-customize.js +0 -87
  331. package/src/commands/templates/template-list.js +0 -114
  332. package/src/commands/templates/template-show.js +0 -129
  333. package/src/commands/templates/template-validate.js +0 -91
  334. package/src/commands/utils/troubleshoot.js +0 -222
  335. package/src/commands/validation/analyze-blazor-concurrency.js +0 -193
  336. package/src/commands/validation/lint-fluent.js +0 -352
  337. package/src/commands/validation/validate-blazor-state.js +0 -210
  338. package/src/commands/validation/validate-blazor.js +0 -156
  339. package/src/commands/validation/validate-css.js +0 -84
  340. package/src/lib/detectors/conversation-analyzer.js +0 -163
  341. package/src/lib/learning/index.js +0 -7
  342. package/src/lib/learning/learning-system.js +0 -520
  343. package/src/lib/troubleshooting/index.js +0 -8
  344. package/src/lib/troubleshooting/troubleshoot-grep.js +0 -198
  345. package/src/lib/troubleshooting/troubleshoot-index.js +0 -144
  346. package/src/llm/environment-detector.js +0 -43
@@ -1,8 +1,4 @@
1
1
  /**
2
2
  * Template Commands
3
3
  */
4
- export { templateListCommand } from './template-list.js';
5
- export { templateShowCommand } from './template-show.js';
6
4
  export { templateRenderCommand } from './template-render.js';
7
- export { templateCustomizeCommand } from './template-customize.js';
8
- export { templateValidateCommand } from './template-validate.js';
@@ -4,17 +4,13 @@
4
4
  * Usage:
5
5
  * morph-spec trust status [feature]
6
6
  * morph-spec trust set <feature> <level> [reason]
7
- * morph-spec trust history
8
- * morph-spec trust auto-calculate <feature>
9
7
  */
10
8
 
11
9
  import chalk from 'chalk';
12
10
  import {
13
11
  getTrust,
14
12
  setTrust,
15
- clearTrustOverride,
16
13
  getTrustHistory,
17
- autoCalculateTrust,
18
14
  TRUST_THRESHOLDS,
19
15
  AUTO_APPROVE_GATES
20
16
  } from '../../lib/trust/trust-manager.js';
@@ -108,98 +104,10 @@ export async function trustSetCommand(featureName, level, reason, options) {
108
104
  console.log(` Level: ${result.level}`);
109
105
  console.log(` Auto-approves: ${result.autoApprove.join(', ') || 'none'}`);
110
106
  console.log(` Reason: ${result.reason}`);
111
- console.log(chalk.gray('\n Note: Use "trust auto-calculate" to revert to calculated trust.\n'));
107
+ console.log(chalk.gray('\n Note: Trust reverts to calculated level after next checkpoint.\n'));
112
108
  } catch (err) {
113
109
  console.error(chalk.red(`Error: ${err.message}`));
114
110
  process.exit(1);
115
111
  }
116
112
  }
117
113
 
118
- /**
119
- * Trust history — table of all features with checkpoint pass rates
120
- */
121
- export async function trustHistoryCommand(options) {
122
- const history = getTrustHistory();
123
-
124
- console.log(chalk.bold('\n Trust History'));
125
- console.log(' ' + '─'.repeat(80));
126
-
127
- if (history.length === 0) {
128
- console.log(chalk.gray(' No features found.\n'));
129
- return;
130
- }
131
-
132
- for (const f of history) {
133
- const levelColor = f.level === 'maximum' ? chalk.green
134
- : f.level === 'high' ? chalk.cyan
135
- : f.level === 'medium' ? chalk.yellow
136
- : chalk.red;
137
-
138
- console.log(`\n ${chalk.bold(f.feature)}`);
139
- console.log(` Trust: ${levelColor(f.level)} (${Math.round(f.passRate * 100)}% pass rate)`);
140
- console.log(` Checkpoints: ${f.checkpointsPassed}/${f.checkpointsTotal} passed`);
141
- console.log(` Phase: ${f.phase || 'N/A'} | Status: ${f.status || 'N/A'}`);
142
- console.log(` Source: ${f.source}`);
143
-
144
- if (f.autoApprove.length > 0) {
145
- console.log(` Auto-approves: ${chalk.green(f.autoApprove.join(', '))}`);
146
- }
147
- }
148
-
149
- console.log('\n ' + '─'.repeat(80));
150
- console.log(chalk.gray(` Total features: ${history.length}\n`));
151
- }
152
-
153
- /**
154
- * Trust auto-calculate — recalculate from checkpoint history
155
- */
156
- export async function trustAutoCalculateCommand(featureName, options) {
157
- if (!featureName) {
158
- console.error(chalk.red('Usage: morph-spec trust auto-calculate <feature>'));
159
- process.exit(1);
160
- }
161
-
162
- try {
163
- const result = autoCalculateTrust(featureName);
164
-
165
- const levelColor = result.level === 'maximum' ? chalk.green
166
- : result.level === 'high' ? chalk.cyan
167
- : result.level === 'medium' ? chalk.yellow
168
- : chalk.red;
169
-
170
- console.log(chalk.bold(`\n Trust Calculated — ${featureName}`));
171
- console.log(' ' + '─'.repeat(40));
172
- console.log(` Level: ${levelColor(result.level.toUpperCase())}`);
173
- console.log(` Pass Rate: ${Math.round(result.passRate * 100)}%`);
174
- console.log(` Checkpoints: ${result.passed}/${result.total} passed`);
175
- console.log(` Auto-approves: ${result.autoApprove.join(', ') || 'none'}`);
176
-
177
- if (result.level === 'maximum') {
178
- console.log(chalk.green('\n ✓ Feature is eligible for zero-touch execution!'));
179
- console.log(chalk.gray(' All gates will be auto-approved.\n'));
180
- } else {
181
- const nextLevel = result.passRate < TRUST_THRESHOLDS.medium ? 'medium'
182
- : result.passRate < TRUST_THRESHOLDS.high ? 'high'
183
- : 'maximum';
184
- const needed = Math.ceil(TRUST_THRESHOLDS[nextLevel] * result.total) - result.passed;
185
- console.log(chalk.gray(`\n Next level: ${nextLevel} (need ${needed} more passing checkpoints)\n`));
186
- }
187
- } catch (err) {
188
- console.error(chalk.red(`Error: ${err.message}`));
189
- process.exit(1);
190
- }
191
- }
192
-
193
- /**
194
- * Trust clear — remove manual override
195
- */
196
- export async function trustClearCommand(featureName, options) {
197
- if (!featureName) {
198
- console.error(chalk.red('Usage: morph-spec trust clear <feature>'));
199
- process.exit(1);
200
- }
201
-
202
- clearTrustOverride(featureName);
203
- console.log(chalk.green(`\n✓ Manual trust override cleared for ${featureName}`));
204
- console.log(chalk.gray(' Trust will now be calculated from checkpoint history.\n'));
205
- }
@@ -1,7 +1,3 @@
1
1
  /**
2
- * Utility Commands
2
+ * Utility Commands — no active commands after CLI simplification
3
3
  */
4
- export { troubleshootCommand } from './troubleshoot.js';
5
- export { sessionSummaryCommand } from './session-summary.js';
6
- export { migrateStateCommand } from './migrate-state.js';
7
- export { upgradeCommand } from './upgrade.js';
@@ -1,8 +1,4 @@
1
1
  /**
2
2
  * Validation Commands
3
3
  */
4
- export { validateBlazorCommand } from './validate-blazor.js';
5
- export { validateBlazorStateCommand } from './validate-blazor-state.js';
6
- export { validateCssCommand } from './validate-css.js';
7
- export { analyzeBlazorConcurrencyCommand } from './analyze-blazor-concurrency.js';
8
- export { lintFluentCommand } from './lint-fluent.js';
4
+ export { validateFeatureCommand } from './validate-feature.js';
@@ -1,302 +1,28 @@
1
1
  /**
2
- * Command Registry - Auto-Discovery System
2
+ * Command Registry DEPRECATED
3
3
  *
4
- * Metadata-driven command loading eliminates hardcoded imports.
5
- * Enables dynamic command registration and discovery.
4
+ * This module is no longer used. CLI commands are registered directly
5
+ * in bin/morph-spec.js via Commander.js. This file is kept as an empty
6
+ * stub to prevent import errors from any remaining references.
6
7
  *
7
8
  * @module command-registry
9
+ * @deprecated
8
10
  */
9
11
 
10
- /**
11
- * Command Metadata Registry
12
- *
13
- * Maps command names to their module paths and metadata.
14
- * Auto-discovered from src/commands/{category}/ structure.
15
- */
16
- export const commandMetadata = {
17
- // Feature Management
18
- 'create-story': {
19
- category: 'feature',
20
- description: 'Create a new user story with acceptance criteria',
21
- module: () => import('../../commands/feature/create-story.js'),
22
- exportName: 'createStoryCommand',
23
- },
24
- 'shard-spec': {
25
- category: 'feature',
26
- description: 'Shard a large spec into manageable chunks',
27
- module: () => import('../../commands/feature/shard-spec.js'),
28
- exportName: 'shardSpecCommand',
29
- },
30
- 'sprint-status': {
31
- category: 'feature',
32
- description: 'Show sprint progress and completion status',
33
- module: () => import('../../commands/feature/sprint-status.js'),
34
- exportName: 'sprintStatusCommand',
35
- },
36
-
37
- // State Management
38
- 'state': {
39
- category: 'state',
40
- description: 'Manage feature state (init, get, set, list)',
41
- module: () => import('../../commands/state/state.js'),
42
- exportName: 'stateCommand',
43
- },
44
- 'advance-phase': {
45
- category: 'state',
46
- description: 'Advance feature to next phase with validation',
47
- module: () => import('../../commands/state/advance-phase.js'),
48
- exportName: 'advancePhaseCommand',
49
- },
50
- 'rollback-phase': {
51
- category: 'state',
52
- description: 'Rollback feature to previous phase',
53
- module: () => import('../../commands/state/rollback-phase.js'),
54
- exportName: 'rollbackPhaseCommand',
55
- },
56
- 'approve': {
57
- category: 'state',
58
- description: 'Approve or reject approval gates',
59
- module: () => import('../../commands/state/approve.js'),
60
- exportName: 'approveCommand',
61
- },
62
- 'validate-phase': {
63
- category: 'state',
64
- description: 'Validate phase transition requirements',
65
- module: () => import('../../commands/state/validate-phase.js'),
66
- exportName: 'validatePhaseCommand',
67
- },
68
-
69
- // Generation
70
- 'generate': {
71
- category: 'generation',
72
- description: 'Generate design system files from spec',
73
- module: () => import('../../commands/generation/generate.js'),
74
- exportName: 'generateCommand',
75
- },
76
- 'generate-context': {
77
- category: 'generation',
78
- description: 'Generate CONTEXT.md for LLM agents',
79
- module: () => import('../../commands/generation/generate-context.js'),
80
- exportName: 'generateContextCommand',
81
- },
82
-
83
- // Validation
84
- 'validate-blazor': {
85
- category: 'validation',
86
- description: 'Validate Blazor components and patterns',
87
- module: () => import('../../commands/validation/validate-blazor.js'),
88
- exportName: 'validateBlazorCommand',
89
- },
90
- 'validate-blazor-state': {
91
- category: 'validation',
92
- description: 'Validate Blazor state management patterns',
93
- module: () => import('../../commands/validation/validate-blazor-state.js'),
94
- exportName: 'validateBlazorStateCommand',
95
- },
96
- 'validate-css': {
97
- category: 'validation',
98
- description: 'Validate CSS classes and design system',
99
- module: () => import('../../commands/validation/validate-css.js'),
100
- exportName: 'validateCssCommand',
101
- },
102
- 'analyze-blazor-concurrency': {
103
- category: 'validation',
104
- description: 'Analyze Blazor concurrency issues',
105
- module: () => import('../../commands/validation/analyze-blazor-concurrency.js'),
106
- exportName: 'analyzeBlazorConcurrencyCommand',
107
- },
108
- 'lint-fluent': {
109
- category: 'validation',
110
- description: 'Lint Fluent UI Blazor usage',
111
- module: () => import('../../commands/validation/lint-fluent.js'),
112
- exportName: 'lintFluentCommand',
113
- },
114
-
115
- // Templates
116
- 'template-list': {
117
- category: 'templates',
118
- description: 'List available templates',
119
- module: () => import('../../commands/templates/template-list.js'),
120
- exportName: 'templateListCommand',
121
- },
122
- 'template-show': {
123
- category: 'templates',
124
- description: 'Show template details and preview',
125
- module: () => import('../../commands/templates/template-show.js'),
126
- exportName: 'templateShowCommand',
127
- },
128
- 'template-render': {
129
- category: 'templates',
130
- description: 'Render template with variables',
131
- module: () => import('../../commands/templates/template-render.js'),
132
- exportName: 'templateRenderCommand',
133
- },
134
- 'template-customize': {
135
- category: 'templates',
136
- description: 'Customize template for stack',
137
- module: () => import('../../commands/templates/template-customize.js'),
138
- exportName: 'templateCustomizeCommand',
139
- },
140
- 'template-validate': {
141
- category: 'templates',
142
- description: 'Validate template structure',
143
- module: () => import('../../commands/templates/template-validate.js'),
144
- exportName: 'templateValidateCommand',
145
- },
12
+ export const commandMetadata = {};
146
13
 
147
- // Project
148
- 'init': {
149
- category: 'project',
150
- description: 'Initialize MORPH-SPEC in current directory',
151
- module: () => import('../../commands/project/init.js'),
152
- exportName: 'initCommand',
153
- },
154
- 'doctor': {
155
- category: 'project',
156
- description: 'Check project health and configuration',
157
- module: () => import('../../commands/project/doctor.js'),
158
- exportName: 'doctorCommand',
159
- },
160
- 'detect': {
161
- category: 'project',
162
- description: 'Auto-detect project stack and configuration',
163
- module: () => import('../../commands/project/detect.js'),
164
- exportName: 'detectCommand',
165
- },
166
- 'detect-workflow': {
167
- category: 'project',
168
- description: 'Detect appropriate workflow for request',
169
- module: () => import('../../commands/project/detect-workflow.js'),
170
- exportName: 'detectWorkflowCommand',
171
- },
172
- 'detect-agents': {
173
- category: 'project',
174
- description: 'Detect required agents for request',
175
- module: () => import('../../commands/project/detect-agents.js'),
176
- exportName: 'detectAgentsCommand',
177
- },
178
- 'sync': {
179
- category: 'project',
180
- description: 'Sync standards from framework',
181
- module: () => import('../../commands/project/sync.js'),
182
- exportName: 'syncCommand',
183
- },
184
- 'update': {
185
- category: 'project',
186
- description: 'Update MORPH-SPEC framework',
187
- module: () => import('../../commands/project/update.js'),
188
- exportName: 'updateCommand',
189
- },
190
-
191
- // Learning
192
- 'capture-pattern': {
193
- category: 'learning',
194
- description: 'Capture learned pattern to memory',
195
- module: () => import('../../commands/learning/capture-pattern.js'),
196
- exportName: 'capturePatternCommand',
197
- },
198
- 'search-patterns': {
199
- category: 'learning',
200
- description: 'Search learned patterns',
201
- module: () => import('../../commands/learning/search-patterns.js'),
202
- exportName: 'searchPatternsCommand',
203
- },
204
-
205
- // Tasks
206
- 'task': {
207
- category: 'tasks',
208
- description: 'Manage tasks (done, start, next)',
209
- module: () => import('../../commands/tasks/task.js'),
210
- exportName: 'taskCommand',
211
- },
212
-
213
- // Agents
214
- 'spawn-team': {
215
- category: 'agents',
216
- description: 'Spawn agent team for feature',
217
- module: () => import('../../commands/agents/spawn-team.js'),
218
- exportName: 'spawnTeamCommand',
219
- },
220
-
221
- // Utils
222
- 'troubleshoot': {
223
- category: 'utils',
224
- description: 'Troubleshoot common errors',
225
- module: () => import('../../commands/utils/troubleshoot.js'),
226
- exportName: 'troubleshootCommand',
227
- },
228
- 'session-summary': {
229
- category: 'utils',
230
- description: 'Generate session summary and recap',
231
- module: () => import('../../commands/utils/session-summary.js'),
232
- exportName: 'sessionSummaryCommand',
233
- },
234
- 'migrate-state': {
235
- category: 'utils',
236
- description: 'Migrate state to new version',
237
- module: () => import('../../commands/utils/migrate-state.js'),
238
- exportName: 'migrateStateCommand',
239
- },
240
- 'upgrade': {
241
- category: 'utils',
242
- description: 'Upgrade project to latest framework',
243
- module: () => import('../../commands/utils/upgrade.js'),
244
- exportName: 'upgradeCommand',
245
- },
246
- };
247
-
248
- /**
249
- * Load command dynamically
250
- *
251
- * @param {string} commandName - Command name (e.g., 'init', 'template-list')
252
- * @returns {Promise<Function>} Command function
253
- */
254
14
  export async function loadCommand(commandName) {
255
- const meta = commandMetadata[commandName];
256
-
257
- if (!meta) {
258
- const availableCommands = Object.keys(commandMetadata).join(', ');
259
- throw new Error(`Unknown command: ${commandName}\n\nAvailable: ${availableCommands}`);
260
- }
261
-
262
- const module = await meta.module();
263
- const commandFn = module[meta.exportName] || module.default;
264
-
265
- if (!commandFn) {
266
- throw new Error(`Command '${commandName}' module does not export '${meta.exportName}'`);
267
- }
268
-
269
- return commandFn;
15
+ throw new Error(`Command registry is deprecated. Use bin/morph-spec.js directly.`);
270
16
  }
271
17
 
272
- /**
273
- * Get all command names
274
- *
275
- * @returns {string[]} Array of command names
276
- */
277
18
  export function getAllCommandNames() {
278
- return Object.keys(commandMetadata);
19
+ return [];
279
20
  }
280
21
 
281
- /**
282
- * Get commands by category
283
- *
284
- * @param {string} category - Category name
285
- * @returns {string[]} Array of command names in category
286
- */
287
- export function getCommandsByCategory(category) {
288
- return Object.entries(commandMetadata)
289
- .filter(([_, meta]) => meta.category === category)
290
- .map(([name, _]) => name);
22
+ export function getCommandsByCategory() {
23
+ return [];
291
24
  }
292
25
 
293
- /**
294
- * Get all categories
295
- *
296
- * @returns {string[]} Array of unique category names
297
- */
298
26
  export function getAllCategories() {
299
- const categories = new Set();
300
- Object.values(commandMetadata).forEach(meta => categories.add(meta.category));
301
- return Array.from(categories).sort();
27
+ return [];
302
28
  }
@@ -5,7 +5,7 @@
5
5
  * Used both by CLI commands and internal automation.
6
6
  */
7
7
 
8
- import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
8
+ import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync } from 'fs';
9
9
  import { join, dirname } from 'path';
10
10
  import { detectWorkflow } from '../workflows/workflow-detector.js';
11
11
  import { getAllOutputPaths, getOutputPath } from '../paths/output-schema.js';
@@ -137,7 +137,10 @@ export function saveState(state) {
137
137
  mkdirSync(stateDir, { recursive: true });
138
138
  }
139
139
 
140
- writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf8');
140
+ // Atomic write: write to temp then rename to avoid partial-write corruption
141
+ const tmpPath = statePath + '.tmp';
142
+ writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf8');
143
+ renameSync(tmpPath, statePath);
141
144
  }
142
145
 
143
146
  /**
@@ -1,87 +1,81 @@
1
- /**
2
- * MORPH-SPEC Detectors - Main Orchestrator
3
- *
4
- * Coordinates all detection modules to build a complete picture of the project.
5
- */
6
-
7
- import { detectStructure } from './structure-detector.js';
8
- import { detectConfig } from './config-detector.js';
9
- import { analyzeConversation } from './conversation-analyzer.js';
10
- import { generateStandards } from './standards-generator.js';
11
-
12
- // Re-export individual detectors
13
- export * from './design-system-detector.js';
14
-
15
- /**
16
- * Main detection orchestrator
17
- * @param {string} projectPath - Path to project root
18
- * @param {Object} options - Detection options
19
- * @returns {Promise<Object>} Detection results
20
- */
21
- export async function detectProject(projectPath, options = {}) {
22
- const results = {
23
- path: projectPath,
24
- timestamp: new Date().toISOString(),
25
- structure: null,
26
- config: null,
27
- conversation: null,
28
- inferred: null
29
- };
30
-
31
- try {
32
- // 1. Detect structure (stack, architecture, patterns)
33
- if (options.structure !== false) {
34
- results.structure = await detectStructure(projectPath);
35
- }
36
-
37
- // 2. Detect config (technologies, dependencies, versions)
38
- if (options.config !== false) {
39
- results.config = await detectConfig(projectPath);
40
- }
41
-
42
- // 3. Analyze conversation history (if available)
43
- if (options.conversation !== false) {
44
- results.conversation = await analyzeConversation(projectPath);
45
- }
46
-
47
- // 4. Generate inferred standards
48
- if (options.generateStandards !== false) {
49
- results.inferred = await generateStandards(results);
50
- }
51
-
52
- return results;
53
- } catch (error) {
54
- throw new Error(`Detection failed: ${error.message}`);
55
- }
56
- }
57
-
58
- /**
59
- * Get detection summary
60
- * @param {Object} results - Detection results
61
- * @returns {string} Human-readable summary
62
- */
63
- export function getDetectionSummary(results) {
64
- const { structure, config } = results;
65
-
66
- const lines = [
67
- '## Detection Summary',
68
- '',
69
- '### Stack',
70
- `- **Type**: ${structure?.stack || 'unknown'}`,
71
- `- **Architecture**: ${structure?.architecture || 'unknown'}`,
72
- ...(structure?.uiLibrary ? [`- **UI Library**: ${structure.uiLibrary}`] : []),
73
- '',
74
- '### Technologies',
75
- `- **Language**: ${config?.language || 'unknown'}`,
76
- `- **Version**: ${config?.version || 'unknown'}`,
77
- `- **Package Manager**: ${config?.packageManager || 'unknown'}`,
78
- '',
79
- '### Patterns Detected',
80
- ...(structure?.patterns || []).map(p => `- ${p}`),
81
- '',
82
- '### Recommendations',
83
- ...(results.inferred?.recommendations || []).map(r => `- ${r}`)
84
- ];
85
-
86
- return lines.join('\n');
87
- }
1
+ /**
2
+ * MORPH-SPEC Detectors - Main Orchestrator
3
+ *
4
+ * Coordinates all detection modules to build a complete picture of the project.
5
+ */
6
+
7
+ import { detectStructure } from './structure-detector.js';
8
+ import { detectConfig } from './config-detector.js';
9
+ import { generateStandards } from './standards-generator.js';
10
+
11
+ // Re-export individual detectors
12
+ export * from './design-system-detector.js';
13
+
14
+ /**
15
+ * Main detection orchestrator
16
+ * @param {string} projectPath - Path to project root
17
+ * @param {Object} options - Detection options
18
+ * @returns {Promise<Object>} Detection results
19
+ */
20
+ export async function detectProject(projectPath, options = {}) {
21
+ const results = {
22
+ path: projectPath,
23
+ timestamp: new Date().toISOString(),
24
+ structure: null,
25
+ config: null,
26
+ conversation: null,
27
+ inferred: null
28
+ };
29
+
30
+ try {
31
+ // 1. Detect structure (stack, architecture, patterns)
32
+ if (options.structure !== false) {
33
+ results.structure = await detectStructure(projectPath);
34
+ }
35
+
36
+ // 2. Detect config (technologies, dependencies, versions)
37
+ if (options.config !== false) {
38
+ results.config = await detectConfig(projectPath);
39
+ }
40
+
41
+ // 3. Generate inferred standards
42
+ if (options.generateStandards !== false) {
43
+ results.inferred = await generateStandards(results);
44
+ }
45
+
46
+ return results;
47
+ } catch (error) {
48
+ throw new Error(`Detection failed: ${error.message}`);
49
+ }
50
+ }
51
+
52
+ /**
53
+ * Get detection summary
54
+ * @param {Object} results - Detection results
55
+ * @returns {string} Human-readable summary
56
+ */
57
+ export function getDetectionSummary(results) {
58
+ const { structure, config } = results;
59
+
60
+ const lines = [
61
+ '## Detection Summary',
62
+ '',
63
+ '### Stack',
64
+ `- **Type**: ${structure?.stack || 'unknown'}`,
65
+ `- **Architecture**: ${structure?.architecture || 'unknown'}`,
66
+ ...(structure?.uiLibrary ? [`- **UI Library**: ${structure.uiLibrary}`] : []),
67
+ '',
68
+ '### Technologies',
69
+ `- **Language**: ${config?.language || 'unknown'}`,
70
+ `- **Version**: ${config?.version || 'unknown'}`,
71
+ `- **Package Manager**: ${config?.packageManager || 'unknown'}`,
72
+ '',
73
+ '### Patterns Detected',
74
+ ...(structure?.patterns || []).map(p => `- ${p}`),
75
+ '',
76
+ '### Recommendations',
77
+ ...(results.inferred?.recommendations || []).map(r => `- ${r}`)
78
+ ];
79
+
80
+ return lines.join('\n');
81
+ }