@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.
- package/.morph/analytics/threads-log.jsonl +54 -5
- package/.morph/state.json +152 -2
- package/LICENSE +1 -2
- package/README.md +379 -414
- package/bin/morph-spec.js +57 -394
- package/bin/validate.js +2 -26
- package/claude-plugin.json +2 -2
- package/docs/ARCHITECTURE.md +43 -46
- package/docs/CHEATSHEET.md +203 -221
- package/docs/COMMAND-FLOWS.md +319 -289
- package/docs/QUICKSTART.md +2 -8
- package/docs/plans/2026-02-22-claude-docs-morph-alignment-analysis.md +2 -0
- package/docs/plans/2026-02-22-claude-settings.md +2 -0
- package/docs/plans/2026-02-22-morph-cc-alignment-impl.md +2 -0
- package/docs/plans/2026-02-22-morph-spec-next.md +2 -0
- package/docs/plans/2026-02-22-native-alignment-design.md +2 -0
- package/docs/plans/2026-02-22-native-alignment-impl.md +2 -0
- package/docs/plans/2026-02-22-native-enrichment-design.md +2 -0
- package/docs/plans/2026-02-22-native-enrichment.md +2 -0
- package/docs/plans/2026-02-23-ddd-architecture-refactor.md +2 -0
- package/docs/plans/2026-02-23-ddd-nextsteps.md +2 -0
- package/docs/plans/2026-02-23-infra-architect-refactor.md +2 -0
- package/docs/plans/2026-02-23-nextjs-code-review-design.md +2 -1
- package/docs/plans/2026-02-23-nextjs-code-review-impl.md +2 -0
- package/docs/plans/2026-02-23-nextjs-standards-design.md +2 -1
- package/docs/plans/2026-02-23-nextjs-standards-impl.md +2 -0
- package/docs/plans/2026-02-24-cli-radical-simplification.md +592 -0
- package/docs/plans/2026-02-24-framework-failure-points.md +125 -0
- package/docs/plans/2026-02-24-morph-init-design.md +337 -0
- package/docs/plans/2026-02-24-morph-init-impl.md +1269 -0
- package/docs/plans/2026-02-24-tutorial-command-design.md +71 -0
- package/docs/plans/2026-02-24-tutorial-command.md +298 -0
- package/framework/CLAUDE.md +1 -1
- package/framework/commands/morph-proposal.md +3 -3
- package/framework/hooks/README.md +2 -5
- package/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js +4 -55
- package/framework/hooks/claude-code/session-start/inject-morph-context.js +20 -5
- package/framework/hooks/claude-code/statusline.py +6 -1
- package/framework/hooks/dev/check-sync-health.js +117 -0
- package/framework/hooks/dev/guard-version-numbers.js +57 -0
- package/framework/hooks/dev/sync-standards-registry.js +60 -0
- package/framework/hooks/dev/sync-template-registry.js +60 -0
- package/framework/hooks/dev/validate-skill-format.js +70 -0
- package/framework/hooks/dev/validate-standard-format.js +73 -0
- package/framework/hooks/shared/payload-utils.js +39 -0
- package/framework/hooks/shared/state-reader.js +25 -1
- package/framework/rules/morph-workflow.md +1 -1
- package/framework/skills/level-0-meta/morph-init/SKILL.md +216 -0
- package/framework/skills/level-0-meta/morph-replicate/SKILL.md +4 -4
- package/framework/skills/level-0-meta/tool-usage-guide/SKILL.md +4 -4
- package/framework/skills/level-0-meta/verification-before-completion/SKILL.md +1 -1
- package/framework/skills/level-1-workflows/phase-clarify/SKILL.md +192 -191
- package/framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md +181 -180
- package/framework/skills/level-1-workflows/phase-design/SKILL.md +339 -338
- package/framework/skills/level-1-workflows/phase-implement/SKILL.md +254 -253
- package/framework/skills/level-1-workflows/phase-setup/SKILL.md +168 -170
- package/framework/skills/level-1-workflows/phase-tasks/SKILL.md +284 -283
- package/framework/skills/level-1-workflows/phase-uiux/SKILL.md +246 -245
- package/framework/templates/examples/design-system-examples.md +1 -1
- package/framework/templates/ui/FluentDesignTheme.cs +1 -1
- package/framework/templates/ui/MudTheme.cs +1 -1
- package/framework/templates/ui/design-system.css +1 -1
- package/package.json +4 -2
- package/scripts/bump-version.js +248 -0
- package/scripts/install-dev-hooks.js +138 -0
- package/src/commands/agents/index.js +1 -2
- package/src/commands/index.js +13 -16
- package/src/commands/project/doctor.js +100 -14
- package/src/commands/project/index.js +7 -10
- package/src/commands/project/init.js +398 -528
- package/src/commands/project/install-plugin-cmd.js +28 -0
- package/src/commands/project/setup-infra-cmd.js +12 -0
- package/src/commands/project/tutorial.js +115 -0
- package/src/commands/state/approve.js +213 -221
- package/src/commands/state/index.js +0 -1
- package/src/commands/state/state.js +337 -365
- package/src/commands/templates/index.js +0 -4
- package/src/commands/trust/trust.js +1 -93
- package/src/commands/utils/index.js +1 -5
- package/src/commands/validation/index.js +1 -5
- package/src/core/registry/command-registry.js +11 -285
- package/src/core/state/state-manager.js +5 -2
- package/src/lib/detectors/index.js +81 -87
- package/src/lib/detectors/structure-detector.js +275 -273
- package/src/lib/generators/recap-generator.js +232 -225
- package/src/scripts/global-install.js +34 -0
- package/src/scripts/install-plugin.js +126 -0
- package/src/scripts/setup-infra.js +203 -0
- package/src/utils/agents-installer.js +10 -1
- package/src/utils/hooks-installer.js +66 -3
- package/.morph/.morphversion +0 -5
- package/.morph/config/config.json +0 -8
- package/.morph/framework/agents.json +0 -1815
- package/.morph/framework/hooks/README.md +0 -205
- package/.morph/framework/hooks/claude-code/notification/approval-reminder.js +0 -54
- package/.morph/framework/hooks/claude-code/post-tool-use/dispatch.js +0 -83
- package/.morph/framework/hooks/claude-code/post-tool-use/handle-tool-failure.js +0 -42
- package/.morph/framework/hooks/claude-code/pre-compact/save-morph-context.js +0 -61
- package/.morph/framework/hooks/claude-code/pre-tool-use/enforce-phase-writes.js +0 -71
- package/.morph/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js +0 -58
- package/.morph/framework/hooks/claude-code/pre-tool-use/protect-spec-files.js +0 -64
- package/.morph/framework/hooks/claude-code/session-start/inject-morph-context.js +0 -94
- package/.morph/framework/hooks/claude-code/statusline.py +0 -538
- package/.morph/framework/hooks/claude-code/statusline.sh +0 -7
- package/.morph/framework/hooks/claude-code/stop/validate-completion.js +0 -88
- package/.morph/framework/hooks/claude-code/user-prompt/enrich-prompt.js +0 -91
- package/.morph/framework/hooks/git/commit-msg/conventional-commits.sh +0 -33
- package/.morph/framework/hooks/git/pre-commit/agents.sh +0 -25
- package/.morph/framework/hooks/git/pre-commit/orchestrator.sh +0 -64
- package/.morph/framework/hooks/git/pre-commit/specs.sh +0 -50
- package/.morph/framework/hooks/git/pre-push/run-tests.sh +0 -44
- package/.morph/framework/hooks/shared/hook-response.js +0 -45
- package/.morph/framework/hooks/shared/phase-utils.js +0 -129
- package/.morph/framework/hooks/shared/state-reader.js +0 -138
- package/.morph/framework/hooks/shared/stdin-reader.js +0 -26
- package/.morph/framework/standards/STANDARDS.json +0 -933
- package/.morph/framework/standards/ai-agents/blazor-ui.md +0 -364
- package/.morph/framework/standards/ai-agents/production.md +0 -415
- package/.morph/framework/standards/ai-agents/setup.md +0 -418
- package/.morph/framework/standards/ai-agents/team-orchestration.md +0 -479
- package/.morph/framework/standards/ai-agents/workflows.md +0 -354
- package/.morph/framework/standards/architecture/ddd/aggregates.md +0 -120
- package/.morph/framework/standards/architecture/ddd/bounded-contexts.md +0 -105
- package/.morph/framework/standards/architecture/ddd/complexity-levels.md +0 -108
- package/.morph/framework/standards/architecture/ddd/entities.md +0 -99
- package/.morph/framework/standards/architecture/ddd/ubiquitous-language.md +0 -58
- package/.morph/framework/standards/architecture/ddd/value-objects.md +0 -124
- package/.morph/framework/standards/backend/api/minimal-api.md +0 -494
- package/.morph/framework/standards/backend/api/rest.md +0 -492
- package/.morph/framework/standards/backend/api/validation.md +0 -88
- package/.morph/framework/standards/backend/authentication/passkeys.md +0 -428
- package/.morph/framework/standards/backend/database/ef-core.md +0 -199
- package/.morph/framework/standards/backend/database/migrations.md +0 -393
- package/.morph/framework/standards/backend/database/postgresql/database.md +0 -352
- package/.morph/framework/standards/backend/database/repository-patterns.md +0 -528
- package/.morph/framework/standards/backend/database/vector-search-rag.md +0 -541
- package/.morph/framework/standards/backend/dotnet/async.md +0 -366
- package/.morph/framework/standards/backend/dotnet/core.md +0 -117
- package/.morph/framework/standards/backend/dotnet/di.md +0 -439
- package/.morph/framework/standards/backend/dotnet/program-cs-checklist.md +0 -92
- package/.morph/framework/standards/backend/integrations/asaas/asaas-api.md +0 -216
- package/.morph/framework/standards/backend/integrations/clerk/clerk-auth.md +0 -290
- package/.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -350
- package/.morph/framework/standards/backend/integrations/resend/resend-email.md +0 -385
- package/.morph/framework/standards/context/analytics.md +0 -96
- package/.morph/framework/standards/context/bundles.md +0 -110
- package/.morph/framework/standards/context/priming.md +0 -78
- package/.morph/framework/standards/core/architecture.md +0 -185
- package/.morph/framework/standards/core/coding.md +0 -214
- package/.morph/framework/standards/core/git-branching-strategy.md +0 -403
- package/.morph/framework/standards/core/git.md +0 -185
- package/.morph/framework/standards/core/testing.md +0 -295
- package/.morph/framework/standards/data/nosql/blob-storage.md +0 -102
- package/.morph/framework/standards/data/nosql/cache/redis.md +0 -97
- package/.morph/framework/standards/data/nosql/cosmos-db.md +0 -118
- package/.morph/framework/standards/data/vector-search/azure-ai-search.md +0 -121
- package/.morph/framework/standards/data/vector-search/rag-chunking.md +0 -104
- package/.morph/framework/standards/frontend/blazor/design-checklist.md +0 -222
- package/.morph/framework/standards/frontend/blazor/fluent-ui-setup.md +0 -595
- package/.morph/framework/standards/frontend/blazor/fluent-ui.md +0 -137
- package/.morph/framework/standards/frontend/blazor/html-conversion.md +0 -184
- package/.morph/framework/standards/frontend/blazor/lifecycle.md +0 -195
- package/.morph/framework/standards/frontend/blazor/pitfalls.md +0 -198
- package/.morph/framework/standards/frontend/blazor/state.md +0 -191
- package/.morph/framework/standards/frontend/design-system/animations.md +0 -151
- package/.morph/framework/standards/frontend/design-system/naming.md +0 -64
- package/.morph/framework/standards/frontend/nextjs/app-router.md +0 -123
- package/.morph/framework/standards/frontend/nextjs/components.md +0 -132
- package/.morph/framework/standards/frontend/nextjs/data-fetching.md +0 -126
- package/.morph/framework/standards/frontend/nextjs/forms.md +0 -128
- package/.morph/framework/standards/frontend/nextjs/naming-conventions.md +0 -67
- package/.morph/framework/standards/frontend/nextjs/nextjs-patterns.md +0 -215
- package/.morph/framework/standards/frontend/nextjs/project-structure.md +0 -102
- package/.morph/framework/standards/frontend/nextjs/state-management.md +0 -72
- package/.morph/framework/standards/frontend/nextjs/testing.md +0 -111
- package/.morph/framework/standards/infrastructure/azure/azure.md +0 -624
- package/.morph/framework/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -422
- package/.morph/framework/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -516
- package/.morph/framework/standards/infrastructure/azure/devops/local-development.md +0 -520
- package/.morph/framework/standards/infrastructure/azure/services/functions.md +0 -486
- package/.morph/framework/standards/infrastructure/azure/services/service-bus.md +0 -459
- package/.morph/framework/standards/infrastructure/azure/services/storage.md +0 -407
- package/.morph/framework/standards/infrastructure/docker/easypanel-deploy.md +0 -196
- package/.morph/framework/standards/infrastructure/supabase/mcp-setup.md +0 -252
- package/.morph/framework/standards/infrastructure/supabase/supabase-auth.md +0 -176
- package/.morph/framework/standards/infrastructure/supabase/supabase-pgvector.md +0 -169
- package/.morph/framework/standards/infrastructure/supabase/supabase-rls.md +0 -184
- package/.morph/framework/standards/infrastructure/supabase/supabase-storage.md +0 -153
- package/.morph/framework/standards/integration/api/graphql.md +0 -91
- package/.morph/framework/standards/integration/api/grpc.md +0 -114
- package/.morph/framework/standards/integration/api/rest-design.md +0 -95
- package/.morph/framework/standards/integration/event-driven/cqrs.md +0 -101
- package/.morph/framework/standards/integration/event-driven/event-sourcing.md +0 -124
- package/.morph/framework/standards/integration/event-driven/service-bus.md +0 -95
- package/.morph/framework/standards/integration/mcp/mcp-tools.md +0 -384
- package/.morph/framework/standards/observability/logging.md +0 -131
- package/.morph/framework/standards/observability/metrics.md +0 -121
- package/.morph/framework/standards/observability/monitoring.md +0 -114
- package/.morph/framework/standards/observability/tracing.md +0 -132
- package/.morph/framework/standards/workflows/parallel-execution.md +0 -112
- package/.morph/framework/standards/workflows/thread-management.md +0 -113
- package/.morph/framework/templates/.idea/morph-templates.xml +0 -92
- package/.morph/framework/templates/.vscode/morph-templates.code-snippets +0 -186
- package/.morph/framework/templates/IDE-SNIPPETS.md +0 -266
- package/.morph/framework/templates/README.md +0 -814
- package/.morph/framework/templates/REGISTRY.json +0 -1888
- package/.morph/framework/templates/code/dotnet/backend/repository.cs +0 -141
- package/.morph/framework/templates/code/dotnet/backend/service.cs +0 -139
- package/.morph/framework/templates/code/dotnet/contracts/Commands.cs +0 -74
- package/.morph/framework/templates/code/dotnet/contracts/Entities.cs +0 -25
- package/.morph/framework/templates/code/dotnet/contracts/Queries.cs +0 -74
- package/.morph/framework/templates/code/dotnet/contracts/README.md +0 -74
- package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs +0 -173
- package/.morph/framework/templates/code/dotnet/contracts/contracts-level1.cs +0 -69
- package/.morph/framework/templates/code/dotnet/contracts/contracts-level2.cs +0 -86
- package/.morph/framework/templates/code/dotnet/contracts/contracts-level3.cs +0 -41
- package/.morph/framework/templates/code/dotnet/database/migration.cs +0 -83
- package/.morph/framework/templates/code/dotnet/frontend/component.razor +0 -239
- package/.morph/framework/templates/code/dotnet/jobs/agent.cs +0 -163
- package/.morph/framework/templates/code/dotnet/jobs/job.cs +0 -171
- package/.morph/framework/templates/code/dotnet/test.cs +0 -239
- package/.morph/framework/templates/code/sql/rls-policy.sql +0 -57
- package/.morph/framework/templates/code/sql/supabase-migration.sql +0 -100
- package/.morph/framework/templates/code/sql/supabase-migration.template.sql +0 -113
- package/.morph/framework/templates/code/typescript/contracts.ts +0 -168
- package/.morph/framework/templates/context/CONTEXT-FEATURE.md +0 -276
- package/.morph/framework/templates/context/CONTEXT.md +0 -181
- package/.morph/framework/templates/docs/clarifications.md +0 -253
- package/.morph/framework/templates/docs/onboarding.md +0 -123
- package/.morph/framework/templates/docs/proposal.md +0 -182
- package/.morph/framework/templates/docs/schema-analysis.md +0 -119
- package/.morph/framework/templates/docs/spec.md +0 -198
- package/.morph/framework/templates/docs/ui-components.md +0 -124
- package/.morph/framework/templates/docs/ui-design-system.md +0 -76
- package/.morph/framework/templates/docs/ui-flows.md +0 -167
- package/.morph/framework/templates/docs/ui-mockups.md +0 -98
- package/.morph/framework/templates/docs/user-stories.md +0 -34
- package/.morph/framework/templates/examples/design-system-examples.md +0 -357
- package/.morph/framework/templates/examples/spec-examples.md +0 -90
- package/.morph/framework/templates/feature/decisions.md +0 -187
- package/.morph/framework/templates/feature/recap.md +0 -146
- package/.morph/framework/templates/feature/tasks.md +0 -199
- package/.morph/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +0 -43
- package/.morph/framework/templates/frontend/nextjs/client-component.tsx.hbs +0 -26
- package/.morph/framework/templates/frontend/nextjs/env.mjs.hbs +0 -32
- package/.morph/framework/templates/frontend/nextjs/feature-form.tsx.hbs +0 -56
- package/.morph/framework/templates/frontend/nextjs/page.tsx.hbs +0 -22
- package/.morph/framework/templates/frontend/nextjs/tsconfig.json.hbs +0 -26
- package/.morph/framework/templates/frontend/nextjs/use-feature.ts.hbs +0 -54
- package/.morph/framework/templates/infrastructure/azure/Dockerfile.example +0 -82
- package/.morph/framework/templates/infrastructure/azure/README.md +0 -286
- package/.morph/framework/templates/infrastructure/azure/app-insights.bicep +0 -63
- package/.morph/framework/templates/infrastructure/azure/app-service.bicep +0 -164
- package/.morph/framework/templates/infrastructure/azure/container-app-env.bicep +0 -49
- package/.morph/framework/templates/infrastructure/azure/container-app.bicep +0 -156
- package/.morph/framework/templates/infrastructure/azure/deploy-checklist.md +0 -426
- package/.morph/framework/templates/infrastructure/azure/deploy.ps1 +0 -229
- package/.morph/framework/templates/infrastructure/azure/deploy.sh +0 -208
- package/.morph/framework/templates/infrastructure/azure/key-vault.bicep +0 -91
- package/.morph/framework/templates/infrastructure/azure/main.bicep +0 -189
- package/.morph/framework/templates/infrastructure/azure/parameters.dev.json +0 -29
- package/.morph/framework/templates/infrastructure/azure/parameters.prod.json +0 -29
- package/.morph/framework/templates/infrastructure/azure/parameters.staging.json +0 -29
- package/.morph/framework/templates/infrastructure/azure/sql-database.bicep +0 -103
- package/.morph/framework/templates/infrastructure/azure/storage.bicep +0 -106
- package/.morph/framework/templates/infrastructure/docker/Dockerfile.template +0 -58
- package/.morph/framework/templates/infrastructure/docker/docker-compose.template.yml +0 -67
- package/.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +0 -38
- package/.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +0 -48
- package/.morph/framework/templates/infrastructure/docker/easypanel.template.json +0 -54
- package/.morph/framework/templates/infrastructure/github/README.md +0 -593
- package/.morph/framework/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +0 -22
- package/.morph/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +0 -45
- package/.morph/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +0 -27
- package/.morph/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +0 -61
- package/.morph/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +0 -31
- package/.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +0 -59
- package/.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +0 -39
- package/.morph/framework/templates/integrations/asaas-client.cs +0 -387
- package/.morph/framework/templates/integrations/asaas-webhook.cs +0 -351
- package/.morph/framework/templates/integrations/azure-identity-config.cs +0 -288
- package/.morph/framework/templates/integrations/clerk-config.cs +0 -258
- package/.morph/framework/templates/meta-prompts/fusion/fusion-agent.md +0 -76
- package/.morph/framework/templates/meta-prompts/fusion/fusion-aggregator.md +0 -100
- package/.morph/framework/templates/meta-prompts/hops/hop-retry.md +0 -78
- package/.morph/framework/templates/meta-prompts/hops/hop-validation.md +0 -97
- package/.morph/framework/templates/meta-prompts/hops/hop-wrapper.md +0 -36
- package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
- package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
- package/.morph/framework/templates/meta-prompts/squad-leaders/backend-squad.md +0 -90
- package/.morph/framework/templates/meta-prompts/squad-leaders/frontend-squad.md +0 -126
- package/.morph/framework/templates/meta-prompts/squad-leaders/squad-leader.md +0 -43
- package/.morph/framework/templates/meta-prompts/validators/checkpoint-validator.md +0 -107
- package/.morph/framework/templates/meta-prompts/validators/pre-commit-validator.md +0 -95
- package/.morph/framework/templates/project-structure/dotnet-ddd.md +0 -70
- package/.morph/framework/templates/saas/subscription.cs +0 -347
- package/.morph/framework/templates/saas/tenant.cs +0 -338
- package/.morph/framework/templates/state.template.json +0 -17
- package/.morph/framework/templates/ui/FluentDesignTheme.cs +0 -149
- package/.morph/framework/templates/ui/MudTheme.cs +0 -281
- package/.morph/framework/templates/ui/design-system.css +0 -226
- package/.morph/logs/tool-failures.log +0 -17
- package/.morph/memory/pre-compact-2026-02-24T17-43-30-049Z.json +0 -16
- package/.morph/plans/eager-watching-bunny.md +0 -105
- package/.morph/plans/temporal-seeking-nebula.md +0 -45
- package/CLAUDE.md +0 -77
- package/docs/claude-alignment-report.md +0 -137
- package/docs/examples/order-management/contracts.cs +0 -84
- package/docs/examples/order-management/proposal.md +0 -24
- package/docs/examples/order-management/spec.md +0 -162
- package/src/commands/feature/create-story.js +0 -362
- package/src/commands/feature/index.js +0 -6
- package/src/commands/feature/shard-spec.js +0 -225
- package/src/commands/feature/sprint-status.js +0 -250
- package/src/commands/generation/generate-onboarding.js +0 -169
- package/src/commands/generation/generate.js +0 -276
- package/src/commands/generation/index.js +0 -5
- package/src/commands/learning/capture-pattern.js +0 -121
- package/src/commands/learning/index.js +0 -5
- package/src/commands/learning/search-patterns.js +0 -126
- package/src/commands/mcp/mcp.js +0 -102
- package/src/commands/project/changes.js +0 -66
- package/src/commands/project/cost.js +0 -179
- package/src/commands/project/diff.js +0 -278
- package/src/commands/project/revert.js +0 -173
- package/src/commands/project/standards.js +0 -80
- package/src/commands/project/sync.js +0 -167
- package/src/commands/project/update-agents.js +0 -23
- package/src/commands/state/rollback-phase.js +0 -185
- package/src/commands/templates/template-customize.js +0 -87
- package/src/commands/templates/template-list.js +0 -114
- package/src/commands/templates/template-show.js +0 -129
- package/src/commands/templates/template-validate.js +0 -91
- package/src/commands/utils/troubleshoot.js +0 -222
- package/src/commands/validation/analyze-blazor-concurrency.js +0 -193
- package/src/commands/validation/lint-fluent.js +0 -352
- package/src/commands/validation/validate-blazor-state.js +0 -210
- package/src/commands/validation/validate-blazor.js +0 -156
- package/src/commands/validation/validate-css.js +0 -84
- package/src/lib/detectors/conversation-analyzer.js +0 -163
- package/src/lib/learning/index.js +0 -7
- package/src/lib/learning/learning-system.js +0 -520
- package/src/lib/troubleshooting/index.js +0 -8
- package/src/lib/troubleshooting/troubleshoot-grep.js +0 -198
- package/src/lib/troubleshooting/troubleshoot-index.js +0 -144
- package/src/llm/environment-detector.js +0 -43
|
@@ -1,250 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* MORPH-SPEC Sprint Status Manager
|
|
3
|
-
* Updates sprint-status.yaml and shows next story
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import fs from 'fs';
|
|
7
|
-
import path from 'path';
|
|
8
|
-
import yaml from 'yaml';
|
|
9
|
-
import ora from 'ora';
|
|
10
|
-
import chalk from 'chalk';
|
|
11
|
-
import { logger } from '../../utils/logger.js';
|
|
12
|
-
|
|
13
|
-
// ============================================================================
|
|
14
|
-
// Helper Functions
|
|
15
|
-
// ============================================================================
|
|
16
|
-
|
|
17
|
-
function loadSprintStatus(featureName) {
|
|
18
|
-
const statusPath = path.join(process.cwd(), `.morph/features/${featureName}/sprint-status.yaml`);
|
|
19
|
-
|
|
20
|
-
if (!fs.existsSync(statusPath)) {
|
|
21
|
-
throw new Error(`Sprint status not found: ${statusPath}\n\n💡 Create a sprint status file first:\n morph-spec story create ${featureName} STORY-001`);
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
const content = fs.readFileSync(statusPath, 'utf-8');
|
|
25
|
-
return { path: statusPath, data: yaml.parse(content) };
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
function saveSprintStatus(statusPath, data) {
|
|
29
|
-
const content = yaml.stringify(data);
|
|
30
|
-
fs.writeFileSync(statusPath, content);
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
function updateMetrics(sprint) {
|
|
34
|
-
const stories = sprint.stories || [];
|
|
35
|
-
const metrics = {
|
|
36
|
-
total_stories: stories.length,
|
|
37
|
-
ready: stories.filter(s => s.status === 'ready').length,
|
|
38
|
-
in_progress: stories.filter(s => s.status === 'in_progress').length,
|
|
39
|
-
ready_for_qa: stories.filter(s => s.status === 'ready_for_qa').length,
|
|
40
|
-
done: stories.filter(s => s.status === 'done').length,
|
|
41
|
-
};
|
|
42
|
-
|
|
43
|
-
metrics.completion_percent = stories.length > 0
|
|
44
|
-
? Math.round((metrics.done / stories.length) * 100)
|
|
45
|
-
: 0;
|
|
46
|
-
|
|
47
|
-
sprint.metrics = metrics;
|
|
48
|
-
sprint.updated = new Date().toISOString().split('T')[0];
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
function findStory(sprint, storyId) {
|
|
52
|
-
return sprint.stories.find(s => s.id === storyId);
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
function getNextStory(sprint) {
|
|
56
|
-
// Find first story that is "ready" (not in_progress or done)
|
|
57
|
-
return sprint.stories.find(s => s.status === 'ready' || s.status === 'pending');
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
function displayStatus(sprint) {
|
|
61
|
-
logger.header(`Sprint Status: ${sprint.feature}`);
|
|
62
|
-
logger.blank();
|
|
63
|
-
logger.info(`Epic: ${chalk.cyan(sprint.epic)}`);
|
|
64
|
-
logger.info(`Progress: ${chalk.green(`${sprint.metrics.completion_percent}%`)} (${sprint.metrics.done}/${sprint.metrics.total_stories} stories done)`);
|
|
65
|
-
logger.blank();
|
|
66
|
-
|
|
67
|
-
logger.header('Stories:');
|
|
68
|
-
sprint.stories.forEach(story => {
|
|
69
|
-
const statusEmoji = {
|
|
70
|
-
pending: '⏸️ ',
|
|
71
|
-
ready: '✅',
|
|
72
|
-
in_progress: '🔄',
|
|
73
|
-
ready_for_qa: '👀',
|
|
74
|
-
done: '✔️ ',
|
|
75
|
-
}[story.status] || '❓';
|
|
76
|
-
|
|
77
|
-
const statusColor = {
|
|
78
|
-
pending: chalk.dim,
|
|
79
|
-
ready: chalk.cyan,
|
|
80
|
-
in_progress: chalk.yellow,
|
|
81
|
-
ready_for_qa: chalk.magenta,
|
|
82
|
-
done: chalk.green,
|
|
83
|
-
}[story.status] || chalk.white;
|
|
84
|
-
|
|
85
|
-
logger.dim(` ${statusEmoji} ${story.id}: ${story.title} ${statusColor(`(${story.status})`)}`);
|
|
86
|
-
});
|
|
87
|
-
logger.blank();
|
|
88
|
-
|
|
89
|
-
if (sprint.current && sprint.current.story_id) {
|
|
90
|
-
logger.info(`🎯 Current Focus: ${chalk.cyan(sprint.current.story_id)} (${sprint.current.agent} agent)`);
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
if (sprint.next && sprint.next.story_id) {
|
|
94
|
-
logger.info(`📋 Next Story: ${chalk.cyan(sprint.next.story_id)}`);
|
|
95
|
-
logger.dim(` ${sprint.next.recommendation || 'Ready for development'}`);
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
logger.blank();
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
// ============================================================================
|
|
102
|
-
// Command Function
|
|
103
|
-
// ============================================================================
|
|
104
|
-
|
|
105
|
-
export async function sprintStatusCommand(feature, action, storyId, options) {
|
|
106
|
-
// Default action is 'show'
|
|
107
|
-
const cmd = action || 'show';
|
|
108
|
-
|
|
109
|
-
if (cmd === 'help' || options.help) {
|
|
110
|
-
logger.header('MORPH-SPEC Sprint Status Manager');
|
|
111
|
-
logger.blank();
|
|
112
|
-
logger.info('Usage:');
|
|
113
|
-
logger.dim(' morph-spec story status <feature> [command] [story-id]');
|
|
114
|
-
logger.blank();
|
|
115
|
-
logger.info('Commands:');
|
|
116
|
-
logger.dim(' show Display current sprint status (default)');
|
|
117
|
-
logger.dim(' start <story-id> Mark story as in_progress');
|
|
118
|
-
logger.dim(' qa <story-id> Mark story as ready_for_qa');
|
|
119
|
-
logger.dim(' done <story-id> Mark story as done');
|
|
120
|
-
logger.dim(' next Show next story to work on');
|
|
121
|
-
logger.blank();
|
|
122
|
-
logger.info('Examples:');
|
|
123
|
-
logger.dim(' morph-spec story status scheduled-reports show');
|
|
124
|
-
logger.dim(' morph-spec story status scheduled-reports start SR-001');
|
|
125
|
-
logger.dim(' morph-spec story status scheduled-reports qa SR-001');
|
|
126
|
-
logger.dim(' morph-spec story status scheduled-reports done SR-001');
|
|
127
|
-
logger.dim(' morph-spec story status scheduled-reports next');
|
|
128
|
-
logger.blank();
|
|
129
|
-
return;
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
try {
|
|
133
|
-
// Load sprint status
|
|
134
|
-
const { path: statusPath, data: sprint } = loadSprintStatus(feature);
|
|
135
|
-
|
|
136
|
-
// Execute command
|
|
137
|
-
switch (cmd) {
|
|
138
|
-
case 'show':
|
|
139
|
-
displayStatus(sprint);
|
|
140
|
-
break;
|
|
141
|
-
|
|
142
|
-
case 'start':
|
|
143
|
-
if (!storyId) {
|
|
144
|
-
throw new Error('Story ID required for "start" command');
|
|
145
|
-
}
|
|
146
|
-
const storyToStart = findStory(sprint, storyId);
|
|
147
|
-
if (!storyToStart) {
|
|
148
|
-
throw new Error(`Story not found: ${storyId}`);
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
const spinner = ora('Updating story status...').start();
|
|
152
|
-
storyToStart.status = 'in_progress';
|
|
153
|
-
storyToStart.started = new Date().toISOString().split('T')[0];
|
|
154
|
-
storyToStart.assigned = 'dev';
|
|
155
|
-
sprint.current = { story_id: storyId, agent: 'dev', phase: 'implementation' };
|
|
156
|
-
updateMetrics(sprint);
|
|
157
|
-
saveSprintStatus(statusPath, sprint);
|
|
158
|
-
spinner.succeed(`Story ${chalk.cyan(storyId)} marked as IN PROGRESS`);
|
|
159
|
-
logger.blank();
|
|
160
|
-
logger.info('💡 Recommendation: Run this story in a FRESH Claude session');
|
|
161
|
-
logger.dim(' /dev → Implement story → Add Dev Notes');
|
|
162
|
-
logger.blank();
|
|
163
|
-
break;
|
|
164
|
-
|
|
165
|
-
case 'qa':
|
|
166
|
-
if (!storyId) {
|
|
167
|
-
throw new Error('Story ID required for "qa" command');
|
|
168
|
-
}
|
|
169
|
-
const storyForQA = findStory(sprint, storyId);
|
|
170
|
-
if (!storyForQA) {
|
|
171
|
-
throw new Error(`Story not found: ${storyId}`);
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
const qaSpinner = ora('Updating story status...').start();
|
|
175
|
-
storyForQA.status = 'ready_for_qa';
|
|
176
|
-
storyForQA.assigned = 'qa';
|
|
177
|
-
sprint.current = { story_id: storyId, agent: 'qa', phase: 'review' };
|
|
178
|
-
updateMetrics(sprint);
|
|
179
|
-
saveSprintStatus(statusPath, sprint);
|
|
180
|
-
qaSpinner.succeed(`Story ${chalk.cyan(storyId)} marked as READY FOR QA`);
|
|
181
|
-
logger.blank();
|
|
182
|
-
logger.info('💡 Recommendation: QA in a FRESH Claude session');
|
|
183
|
-
logger.dim(' /qa → Review code → Add QA Notes');
|
|
184
|
-
logger.blank();
|
|
185
|
-
break;
|
|
186
|
-
|
|
187
|
-
case 'done':
|
|
188
|
-
if (!storyId) {
|
|
189
|
-
throw new Error('Story ID required for "done" command');
|
|
190
|
-
}
|
|
191
|
-
const storyDone = findStory(sprint, storyId);
|
|
192
|
-
if (!storyDone) {
|
|
193
|
-
throw new Error(`Story not found: ${storyId}`);
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
const doneSpinner = ora('Updating story status...').start();
|
|
197
|
-
storyDone.status = 'done';
|
|
198
|
-
storyDone.completed = new Date().toISOString().split('T')[0];
|
|
199
|
-
updateMetrics(sprint);
|
|
200
|
-
|
|
201
|
-
// Update next story
|
|
202
|
-
const nextStory = getNextStory(sprint);
|
|
203
|
-
if (nextStory) {
|
|
204
|
-
sprint.next = {
|
|
205
|
-
story_id: nextStory.id,
|
|
206
|
-
recommendation: `Story ${nextStory.id} is ready for development`,
|
|
207
|
-
};
|
|
208
|
-
} else {
|
|
209
|
-
sprint.next = null;
|
|
210
|
-
}
|
|
211
|
-
|
|
212
|
-
saveSprintStatus(statusPath, sprint);
|
|
213
|
-
doneSpinner.succeed(`Story ${chalk.cyan(storyId)} marked as DONE`);
|
|
214
|
-
logger.blank();
|
|
215
|
-
|
|
216
|
-
if (nextStory) {
|
|
217
|
-
logger.info(`📋 Next Story: ${chalk.cyan(nextStory.id)}`);
|
|
218
|
-
logger.dim(` ${nextStory.title}`);
|
|
219
|
-
logger.blank();
|
|
220
|
-
} else {
|
|
221
|
-
logger.success('🎉 All stories completed! Feature ready for final review.');
|
|
222
|
-
logger.blank();
|
|
223
|
-
}
|
|
224
|
-
break;
|
|
225
|
-
|
|
226
|
-
case 'next':
|
|
227
|
-
const next = getNextStory(sprint);
|
|
228
|
-
if (next) {
|
|
229
|
-
logger.header('Next Story:');
|
|
230
|
-
logger.blank();
|
|
231
|
-
logger.info(`📋 Story ID: ${chalk.cyan(next.id)}`);
|
|
232
|
-
logger.info(` Title: ${next.title}`);
|
|
233
|
-
logger.info(` File: ${chalk.dim(next.file)}`);
|
|
234
|
-
logger.info(` Status: ${next.status}`);
|
|
235
|
-
logger.blank();
|
|
236
|
-
} else {
|
|
237
|
-
logger.success('🎉 No pending stories! Sprint complete.');
|
|
238
|
-
logger.blank();
|
|
239
|
-
}
|
|
240
|
-
break;
|
|
241
|
-
|
|
242
|
-
default:
|
|
243
|
-
throw new Error(`Unknown command: ${cmd}\n Use --help to see available commands`);
|
|
244
|
-
}
|
|
245
|
-
|
|
246
|
-
} catch (error) {
|
|
247
|
-
logger.error(error.message);
|
|
248
|
-
process.exit(1);
|
|
249
|
-
}
|
|
250
|
-
}
|
|
@@ -1,169 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Generate Onboarding Command
|
|
3
|
-
*
|
|
4
|
-
* Reads project context and renders the onboarding template
|
|
5
|
-
* with detected MCPs, agents, standards, and workflow info.
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
import { join } from 'path';
|
|
9
|
-
import { existsSync, readFileSync, readdirSync } from 'fs';
|
|
10
|
-
import chalk from 'chalk';
|
|
11
|
-
import { logger } from '../../utils/logger.js';
|
|
12
|
-
import { pathExists, readJson, writeFile, ensureDir } from '../../utils/file-copier.js';
|
|
13
|
-
import { getInstalledCLIVersion } from '../../utils/version-checker.js';
|
|
14
|
-
|
|
15
|
-
export async function generateOnboardingCommand(options = {}) {
|
|
16
|
-
const targetPath = process.cwd();
|
|
17
|
-
const configPath = join(targetPath, '.morph', 'config', 'config.json');
|
|
18
|
-
const integrationsPath = join(targetPath, '.morph', 'config', 'integrations.json');
|
|
19
|
-
const agentsPath = join(targetPath, '.morph', 'config', 'agents.json');
|
|
20
|
-
|
|
21
|
-
logger.header('Generating Onboarding Guide');
|
|
22
|
-
|
|
23
|
-
// Load config
|
|
24
|
-
if (!(await pathExists(configPath))) {
|
|
25
|
-
logger.error('Project not initialized. Run "morph-spec init" first.');
|
|
26
|
-
process.exit(1);
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
const config = await readJson(configPath);
|
|
30
|
-
const integrations = await pathExists(integrationsPath) ? await readJson(integrationsPath) : null;
|
|
31
|
-
|
|
32
|
-
// Build template variables
|
|
33
|
-
const projectName = config?.project?.name || 'Unknown Project';
|
|
34
|
-
const stack = config?.project?.stack || config?.project?.architecture || 'not detected';
|
|
35
|
-
const architecture = config?.project?.architecture || 'not detected';
|
|
36
|
-
const version = getInstalledCLIVersion();
|
|
37
|
-
const date = new Date().toISOString().split('T')[0];
|
|
38
|
-
|
|
39
|
-
// Build agents list
|
|
40
|
-
let agentsList = 'No agents configuration found. Run `morph-spec init` to set up.';
|
|
41
|
-
if (await pathExists(agentsPath)) {
|
|
42
|
-
try {
|
|
43
|
-
const agentsConfig = await readJson(agentsPath);
|
|
44
|
-
const agents = agentsConfig.agents || {};
|
|
45
|
-
const lines = [];
|
|
46
|
-
for (const [id, agent] of Object.entries(agents)) {
|
|
47
|
-
const emoji = agent.emoji || '';
|
|
48
|
-
const tier = agent.tier ? `Tier ${agent.tier}` : '';
|
|
49
|
-
lines.push(`- ${emoji} **${agent.name || id}** (${tier}) — ${agent.role || agent.responsibilities?.[0] || ''}`);
|
|
50
|
-
}
|
|
51
|
-
if (lines.length > 0) {
|
|
52
|
-
agentsList = lines.join('\n');
|
|
53
|
-
}
|
|
54
|
-
} catch {
|
|
55
|
-
// Use default
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
// Build MCPs summary
|
|
60
|
-
let availableMcps = 'No MCPs detected. Install MCP servers and run `morph-spec init --force` to detect.';
|
|
61
|
-
if (integrations) {
|
|
62
|
-
const lines = [];
|
|
63
|
-
|
|
64
|
-
if (integrations.plugins?.length > 0) {
|
|
65
|
-
lines.push('**Plugins:**');
|
|
66
|
-
for (const p of integrations.plugins) {
|
|
67
|
-
const ver = p.version ? ` v${p.version}` : '';
|
|
68
|
-
lines.push(`- ${p.name}${ver}`);
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
if (integrations.mcpServers?.length > 0) {
|
|
73
|
-
lines.push('');
|
|
74
|
-
lines.push('**MCP Servers:**');
|
|
75
|
-
|
|
76
|
-
const phaseMap = {
|
|
77
|
-
context7: 'proposal, design, tasks, implement',
|
|
78
|
-
supabase: 'design, implement',
|
|
79
|
-
playwright: 'UI/UX, implement',
|
|
80
|
-
github: 'setup, tasks, implement',
|
|
81
|
-
figma: 'UI/UX'
|
|
82
|
-
};
|
|
83
|
-
|
|
84
|
-
for (const s of integrations.mcpServers) {
|
|
85
|
-
const name = s.name.toLowerCase();
|
|
86
|
-
const phases = Object.entries(phaseMap).find(([k]) => name.includes(k));
|
|
87
|
-
const phaseStr = phases ? ` (phases: ${phases[1]})` : '';
|
|
88
|
-
lines.push(`- **${s.name}** (${s.source})${phaseStr}`);
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
|
|
92
|
-
if (integrations.superpowers?.installed) {
|
|
93
|
-
lines.push('');
|
|
94
|
-
lines.push(`**Superpowers:** installed (${integrations.superpowers.skills?.length || 0} skills)`);
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
if (lines.length > 0) {
|
|
98
|
-
availableMcps = lines.join('\n');
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
// Build standards summary
|
|
103
|
-
let standardsSummary = 'Using morph-spec defaults.';
|
|
104
|
-
const standardsDir = join(targetPath, '.morph', 'standards');
|
|
105
|
-
if (existsSync(standardsDir)) {
|
|
106
|
-
try {
|
|
107
|
-
const standards = collectStandards(standardsDir);
|
|
108
|
-
if (standards.length > 0) {
|
|
109
|
-
standardsSummary = standards.map(s => `- ${s}`).join('\n');
|
|
110
|
-
}
|
|
111
|
-
} catch {
|
|
112
|
-
// Use default
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
// Build workflow summary
|
|
117
|
-
const workflowSummary = 'Workflow is **auto-detected** from your feature request. The framework analyzes keywords and complexity to choose the best workflow.';
|
|
118
|
-
|
|
119
|
-
// Read template
|
|
120
|
-
const templatePath = join(import.meta.dirname, '..', '..', '..', 'framework', 'templates', 'docs', 'onboarding.md');
|
|
121
|
-
let template;
|
|
122
|
-
if (existsSync(templatePath)) {
|
|
123
|
-
template = readFileSync(templatePath, 'utf-8');
|
|
124
|
-
} else {
|
|
125
|
-
logger.error('Onboarding template not found.');
|
|
126
|
-
process.exit(1);
|
|
127
|
-
}
|
|
128
|
-
|
|
129
|
-
// Replace placeholders
|
|
130
|
-
let content = template
|
|
131
|
-
.replace(/\{\{PROJECT_NAME\}\}/g, projectName)
|
|
132
|
-
.replace(/\{\{STACK\}\}/g, stack)
|
|
133
|
-
.replace(/\{\{ARCHITECTURE\}\}/g, architecture)
|
|
134
|
-
.replace(/\{\{DATE\}\}/g, date)
|
|
135
|
-
.replace(/\{\{VERSION\}\}/g, version)
|
|
136
|
-
.replace(/\{\{AGENTS_LIST\}\}/g, agentsList)
|
|
137
|
-
.replace(/\{\{AVAILABLE_MCPS\}\}/g, availableMcps)
|
|
138
|
-
.replace(/\{\{STANDARDS_SUMMARY\}\}/g, standardsSummary)
|
|
139
|
-
.replace(/\{\{WORKFLOW_SUMMARY\}\}/g, workflowSummary);
|
|
140
|
-
|
|
141
|
-
// Write output
|
|
142
|
-
const outputDir = join(targetPath, '.morph', 'project', 'outputs');
|
|
143
|
-
await ensureDir(outputDir);
|
|
144
|
-
const outputPath = join(outputDir, 'onboarding.md');
|
|
145
|
-
await writeFile(outputPath, content);
|
|
146
|
-
|
|
147
|
-
logger.success(`Onboarding guide generated: ${outputPath}`);
|
|
148
|
-
logger.dim('Share this file with new team members.');
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
/**
|
|
152
|
-
* Collect standard file names from directory tree
|
|
153
|
-
*/
|
|
154
|
-
function collectStandards(dir, prefix = '') {
|
|
155
|
-
const results = [];
|
|
156
|
-
try {
|
|
157
|
-
const entries = readdirSync(dir, { withFileTypes: true });
|
|
158
|
-
for (const entry of entries) {
|
|
159
|
-
if (entry.isDirectory()) {
|
|
160
|
-
results.push(...collectStandards(join(dir, entry.name), `${prefix}${entry.name}/`));
|
|
161
|
-
} else if (entry.name.endsWith('.md') && entry.name !== 'README.md') {
|
|
162
|
-
results.push(`${prefix}${entry.name.replace('.md', '')}`);
|
|
163
|
-
}
|
|
164
|
-
}
|
|
165
|
-
} catch {
|
|
166
|
-
// Permission errors
|
|
167
|
-
}
|
|
168
|
-
return results;
|
|
169
|
-
}
|
|
@@ -1,276 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* MORPH-SPEC Generate Command
|
|
3
|
-
* CLI wrapper for code generation operations
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import { mkdirSync, writeFileSync } from 'fs';
|
|
7
|
-
import { dirname, join } from 'path';
|
|
8
|
-
import ora from 'ora';
|
|
9
|
-
import chalk from 'chalk';
|
|
10
|
-
import { logger } from '../../utils/logger.js';
|
|
11
|
-
import * as DesignSystemGenerator from '../../lib/generators/design-system-generator.js';
|
|
12
|
-
import { getFeature } from '../../core/state/state-manager.js';
|
|
13
|
-
import { extractFeatureMetadata } from '../../lib/generators/metadata-extractor.js';
|
|
14
|
-
|
|
15
|
-
// ============================================================================
|
|
16
|
-
// Design System Subcommand
|
|
17
|
-
// ============================================================================
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Generate design system files (CSS + themes) from ui-design-system.md
|
|
21
|
-
* @param {string} designSystemPath - Path to ui-design-system.md
|
|
22
|
-
* @param {Object} options - CLI options
|
|
23
|
-
*/
|
|
24
|
-
export async function generateDesignSystemCommand(designSystemPath, options) {
|
|
25
|
-
if (!designSystemPath) {
|
|
26
|
-
logger.error('Design system file path required');
|
|
27
|
-
logger.dim(' Usage: morph-spec generate design-system <ui-design-system.md>');
|
|
28
|
-
logger.blank();
|
|
29
|
-
logger.dim(' Example:');
|
|
30
|
-
logger.dim(' morph-spec generate design-system .morph/features/my-feature/2-ui/design-system.md');
|
|
31
|
-
process.exit(1);
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
logger.header('MORPH-SPEC Design System Generator');
|
|
35
|
-
logger.blank();
|
|
36
|
-
|
|
37
|
-
const spinner = ora('Parsing design system...').start();
|
|
38
|
-
|
|
39
|
-
try {
|
|
40
|
-
// Determine mode
|
|
41
|
-
let mode = 'both';
|
|
42
|
-
if (options.fluent && !options.mud) mode = 'fluent';
|
|
43
|
-
if (options.mud && !options.fluent) mode = 'mud';
|
|
44
|
-
|
|
45
|
-
// Generate design system
|
|
46
|
-
const generated = DesignSystemGenerator.generateDesignSystem(designSystemPath, {
|
|
47
|
-
mode,
|
|
48
|
-
namespace: options.namespace || 'YourProject.Themes'
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
spinner.succeed('Design system parsed!');
|
|
52
|
-
logger.blank();
|
|
53
|
-
|
|
54
|
-
// Display stats
|
|
55
|
-
logger.header('Parsed Design System:');
|
|
56
|
-
logger.info(`Primary Colors: ${chalk.cyan(generated.stats.primaryColors)}`);
|
|
57
|
-
logger.info(`Neutral Colors: ${chalk.cyan(generated.stats.neutralColors)}`);
|
|
58
|
-
logger.info(`Semantic Colors: ${chalk.cyan(generated.stats.semanticColors)}`);
|
|
59
|
-
logger.info(`Font Sizes: ${chalk.cyan(generated.stats.fontSizes)}`);
|
|
60
|
-
logger.info(`Spacing Values: ${chalk.cyan(generated.stats.spacingValues)}`);
|
|
61
|
-
logger.blank();
|
|
62
|
-
|
|
63
|
-
if (options.dryRun) {
|
|
64
|
-
logger.warn('Dry run - files not written');
|
|
65
|
-
logger.blank();
|
|
66
|
-
logger.header('Would generate:');
|
|
67
|
-
logger.dim(' - wwwroot/css/design-system.css');
|
|
68
|
-
if (generated.fluentTheme) logger.dim(' - Themes/FluentDesignTheme.cs');
|
|
69
|
-
if (generated.mudTheme) logger.dim(' - Themes/MudDesignTheme.cs');
|
|
70
|
-
logger.blank();
|
|
71
|
-
return;
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
// Write files
|
|
75
|
-
const writeSpinner = ora('Writing files...').start();
|
|
76
|
-
|
|
77
|
-
// Write CSS
|
|
78
|
-
const cssPath = options.cssOutput || 'wwwroot/css/design-system.css';
|
|
79
|
-
mkdirSync(dirname(cssPath), { recursive: true });
|
|
80
|
-
writeFileSync(cssPath, generated.css);
|
|
81
|
-
writeSpinner.text = `Created ${cssPath}`;
|
|
82
|
-
|
|
83
|
-
// Write Fluent theme
|
|
84
|
-
if (generated.fluentTheme) {
|
|
85
|
-
const fluentPath = options.fluentOutput || 'Themes/FluentDesignTheme.cs';
|
|
86
|
-
mkdirSync(dirname(fluentPath), { recursive: true });
|
|
87
|
-
writeFileSync(fluentPath, generated.fluentTheme);
|
|
88
|
-
writeSpinner.text = `Created ${fluentPath}`;
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
// Write MudBlazor theme
|
|
92
|
-
if (generated.mudTheme) {
|
|
93
|
-
const mudPath = options.mudOutput || 'Themes/MudDesignTheme.cs';
|
|
94
|
-
mkdirSync(dirname(mudPath), { recursive: true });
|
|
95
|
-
writeFileSync(mudPath, generated.mudTheme);
|
|
96
|
-
writeSpinner.text = `Created ${mudPath}`;
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
writeSpinner.succeed('Files generated!');
|
|
100
|
-
logger.blank();
|
|
101
|
-
|
|
102
|
-
// List generated files
|
|
103
|
-
logger.header('Generated Files:');
|
|
104
|
-
logger.success(` ✓ ${cssPath}`);
|
|
105
|
-
if (generated.fluentTheme) logger.success(` ✓ ${options.fluentOutput || 'Themes/FluentDesignTheme.cs'}`);
|
|
106
|
-
if (generated.mudTheme) logger.success(` ✓ ${options.mudOutput || 'Themes/MudDesignTheme.cs'}`);
|
|
107
|
-
logger.blank();
|
|
108
|
-
|
|
109
|
-
// Next steps
|
|
110
|
-
logger.header('Next Steps:');
|
|
111
|
-
logger.dim(' 1. Reference design-system.css in your layout');
|
|
112
|
-
logger.dim(' 2. Register theme in Program.cs');
|
|
113
|
-
logger.dim(' 3. Apply theme to your components');
|
|
114
|
-
logger.blank();
|
|
115
|
-
|
|
116
|
-
} catch (error) {
|
|
117
|
-
spinner.fail('Generation failed');
|
|
118
|
-
logger.error(error.message);
|
|
119
|
-
process.exit(1);
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
// ============================================================================
|
|
124
|
-
// Metadata Subcommand
|
|
125
|
-
// ============================================================================
|
|
126
|
-
|
|
127
|
-
/**
|
|
128
|
-
* Generate metadata.json from feature outputs
|
|
129
|
-
* @param {string} featureName - Feature name
|
|
130
|
-
* @param {Object} options - CLI options
|
|
131
|
-
*/
|
|
132
|
-
export async function generateMetadataCommand(featureName, options) {
|
|
133
|
-
if (!featureName) {
|
|
134
|
-
logger.error('Feature name required');
|
|
135
|
-
logger.dim(' Usage: morph-spec generate metadata <feature>');
|
|
136
|
-
logger.blank();
|
|
137
|
-
logger.dim(' Example:');
|
|
138
|
-
logger.dim(' morph-spec generate metadata my-feature');
|
|
139
|
-
process.exit(1);
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
logger.header('MORPH-SPEC Metadata Generator');
|
|
143
|
-
logger.blank();
|
|
144
|
-
|
|
145
|
-
const spinner = ora('Extracting metadata...').start();
|
|
146
|
-
|
|
147
|
-
try {
|
|
148
|
-
// Get feature state
|
|
149
|
-
const feature = getFeature(featureName);
|
|
150
|
-
if (!feature) {
|
|
151
|
-
spinner.fail('Feature not found');
|
|
152
|
-
logger.error(`Feature not found: ${featureName}`);
|
|
153
|
-
process.exit(1);
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
// Extract metadata
|
|
157
|
-
const metadata = extractFeatureMetadata(feature);
|
|
158
|
-
|
|
159
|
-
spinner.succeed('Metadata extracted!');
|
|
160
|
-
logger.blank();
|
|
161
|
-
|
|
162
|
-
// Display summary
|
|
163
|
-
logger.header('Feature Summary:');
|
|
164
|
-
logger.info(`Feature: ${chalk.cyan(metadata.feature)}`);
|
|
165
|
-
logger.info(`Phase: ${chalk.cyan(metadata.phase)}`);
|
|
166
|
-
logger.info(`Status: ${chalk.cyan(metadata.status)}`);
|
|
167
|
-
|
|
168
|
-
if (metadata.progress) {
|
|
169
|
-
const progressBar = '█'.repeat(Math.floor(metadata.progress.percentage / 5)) +
|
|
170
|
-
'░'.repeat(20 - Math.floor(metadata.progress.percentage / 5));
|
|
171
|
-
logger.info(`Progress: ${chalk.cyan(`${metadata.progress.completed}/${metadata.progress.total}`)} ${progressBar} ${chalk.cyan(metadata.progress.percentage + '%')}`);
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
logger.info(`Active Agents: ${chalk.cyan(metadata.agents.length)}`);
|
|
175
|
-
logger.info(`Checkpoints: ${chalk.cyan(metadata.checkpoints.length)}`);
|
|
176
|
-
logger.blank();
|
|
177
|
-
|
|
178
|
-
// Show outputs
|
|
179
|
-
logger.header('Outputs Extracted:');
|
|
180
|
-
Object.entries(metadata.outputs).forEach(([type, data]) => {
|
|
181
|
-
if (data.error) {
|
|
182
|
-
logger.error(` ✗ ${type}: ${data.error}`);
|
|
183
|
-
} else {
|
|
184
|
-
logger.success(` ✓ ${type}`);
|
|
185
|
-
|
|
186
|
-
// Show key stats
|
|
187
|
-
if (type === 'spec' && data.summary) {
|
|
188
|
-
logger.dim(` Tags: ${data.summary.tags.join(', ')}`);
|
|
189
|
-
}
|
|
190
|
-
if (type === 'decisions' && data.total) {
|
|
191
|
-
logger.dim(` Decisions: ${data.total} ADRs`);
|
|
192
|
-
}
|
|
193
|
-
if (type === 'tasks' && data.total) {
|
|
194
|
-
logger.dim(` Tasks: ${data.total} (${data.regularTasks} regular + ${data.checkpoints} checkpoints)`);
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
});
|
|
198
|
-
logger.blank();
|
|
199
|
-
|
|
200
|
-
if (options.dryRun) {
|
|
201
|
-
logger.warn('Dry run - file not written');
|
|
202
|
-
logger.blank();
|
|
203
|
-
return;
|
|
204
|
-
}
|
|
205
|
-
|
|
206
|
-
// Determine output path
|
|
207
|
-
const outputPath = options.output ||
|
|
208
|
-
join(process.cwd(), `.morph/features/${featureName}/metadata.json`);
|
|
209
|
-
|
|
210
|
-
// Write metadata
|
|
211
|
-
const writeSpinner = ora('Writing metadata.json...').start();
|
|
212
|
-
|
|
213
|
-
mkdirSync(dirname(outputPath), { recursive: true });
|
|
214
|
-
|
|
215
|
-
const jsonContent = options.pretty !== false
|
|
216
|
-
? JSON.stringify(metadata, null, 2)
|
|
217
|
-
: JSON.stringify(metadata);
|
|
218
|
-
|
|
219
|
-
writeFileSync(outputPath, jsonContent, 'utf8');
|
|
220
|
-
|
|
221
|
-
writeSpinner.succeed('Metadata generated!');
|
|
222
|
-
logger.blank();
|
|
223
|
-
|
|
224
|
-
logger.success(` ✓ ${outputPath}`);
|
|
225
|
-
logger.blank();
|
|
226
|
-
|
|
227
|
-
// Usage tip
|
|
228
|
-
logger.header('💡 Usage:');
|
|
229
|
-
logger.dim(` cat ${outputPath}`);
|
|
230
|
-
logger.dim(` # Quick status check - no need to read full markdown files`);
|
|
231
|
-
logger.blank();
|
|
232
|
-
|
|
233
|
-
} catch (error) {
|
|
234
|
-
spinner.fail('Generation failed');
|
|
235
|
-
logger.error(error.message);
|
|
236
|
-
if (error.stack) {
|
|
237
|
-
logger.dim(error.stack);
|
|
238
|
-
}
|
|
239
|
-
process.exit(1);
|
|
240
|
-
}
|
|
241
|
-
}
|
|
242
|
-
|
|
243
|
-
// ============================================================================
|
|
244
|
-
// Main Generate Command (router for future subcommands)
|
|
245
|
-
// ============================================================================
|
|
246
|
-
|
|
247
|
-
/**
|
|
248
|
-
* Main generate command router
|
|
249
|
-
* Future: Could add more generation commands here
|
|
250
|
-
*/
|
|
251
|
-
export async function generateCommand(subcommand, args, options) {
|
|
252
|
-
switch (subcommand) {
|
|
253
|
-
case 'design-system':
|
|
254
|
-
await generateDesignSystemCommand(args[0], options);
|
|
255
|
-
break;
|
|
256
|
-
|
|
257
|
-
case 'metadata':
|
|
258
|
-
await generateMetadataCommand(args[0], options);
|
|
259
|
-
break;
|
|
260
|
-
|
|
261
|
-
// Future: Add more generation commands
|
|
262
|
-
// case 'component':
|
|
263
|
-
// await generateComponentCommand(args[0], options);
|
|
264
|
-
// break;
|
|
265
|
-
|
|
266
|
-
default:
|
|
267
|
-
logger.error(`Unknown subcommand: ${subcommand}`);
|
|
268
|
-
logger.blank();
|
|
269
|
-
logger.info('Available subcommands:');
|
|
270
|
-
logger.dim(' design-system Generate CSS + theme files from ui-design-system.md');
|
|
271
|
-
logger.dim(' metadata Generate metadata.json from feature outputs');
|
|
272
|
-
logger.blank();
|
|
273
|
-
logger.dim('Run "morph-spec generate --help" for more information');
|
|
274
|
-
process.exit(1);
|
|
275
|
-
}
|
|
276
|
-
}
|