eai-cli 0.0.0-bootstrap.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +183 -0
- package/NOTICE +4 -0
- package/README.md +14 -0
- package/dist/commands/agent.d.ts +3 -0
- package/dist/commands/agent.d.ts.map +1 -0
- package/dist/commands/agent.js +69 -0
- package/dist/commands/agent.js.map +1 -0
- package/dist/commands/blocks.d.ts +3 -0
- package/dist/commands/blocks.d.ts.map +1 -0
- package/dist/commands/blocks.js +249 -0
- package/dist/commands/blocks.js.map +1 -0
- package/dist/commands/chat.d.ts +6 -0
- package/dist/commands/chat.d.ts.map +1 -0
- package/dist/commands/chat.js +105 -0
- package/dist/commands/chat.js.map +1 -0
- package/dist/commands/deploy.d.ts +36 -0
- package/dist/commands/deploy.d.ts.map +1 -0
- package/dist/commands/deploy.js +712 -0
- package/dist/commands/deploy.js.map +1 -0
- package/dist/commands/dev.d.ts +15 -0
- package/dist/commands/dev.d.ts.map +1 -0
- package/dist/commands/dev.js +133 -0
- package/dist/commands/dev.js.map +1 -0
- package/dist/commands/docs.d.ts +6 -0
- package/dist/commands/docs.d.ts.map +1 -0
- package/dist/commands/docs.js +118 -0
- package/dist/commands/docs.js.map +1 -0
- package/dist/commands/env.d.ts +10 -0
- package/dist/commands/env.d.ts.map +1 -0
- package/dist/commands/env.js +200 -0
- package/dist/commands/env.js.map +1 -0
- package/dist/commands/errors.d.ts +3 -0
- package/dist/commands/errors.d.ts.map +1 -0
- package/dist/commands/errors.js +72 -0
- package/dist/commands/errors.js.map +1 -0
- package/dist/commands/gofer.d.ts +3 -0
- package/dist/commands/gofer.d.ts.map +1 -0
- package/dist/commands/gofer.js +134 -0
- package/dist/commands/gofer.js.map +1 -0
- package/dist/commands/init.d.ts +14 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +1437 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/login.d.ts +7 -0
- package/dist/commands/login.d.ts.map +1 -0
- package/dist/commands/login.js +117 -0
- package/dist/commands/login.js.map +1 -0
- package/dist/commands/provision.d.ts +6 -0
- package/dist/commands/provision.d.ts.map +1 -0
- package/dist/commands/provision.js +855 -0
- package/dist/commands/provision.js.map +1 -0
- package/dist/commands/publicapi.d.ts +6 -0
- package/dist/commands/publicapi.d.ts.map +1 -0
- package/dist/commands/publicapi.js +184 -0
- package/dist/commands/publicapi.js.map +1 -0
- package/dist/commands/resources.d.ts +38 -0
- package/dist/commands/resources.d.ts.map +1 -0
- package/dist/commands/resources.js +1010 -0
- package/dist/commands/resources.js.map +1 -0
- package/dist/commands/runtime.d.ts +3 -0
- package/dist/commands/runtime.d.ts.map +1 -0
- package/dist/commands/runtime.js +78 -0
- package/dist/commands/runtime.js.map +1 -0
- package/dist/commands/template.d.ts +3 -0
- package/dist/commands/template.d.ts.map +1 -0
- package/dist/commands/template.js +365 -0
- package/dist/commands/template.js.map +1 -0
- package/dist/commands/tenant.d.ts +45 -0
- package/dist/commands/tenant.d.ts.map +1 -0
- package/dist/commands/tenant.js +1036 -0
- package/dist/commands/tenant.js.map +1 -0
- package/dist/commands/types.d.ts +130 -0
- package/dist/commands/types.d.ts.map +1 -0
- package/dist/commands/types.js +1636 -0
- package/dist/commands/types.js.map +1 -0
- package/dist/commands/update.d.ts +13 -0
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/update.js +163 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/commands/user.d.ts +6 -0
- package/dist/commands/user.d.ts.map +1 -0
- package/dist/commands/user.js +359 -0
- package/dist/commands/user.js.map +1 -0
- package/dist/commands/verify.d.ts +40 -0
- package/dist/commands/verify.d.ts.map +1 -0
- package/dist/commands/verify.js +1442 -0
- package/dist/commands/verify.js.map +1 -0
- package/dist/commands/vertical.d.ts +24 -0
- package/dist/commands/vertical.d.ts.map +1 -0
- package/dist/commands/vertical.js +301 -0
- package/dist/commands/vertical.js.map +1 -0
- package/dist/commands/whoami.d.ts +6 -0
- package/dist/commands/whoami.d.ts.map +1 -0
- package/dist/commands/whoami.js +73 -0
- package/dist/commands/whoami.js.map +1 -0
- package/dist/commands/workflow.d.ts +6 -0
- package/dist/commands/workflow.d.ts.map +1 -0
- package/dist/commands/workflow.js +400 -0
- package/dist/commands/workflow.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +272 -0
- package/dist/index.js.map +1 -0
- package/dist/lib/agent-guide.d.ts +24 -0
- package/dist/lib/agent-guide.d.ts.map +1 -0
- package/dist/lib/agent-guide.js +155 -0
- package/dist/lib/agent-guide.js.map +1 -0
- package/dist/lib/api.d.ts +338 -0
- package/dist/lib/api.d.ts.map +1 -0
- package/dist/lib/api.js +991 -0
- package/dist/lib/api.js.map +1 -0
- package/dist/lib/auth.d.ts +65 -0
- package/dist/lib/auth.d.ts.map +1 -0
- package/dist/lib/auth.js +592 -0
- package/dist/lib/auth.js.map +1 -0
- package/dist/lib/azure-cli.d.ts +6 -0
- package/dist/lib/azure-cli.d.ts.map +1 -0
- package/dist/lib/azure-cli.js +13 -0
- package/dist/lib/azure-cli.js.map +1 -0
- package/dist/lib/block-catalog-normalize.d.ts +47 -0
- package/dist/lib/block-catalog-normalize.d.ts.map +1 -0
- package/dist/lib/block-catalog-normalize.js +355 -0
- package/dist/lib/block-catalog-normalize.js.map +1 -0
- package/dist/lib/block-catalog-types.d.ts +111 -0
- package/dist/lib/block-catalog-types.d.ts.map +1 -0
- package/dist/lib/block-catalog-types.js +41 -0
- package/dist/lib/block-catalog-types.js.map +1 -0
- package/dist/lib/block-catalog-utils.d.ts +7 -0
- package/dist/lib/block-catalog-utils.d.ts.map +1 -0
- package/dist/lib/block-catalog-utils.js +47 -0
- package/dist/lib/block-catalog-utils.js.map +1 -0
- package/dist/lib/block-catalog-validation.d.ts +5 -0
- package/dist/lib/block-catalog-validation.d.ts.map +1 -0
- package/dist/lib/block-catalog-validation.js +112 -0
- package/dist/lib/block-catalog-validation.js.map +1 -0
- package/dist/lib/block-catalog.d.ts +3 -0
- package/dist/lib/block-catalog.d.ts.map +1 -0
- package/dist/lib/block-catalog.js +284 -0
- package/dist/lib/block-catalog.js.map +1 -0
- package/dist/lib/cloud-env.d.ts +25 -0
- package/dist/lib/cloud-env.d.ts.map +1 -0
- package/dist/lib/cloud-env.js +79 -0
- package/dist/lib/cloud-env.js.map +1 -0
- package/dist/lib/config.d.ts +116 -0
- package/dist/lib/config.d.ts.map +1 -0
- package/dist/lib/config.js +195 -0
- package/dist/lib/config.js.map +1 -0
- package/dist/lib/context.d.ts +43 -0
- package/dist/lib/context.d.ts.map +1 -0
- package/dist/lib/context.js +68 -0
- package/dist/lib/context.js.map +1 -0
- package/dist/lib/error-codes.d.ts +56 -0
- package/dist/lib/error-codes.d.ts.map +1 -0
- package/dist/lib/error-codes.js +211 -0
- package/dist/lib/error-codes.js.map +1 -0
- package/dist/lib/error-guidance/catalog.d.ts +648 -0
- package/dist/lib/error-guidance/catalog.d.ts.map +1 -0
- package/dist/lib/error-guidance/catalog.js +940 -0
- package/dist/lib/error-guidance/catalog.js.map +1 -0
- package/dist/lib/error-guidance/match.d.ts +3 -0
- package/dist/lib/error-guidance/match.d.ts.map +1 -0
- package/dist/lib/error-guidance/match.js +46 -0
- package/dist/lib/error-guidance/match.js.map +1 -0
- package/dist/lib/error-guidance/render.d.ts +5 -0
- package/dist/lib/error-guidance/render.d.ts.map +1 -0
- package/dist/lib/error-guidance/render.js +92 -0
- package/dist/lib/error-guidance/render.js.map +1 -0
- package/dist/lib/error-guidance/types.d.ts +76 -0
- package/dist/lib/error-guidance/types.d.ts.map +1 -0
- package/dist/lib/error-guidance/types.js +2 -0
- package/dist/lib/error-guidance/types.js.map +1 -0
- package/dist/lib/error-guidance/validate.d.ts +3 -0
- package/dist/lib/error-guidance/validate.d.ts.map +1 -0
- package/dist/lib/error-guidance/validate.js +59 -0
- package/dist/lib/error-guidance/validate.js.map +1 -0
- package/dist/lib/gofer-installer.d.ts +32 -0
- package/dist/lib/gofer-installer.d.ts.map +1 -0
- package/dist/lib/gofer-installer.js +589 -0
- package/dist/lib/gofer-installer.js.map +1 -0
- package/dist/lib/gofer-refresh.d.ts +46 -0
- package/dist/lib/gofer-refresh.d.ts.map +1 -0
- package/dist/lib/gofer-refresh.js +536 -0
- package/dist/lib/gofer-refresh.js.map +1 -0
- package/dist/lib/next-route-exports.d.ts +6 -0
- package/dist/lib/next-route-exports.d.ts.map +1 -0
- package/dist/lib/next-route-exports.js +127 -0
- package/dist/lib/next-route-exports.js.map +1 -0
- package/dist/lib/npm.d.ts +2 -0
- package/dist/lib/npm.d.ts.map +1 -0
- package/dist/lib/npm.js +4 -0
- package/dist/lib/npm.js.map +1 -0
- package/dist/lib/object-type-defaults.d.ts +4 -0
- package/dist/lib/object-type-defaults.d.ts.map +1 -0
- package/dist/lib/object-type-defaults.js +72 -0
- package/dist/lib/object-type-defaults.js.map +1 -0
- package/dist/lib/output.d.ts +35 -0
- package/dist/lib/output.d.ts.map +1 -0
- package/dist/lib/output.js +166 -0
- package/dist/lib/output.js.map +1 -0
- package/dist/lib/profile.d.ts +52 -0
- package/dist/lib/profile.d.ts.map +1 -0
- package/dist/lib/profile.js +116 -0
- package/dist/lib/profile.js.map +1 -0
- package/dist/lib/project-manifest.d.ts +42 -0
- package/dist/lib/project-manifest.d.ts.map +1 -0
- package/dist/lib/project-manifest.js +191 -0
- package/dist/lib/project-manifest.js.map +1 -0
- package/dist/lib/resourceapi-bundle.d.ts +33 -0
- package/dist/lib/resourceapi-bundle.d.ts.map +1 -0
- package/dist/lib/resourceapi-bundle.js +79 -0
- package/dist/lib/resourceapi-bundle.js.map +1 -0
- package/dist/lib/runtime-contract.d.ts +84 -0
- package/dist/lib/runtime-contract.d.ts.map +1 -0
- package/dist/lib/runtime-contract.js +318 -0
- package/dist/lib/runtime-contract.js.map +1 -0
- package/dist/lib/schema-builder.d.ts +28 -0
- package/dist/lib/schema-builder.d.ts.map +1 -0
- package/dist/lib/schema-builder.js +69 -0
- package/dist/lib/schema-builder.js.map +1 -0
- package/dist/lib/tenant-context.d.ts +127 -0
- package/dist/lib/tenant-context.d.ts.map +1 -0
- package/dist/lib/tenant-context.js +573 -0
- package/dist/lib/tenant-context.js.map +1 -0
- package/dist/lib/update-check.d.ts +52 -0
- package/dist/lib/update-check.d.ts.map +1 -0
- package/dist/lib/update-check.js +271 -0
- package/dist/lib/update-check.js.map +1 -0
- package/dist/lib/update-maintenance.d.ts +15 -0
- package/dist/lib/update-maintenance.d.ts.map +1 -0
- package/dist/lib/update-maintenance.js +187 -0
- package/dist/lib/update-maintenance.js.map +1 -0
- package/dist/lib/utils.d.ts +23 -0
- package/dist/lib/utils.d.ts.map +1 -0
- package/dist/lib/utils.js +48 -0
- package/dist/lib/utils.js.map +1 -0
- package/dist/lib/workflow-provisioning.d.ts +54 -0
- package/dist/lib/workflow-provisioning.d.ts.map +1 -0
- package/dist/lib/workflow-provisioning.js +281 -0
- package/dist/lib/workflow-provisioning.js.map +1 -0
- package/package.json +51 -0
- package/resources/gofer/.gofer-version +7 -0
- package/resources/gofer/agents-skills/0_gofer_start/SKILL.md +1287 -0
- package/resources/gofer/agents-skills/0a_problem_validation/SKILL.md +429 -0
- package/resources/gofer/agents-skills/10_gofer_cloud/SKILL.md +635 -0
- package/resources/gofer/agents-skills/1_gofer_research/SKILL.md +1159 -0
- package/resources/gofer/agents-skills/2_gofer_specify/SKILL.md +860 -0
- package/resources/gofer/agents-skills/3_gofer_plan/SKILL.md +886 -0
- package/resources/gofer/agents-skills/4_gofer_tasks/SKILL.md +748 -0
- package/resources/gofer/agents-skills/5_gofer_implement/SKILL.md +924 -0
- package/resources/gofer/agents-skills/6_gofer_validate/SKILL.md +2269 -0
- package/resources/gofer/agents-skills/7_gofer_save/SKILL.md +423 -0
- package/resources/gofer/agents-skills/7a_stakeholder_comms/SKILL.md +508 -0
- package/resources/gofer/agents-skills/8_gofer_branding/SKILL.md +315 -0
- package/resources/gofer/agents-skills/9_gofer_tests/SKILL.md +558 -0
- package/resources/gofer/agents-skills/gofer_bootstrap_workspace/SKILL.md +148 -0
- package/resources/gofer/agents-skills/gofer_check_workspace/SKILL.md +119 -0
- package/resources/gofer/agents-skills/gofer_constitution/SKILL.md +612 -0
- package/resources/gofer/agents-skills/gofer_diagnose/SKILL.md +114 -0
- package/resources/gofer/agents-skills/gofer_eai_first_run/SKILL.md +397 -0
- package/resources/gofer/agents-skills/gofer_hydrate/SKILL.md +561 -0
- package/resources/gofer/agents-skills/gofer_personality/SKILL.md +44 -0
- package/resources/gofer/agents-skills/gofer_plan/SKILL.md +40 -0
- package/resources/gofer/agents-skills/gofer_side/SKILL.md +45 -0
- package/resources/gofer/agents-skills/gofer_spec_summary/SKILL.md +112 -0
- package/resources/gofer/agents-skills/gofer_tdd/SKILL.md +112 -0
- package/resources/gofer/agents-skills/gofer_vocabulary/SKILL.md +112 -0
- package/resources/gofer/agents-skills/gofer_zoom_out/SKILL.md +112 -0
- package/resources/gofer/bash-scripts/check-context-health.sh +365 -0
- package/resources/gofer/bash-scripts/check-persona-pack.sh +81 -0
- package/resources/gofer/bash-scripts/check-prerequisites.sh +168 -0
- package/resources/gofer/bash-scripts/common.sh +192 -0
- package/resources/gofer/bash-scripts/create-new-feature.sh +260 -0
- package/resources/gofer/bash-scripts/install-optional-tools.sh +270 -0
- package/resources/gofer/bash-scripts/log-stage.sh +224 -0
- package/resources/gofer/bash-scripts/mark-task-complete.sh +74 -0
- package/resources/gofer/bash-scripts/pipeline-state.sh +306 -0
- package/resources/gofer/bash-scripts/read-failed-approaches.sh +114 -0
- package/resources/gofer/bash-scripts/read-session-memories.sh +96 -0
- package/resources/gofer/bash-scripts/save-checkpoint.sh +407 -0
- package/resources/gofer/bash-scripts/setup-plan.sh +62 -0
- package/resources/gofer/bash-scripts/sync-implementation-status.sh +47 -0
- package/resources/gofer/bash-scripts/update-agent-context.sh +772 -0
- package/resources/gofer/bash-scripts/validate-artifact.sh +335 -0
- package/resources/gofer/bash-scripts/verify-task.sh +384 -0
- package/resources/gofer/bash-scripts/write-failed-approach.sh +110 -0
- package/resources/gofer/bash-scripts/write-periodic-checkpoint.sh +128 -0
- package/resources/gofer/bash-scripts/write-session-memory.sh +118 -0
- package/resources/gofer/claude-agents/assumption-tracker.md +168 -0
- package/resources/gofer/claude-agents/business-metrics-analyzer.md +169 -0
- package/resources/gofer/claude-agents/business-problem-validator.md +168 -0
- package/resources/gofer/claude-agents/codebase-analyzer.md +124 -0
- package/resources/gofer/claude-agents/codebase-locator.md +95 -0
- package/resources/gofer/claude-agents/codebase-pattern-finder.md +180 -0
- package/resources/gofer/claude-agents/comms-writer.md +158 -0
- package/resources/gofer/claude-agents/engineer-review.md +169 -0
- package/resources/gofer/claude-agents/implement-bug-triangulator.md +94 -0
- package/resources/gofer/claude-agents/implement-code-review-council.md +89 -0
- package/resources/gofer/claude-agents/implement-doc-writer.md +89 -0
- package/resources/gofer/claude-agents/implement-error-hardener.md +84 -0
- package/resources/gofer/claude-agents/implement-performance-explorer.md +95 -0
- package/resources/gofer/claude-agents/implement-test-diversifier.md +82 -0
- package/resources/gofer/claude-agents/implement-variant-generator.md +80 -0
- package/resources/gofer/claude-agents/multi-perspective-judge.md +114 -0
- package/resources/gofer/claude-agents/plan-api-comparator.md +90 -0
- package/resources/gofer/claude-agents/plan-architecture-diverger.md +100 -0
- package/resources/gofer/claude-agents/plan-data-model-stress-tester.md +95 -0
- package/resources/gofer/claude-agents/plan-migration-path-finder.md +95 -0
- package/resources/gofer/claude-agents/plan-refactor-rewrite-advisor.md +97 -0
- package/resources/gofer/claude-agents/research-dependency-evaluator.md +106 -0
- package/resources/gofer/claude-agents/research-horizon-scanner.md +100 -0
- package/resources/gofer/claude-agents/research-market-scanner.md +137 -0
- package/resources/gofer/claude-agents/research-perspective-multiplier.md +102 -0
- package/resources/gofer/claude-agents/scope-creep-detector.md +152 -0
- package/resources/gofer/claude-agents/specify-ambiguity-detector.md +95 -0
- package/resources/gofer/claude-agents/specify-journey-stress-tester.md +92 -0
- package/resources/gofer/claude-agents/tasks-cross-cutting-scanner.md +91 -0
- package/resources/gofer/claude-agents/tasks-rollback-planner.md +89 -0
- package/resources/gofer/claude-agents/validate-security-red-team.md +102 -0
- package/resources/gofer/claude-agents/validation-correctness.md +103 -0
- package/resources/gofer/claude-agents/validation-integration.md +129 -0
- package/resources/gofer/claude-agents/validation-performance.md +120 -0
- package/resources/gofer/claude-agents/validation-security.md +115 -0
- package/resources/gofer/claude-agents/validation-standards.md +151 -0
- package/resources/gofer/claude-agents/validation-test-quality.md +146 -0
- package/resources/gofer/claude-agents/visual-bounded-context-writer.md +40 -0
- package/resources/gofer/claude-agents/visual-c4-writer.md +45 -0
- package/resources/gofer/claude-agents/visual-erd-writer.md +34 -0
- package/resources/gofer/claude-agents/visual-heatmap-writer.md +63 -0
- package/resources/gofer/claude-agents/visual-risk-writer.md +64 -0
- package/resources/gofer/claude-commands/0_gofer_start.md +1282 -0
- package/resources/gofer/claude-commands/0a_problem_validation.md +424 -0
- package/resources/gofer/claude-commands/10_gofer_cloud.md +630 -0
- package/resources/gofer/claude-commands/1_gofer_research.md +1154 -0
- package/resources/gofer/claude-commands/2_gofer_specify.md +855 -0
- package/resources/gofer/claude-commands/3_gofer_plan.md +881 -0
- package/resources/gofer/claude-commands/4_gofer_tasks.md +743 -0
- package/resources/gofer/claude-commands/5_gofer_implement.md +919 -0
- package/resources/gofer/claude-commands/6_gofer_validate.md +2264 -0
- package/resources/gofer/claude-commands/7_gofer_save.md +418 -0
- package/resources/gofer/claude-commands/7a_stakeholder_comms.md +503 -0
- package/resources/gofer/claude-commands/8_gofer_branding.md +310 -0
- package/resources/gofer/claude-commands/9_gofer_tests.md +553 -0
- package/resources/gofer/claude-commands/gofer_bootstrap_workspace.md +143 -0
- package/resources/gofer/claude-commands/gofer_check_workspace.md +114 -0
- package/resources/gofer/claude-commands/gofer_constitution.md +607 -0
- package/resources/gofer/claude-commands/gofer_diagnose.md +109 -0
- package/resources/gofer/claude-commands/gofer_eai_first_run.md +392 -0
- package/resources/gofer/claude-commands/gofer_hydrate.md +556 -0
- package/resources/gofer/claude-commands/gofer_personality.md +39 -0
- package/resources/gofer/claude-commands/gofer_plan.md +35 -0
- package/resources/gofer/claude-commands/gofer_side.md +40 -0
- package/resources/gofer/claude-commands/gofer_spec_summary.md +107 -0
- package/resources/gofer/claude-commands/gofer_tdd.md +107 -0
- package/resources/gofer/claude-commands/gofer_vocabulary.md +107 -0
- package/resources/gofer/claude-commands/gofer_zoom_out.md +107 -0
- package/resources/gofer/claude-skills/eai-gofer/SKILL.md +56 -0
- package/resources/gofer/commands/.gitkeep +0 -0
- package/resources/gofer/commands/0_gofer_start.md +1299 -0
- package/resources/gofer/commands/0a_problem_validation.md +405 -0
- package/resources/gofer/commands/10_gofer_cloud.md +611 -0
- package/resources/gofer/commands/1_gofer_research.md +1135 -0
- package/resources/gofer/commands/2_gofer_specify.md +836 -0
- package/resources/gofer/commands/3_gofer_plan.md +862 -0
- package/resources/gofer/commands/4_gofer_tasks.md +724 -0
- package/resources/gofer/commands/5_gofer_implement.md +900 -0
- package/resources/gofer/commands/6_gofer_validate.md +2245 -0
- package/resources/gofer/commands/7_gofer_save.md +399 -0
- package/resources/gofer/commands/7a_stakeholder_comms.md +484 -0
- package/resources/gofer/commands/8_gofer_branding.md +291 -0
- package/resources/gofer/commands/9_gofer_tests.md +534 -0
- package/resources/gofer/commands/gofer_bootstrap_workspace.md +159 -0
- package/resources/gofer/commands/gofer_check_workspace.md +130 -0
- package/resources/gofer/commands/gofer_constitution.md +588 -0
- package/resources/gofer/commands/gofer_diagnose.md +89 -0
- package/resources/gofer/commands/gofer_eai_first_run.md +392 -0
- package/resources/gofer/commands/gofer_hydrate.md +537 -0
- package/resources/gofer/commands/gofer_personality.md +61 -0
- package/resources/gofer/commands/gofer_plan.md +51 -0
- package/resources/gofer/commands/gofer_side.md +56 -0
- package/resources/gofer/commands/gofer_spec_summary.md +87 -0
- package/resources/gofer/commands/gofer_tdd.md +87 -0
- package/resources/gofer/commands/gofer_vocabulary.md +87 -0
- package/resources/gofer/commands/gofer_zoom_out.md +87 -0
- package/resources/gofer/copilot-instructions/gofer-cost.instructions.md +13 -0
- package/resources/gofer/copilot-instructions/language-server.instructions.md +49 -0
- package/resources/gofer/copilot-instructions/typescript.instructions.md +47 -0
- package/resources/gofer/copilot-instructions/vscode-extension.instructions.md +46 -0
- package/resources/gofer/copilot-prompts/0_gofer_start.prompt.md +1308 -0
- package/resources/gofer/copilot-prompts/0a_problem_validation.prompt.md +429 -0
- package/resources/gofer/copilot-prompts/10_gofer_cloud.prompt.md +644 -0
- package/resources/gofer/copilot-prompts/1_gofer_research.prompt.md +1177 -0
- package/resources/gofer/copilot-prompts/2_gofer_specify.prompt.md +878 -0
- package/resources/gofer/copilot-prompts/3_gofer_plan.prompt.md +904 -0
- package/resources/gofer/copilot-prompts/4_gofer_tasks.prompt.md +766 -0
- package/resources/gofer/copilot-prompts/5_gofer_implement.prompt.md +942 -0
- package/resources/gofer/copilot-prompts/6_gofer_validate.prompt.md +2277 -0
- package/resources/gofer/copilot-prompts/7_gofer_save.prompt.md +433 -0
- package/resources/gofer/copilot-prompts/7a_stakeholder_comms.prompt.md +516 -0
- package/resources/gofer/copilot-prompts/8_gofer_branding.prompt.md +323 -0
- package/resources/gofer/copilot-prompts/9_gofer_tests.prompt.md +566 -0
- package/resources/gofer/copilot-prompts/gofer_bootstrap_workspace.prompt.md +161 -0
- package/resources/gofer/copilot-prompts/gofer_check_workspace.prompt.md +132 -0
- package/resources/gofer/copilot-prompts/gofer_constitution.prompt.md +621 -0
- package/resources/gofer/copilot-prompts/gofer_diagnose.prompt.md +127 -0
- package/resources/gofer/copilot-prompts/gofer_eai_first_run.prompt.md +410 -0
- package/resources/gofer/copilot-prompts/gofer_hydrate.prompt.md +571 -0
- package/resources/gofer/copilot-prompts/gofer_personality.prompt.md +57 -0
- package/resources/gofer/copilot-prompts/gofer_plan.prompt.md +53 -0
- package/resources/gofer/copilot-prompts/gofer_side.prompt.md +58 -0
- package/resources/gofer/copilot-prompts/gofer_spec_summary.prompt.md +125 -0
- package/resources/gofer/copilot-prompts/gofer_tdd.prompt.md +125 -0
- package/resources/gofer/copilot-prompts/gofer_vocabulary.prompt.md +125 -0
- package/resources/gofer/copilot-prompts/gofer_zoom_out.prompt.md +125 -0
- package/resources/gofer/gemini/agents/assumption-tracker.md +171 -0
- package/resources/gofer/gemini/agents/business-metrics-analyzer.md +172 -0
- package/resources/gofer/gemini/agents/business-problem-validator.md +171 -0
- package/resources/gofer/gemini/agents/codebase-analyzer.md +127 -0
- package/resources/gofer/gemini/agents/codebase-locator.md +98 -0
- package/resources/gofer/gemini/agents/codebase-pattern-finder.md +183 -0
- package/resources/gofer/gemini/agents/comms-writer.md +161 -0
- package/resources/gofer/gemini/agents/engineer-review.md +172 -0
- package/resources/gofer/gemini/agents/implement-bug-triangulator.md +97 -0
- package/resources/gofer/gemini/agents/implement-code-review-council.md +92 -0
- package/resources/gofer/gemini/agents/implement-doc-writer.md +92 -0
- package/resources/gofer/gemini/agents/implement-error-hardener.md +87 -0
- package/resources/gofer/gemini/agents/implement-performance-explorer.md +98 -0
- package/resources/gofer/gemini/agents/implement-test-diversifier.md +85 -0
- package/resources/gofer/gemini/agents/implement-variant-generator.md +83 -0
- package/resources/gofer/gemini/agents/multi-perspective-judge.md +117 -0
- package/resources/gofer/gemini/agents/plan-api-comparator.md +93 -0
- package/resources/gofer/gemini/agents/plan-architecture-diverger.md +103 -0
- package/resources/gofer/gemini/agents/plan-data-model-stress-tester.md +98 -0
- package/resources/gofer/gemini/agents/plan-migration-path-finder.md +98 -0
- package/resources/gofer/gemini/agents/plan-refactor-rewrite-advisor.md +100 -0
- package/resources/gofer/gemini/agents/research-dependency-evaluator.md +109 -0
- package/resources/gofer/gemini/agents/research-horizon-scanner.md +103 -0
- package/resources/gofer/gemini/agents/research-market-scanner.md +140 -0
- package/resources/gofer/gemini/agents/research-perspective-multiplier.md +105 -0
- package/resources/gofer/gemini/agents/scope-creep-detector.md +155 -0
- package/resources/gofer/gemini/agents/specify-ambiguity-detector.md +98 -0
- package/resources/gofer/gemini/agents/specify-journey-stress-tester.md +95 -0
- package/resources/gofer/gemini/agents/tasks-cross-cutting-scanner.md +94 -0
- package/resources/gofer/gemini/agents/tasks-rollback-planner.md +92 -0
- package/resources/gofer/gemini/agents/validate-security-red-team.md +105 -0
- package/resources/gofer/gemini/agents/validation-correctness.md +106 -0
- package/resources/gofer/gemini/agents/validation-integration.md +132 -0
- package/resources/gofer/gemini/agents/validation-performance.md +123 -0
- package/resources/gofer/gemini/agents/validation-security.md +118 -0
- package/resources/gofer/gemini/agents/validation-standards.md +154 -0
- package/resources/gofer/gemini/agents/validation-test-quality.md +149 -0
- package/resources/gofer/gemini/agents/visual-bounded-context-writer.md +40 -0
- package/resources/gofer/gemini/agents/visual-c4-writer.md +44 -0
- package/resources/gofer/gemini/agents/visual-erd-writer.md +36 -0
- package/resources/gofer/gemini/agents/visual-heatmap-writer.md +63 -0
- package/resources/gofer/gemini/agents/visual-risk-writer.md +64 -0
- package/resources/gofer/gemini/commands/gofer/.gitkeep +0 -0
- package/resources/gofer/gemini/commands/gofer/0_gofer_start.md +1282 -0
- package/resources/gofer/gemini/commands/gofer/0_gofer_start.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/0a_problem_validation.md +424 -0
- package/resources/gofer/gemini/commands/gofer/0a_problem_validation.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/10_gofer_cloud.md +630 -0
- package/resources/gofer/gemini/commands/gofer/10_gofer_cloud.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/1_gofer_research.md +1154 -0
- package/resources/gofer/gemini/commands/gofer/1_gofer_research.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/2_gofer_specify.md +855 -0
- package/resources/gofer/gemini/commands/gofer/2_gofer_specify.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/3_gofer_plan.md +881 -0
- package/resources/gofer/gemini/commands/gofer/3_gofer_plan.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/4_gofer_tasks.md +743 -0
- package/resources/gofer/gemini/commands/gofer/4_gofer_tasks.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/5_gofer_implement.md +919 -0
- package/resources/gofer/gemini/commands/gofer/5_gofer_implement.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/6_gofer_validate.md +2264 -0
- package/resources/gofer/gemini/commands/gofer/6_gofer_validate.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/7_gofer_save.md +418 -0
- package/resources/gofer/gemini/commands/gofer/7_gofer_save.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/7a_stakeholder_comms.md +503 -0
- package/resources/gofer/gemini/commands/gofer/7a_stakeholder_comms.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/8_gofer_branding.md +310 -0
- package/resources/gofer/gemini/commands/gofer/8_gofer_branding.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/9_gofer_tests.md +553 -0
- package/resources/gofer/gemini/commands/gofer/9_gofer_tests.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_bootstrap_workspace.md +143 -0
- package/resources/gofer/gemini/commands/gofer/gofer_bootstrap_workspace.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_check_workspace.md +114 -0
- package/resources/gofer/gemini/commands/gofer/gofer_check_workspace.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_constitution.md +607 -0
- package/resources/gofer/gemini/commands/gofer/gofer_constitution.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_diagnose.md +109 -0
- package/resources/gofer/gemini/commands/gofer/gofer_diagnose.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_eai_first_run.md +392 -0
- package/resources/gofer/gemini/commands/gofer/gofer_eai_first_run.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_hydrate.md +556 -0
- package/resources/gofer/gemini/commands/gofer/gofer_hydrate.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_personality.md +39 -0
- package/resources/gofer/gemini/commands/gofer/gofer_personality.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_plan.md +35 -0
- package/resources/gofer/gemini/commands/gofer/gofer_plan.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_side.md +40 -0
- package/resources/gofer/gemini/commands/gofer/gofer_side.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_spec_summary.md +107 -0
- package/resources/gofer/gemini/commands/gofer/gofer_spec_summary.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_tdd.md +107 -0
- package/resources/gofer/gemini/commands/gofer/gofer_tdd.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_vocabulary.md +107 -0
- package/resources/gofer/gemini/commands/gofer/gofer_vocabulary.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/gofer_zoom_out.md +107 -0
- package/resources/gofer/gemini/commands/gofer/gofer_zoom_out.toml +2 -0
- package/resources/gofer/gemini/commands/gofer/manifest.json +32 -0
- package/resources/gofer/gemini/extension.json +16 -0
- package/resources/gofer/github-agents/gofer-business.agent.md +20 -0
- package/resources/gofer/github-agents/gofer-implement.agent.md +15 -0
- package/resources/gofer/github-agents/gofer-plan.agent.md +15 -0
- package/resources/gofer/github-agents/gofer-research.agent.md +15 -0
- package/resources/gofer/github-agents/gofer-validate.agent.md +10 -0
- package/resources/gofer/github-skills/eai-gofer/SKILL.md +56 -0
- package/resources/gofer/hook-scripts/agent-stop.mjs +655 -0
- package/resources/gofer/hook-scripts/log-stage-launch-time.mjs +77 -0
- package/resources/gofer/hook-scripts/post-tool-use.mjs +333 -0
- package/resources/gofer/hook-scripts/queued-input.mjs +188 -0
- package/resources/gofer/hook-scripts/session-lifecycle.mjs +93 -0
- package/resources/gofer/hook-scripts/user-prompt-submit.mjs +228 -0
- package/resources/gofer/instruction-templates/base/agents-base.md +37 -0
- package/resources/gofer/instruction-templates/base/claude-base.md +7 -0
- package/resources/gofer/instruction-templates/base/copilot-base.md +26 -0
- package/resources/gofer/instruction-templates/gofer/gofer-claude.md +5 -0
- package/resources/gofer/instruction-templates/gofer/gofer-copilot.md +9 -0
- package/resources/gofer/instruction-templates/languages/generic.md +7 -0
- package/resources/gofer/instruction-templates/languages/go.md +8 -0
- package/resources/gofer/instruction-templates/languages/java.md +8 -0
- package/resources/gofer/instruction-templates/languages/python.md +9 -0
- package/resources/gofer/instruction-templates/languages/rust.md +9 -0
- package/resources/gofer/instruction-templates/languages/typescript.md +19 -0
- package/resources/gofer/instruction-templates/workflow/principles.md +52 -0
- package/resources/gofer/memory/constitution.md +391 -0
- package/resources/gofer/memory/context-profiles.yaml +74 -0
- package/resources/gofer/memory/decisions/000-use-adr-for-decisions.md +67 -0
- package/resources/gofer/memory/decisions/001-di-framework.md +190 -0
- package/resources/gofer/memory/decisions/002-module-extraction.md +305 -0
- package/resources/gofer/memory/decisions/003-error-handling.md +368 -0
- package/resources/gofer/memory/decisions/004-cache-eviction.md +436 -0
- package/resources/gofer/memory/decisions/005-constants-management.md +520 -0
- package/resources/gofer/memory/decisions/README.md +129 -0
- package/resources/gofer/memory/diagrams/di-container.mmd +321 -0
- package/resources/gofer/memory/diagrams/extension-activation.mmd +184 -0
- package/resources/gofer/memory/diagrams/module-dependencies.mmd +264 -0
- package/resources/gofer/memory/gofer-model-policy.yaml +97 -0
- package/resources/gofer/memory/lessons.md +46 -0
- package/resources/gofer/node-scripts/canonical-descriptions.mjs +86 -0
- package/resources/gofer/node-scripts/check-version-alignment.mjs +131 -0
- package/resources/gofer/node-scripts/codex-doctor.mjs +425 -0
- package/resources/gofer/node-scripts/generate-commands.mjs +1366 -0
- package/resources/gofer/node-scripts/generate-issues.js +563 -0
- package/resources/gofer/node-scripts/gofer-closed-loop-audit.mjs +893 -0
- package/resources/gofer/node-scripts/gofer-loop-audit.mjs +541 -0
- package/resources/gofer/node-scripts/gofer-performance-report.mjs +306 -0
- package/resources/gofer/node-scripts/gofer-workspace-bootstrap.mjs +56 -0
- package/resources/gofer/node-scripts/gofer-workspace-check.mjs +56 -0
- package/resources/gofer/node-scripts/lib/ai-leverage-tagger.mjs +103 -0
- package/resources/gofer/node-scripts/lib/assemble-stakeholder-pack.mjs +114 -0
- package/resources/gofer/node-scripts/lib/marp-deck.mjs +87 -0
- package/resources/gofer/node-scripts/lib/mermaid-tabular-fallback.mjs +264 -0
- package/resources/gofer/node-scripts/lib/render-visual.mjs +54 -0
- package/resources/gofer/node-scripts/lib/validate-aliases.mjs +85 -0
- package/resources/gofer/node-scripts/lib/visual-counts.mjs +44 -0
- package/resources/gofer/node-scripts/lib/visual-pass-pipeline.mjs +134 -0
- package/resources/gofer/node-scripts/mermaid-export.mjs +72 -0
- package/resources/gofer/node-scripts/package-agent-plugin.mjs +940 -0
- package/resources/gofer/node-scripts/parse-stage-command.mjs +211 -0
- package/resources/gofer/node-scripts/schemas/.gitkeep +0 -0
- package/resources/gofer/node-scripts/schemas/stage-command.schema.json +72 -0
- package/resources/gofer/node-scripts/sync-extension-resources.mjs +110 -0
- package/resources/gofer/node-scripts/workspace-bootstrap-lib.mjs +1166 -0
- package/resources/gofer/powershell-scripts/install-optional-tools.ps1 +214 -0
- package/resources/gofer/references/platform/README.md +17 -0
- package/resources/gofer/references/platform/deployment-repo.md +9 -0
- package/resources/gofer/references/platform/eai-app-template.md +45 -0
- package/resources/gofer/references/platform/eai-config-driven-ui.md +156 -0
- package/resources/gofer/references/platform/eai-error-catalog.yaml +197 -0
- package/resources/gofer/references/platform/eai-repo-contract.md +134 -0
- package/resources/gofer/references/platform/eai-service-patterns.md +56 -0
- package/resources/gofer/references/platform/eai.md +85 -0
- package/resources/gofer/references/platform/vertical-template.md +49 -0
- package/resources/gofer/specify-commands/.gitkeep +0 -0
- package/resources/gofer/specify-commands/0_gofer_start.md +1299 -0
- package/resources/gofer/specify-commands/0a_problem_validation.md +405 -0
- package/resources/gofer/specify-commands/10_gofer_cloud.md +611 -0
- package/resources/gofer/specify-commands/1_gofer_research.md +1135 -0
- package/resources/gofer/specify-commands/2_gofer_specify.md +836 -0
- package/resources/gofer/specify-commands/3_gofer_plan.md +862 -0
- package/resources/gofer/specify-commands/4_gofer_tasks.md +724 -0
- package/resources/gofer/specify-commands/5_gofer_implement.md +900 -0
- package/resources/gofer/specify-commands/6_gofer_validate.md +2245 -0
- package/resources/gofer/specify-commands/7_gofer_save.md +399 -0
- package/resources/gofer/specify-commands/7a_stakeholder_comms.md +484 -0
- package/resources/gofer/specify-commands/8_gofer_branding.md +291 -0
- package/resources/gofer/specify-commands/9_gofer_tests.md +534 -0
- package/resources/gofer/specify-commands/gofer_bootstrap_workspace.md +159 -0
- package/resources/gofer/specify-commands/gofer_check_workspace.md +130 -0
- package/resources/gofer/specify-commands/gofer_constitution.md +588 -0
- package/resources/gofer/specify-commands/gofer_diagnose.md +89 -0
- package/resources/gofer/specify-commands/gofer_eai_first_run.md +392 -0
- package/resources/gofer/specify-commands/gofer_hydrate.md +537 -0
- package/resources/gofer/specify-commands/gofer_personality.md +61 -0
- package/resources/gofer/specify-commands/gofer_plan.md +51 -0
- package/resources/gofer/specify-commands/gofer_side.md +56 -0
- package/resources/gofer/specify-commands/gofer_spec_summary.md +87 -0
- package/resources/gofer/specify-commands/gofer_tdd.md +87 -0
- package/resources/gofer/specify-commands/gofer_vocabulary.md +87 -0
- package/resources/gofer/specify-commands/gofer_zoom_out.md +87 -0
- package/resources/gofer/system-skills/0_gofer_start/SKILL.md +1287 -0
- package/resources/gofer/system-skills/0a_problem_validation/SKILL.md +429 -0
- package/resources/gofer/system-skills/10_gofer_cloud/SKILL.md +635 -0
- package/resources/gofer/system-skills/1_gofer_research/SKILL.md +1159 -0
- package/resources/gofer/system-skills/2_gofer_specify/SKILL.md +860 -0
- package/resources/gofer/system-skills/3_gofer_plan/SKILL.md +886 -0
- package/resources/gofer/system-skills/4_gofer_tasks/SKILL.md +748 -0
- package/resources/gofer/system-skills/5_gofer_implement/SKILL.md +924 -0
- package/resources/gofer/system-skills/6_gofer_validate/SKILL.md +2269 -0
- package/resources/gofer/system-skills/7_gofer_save/SKILL.md +423 -0
- package/resources/gofer/system-skills/7a_stakeholder_comms/SKILL.md +508 -0
- package/resources/gofer/system-skills/8_gofer_branding/SKILL.md +315 -0
- package/resources/gofer/system-skills/9_gofer_tests/SKILL.md +558 -0
- package/resources/gofer/system-skills/gofer_bootstrap_workspace/SKILL.md +148 -0
- package/resources/gofer/system-skills/gofer_check_workspace/SKILL.md +119 -0
- package/resources/gofer/system-skills/gofer_constitution/SKILL.md +612 -0
- package/resources/gofer/system-skills/gofer_diagnose/SKILL.md +114 -0
- package/resources/gofer/system-skills/gofer_eai_first_run/SKILL.md +397 -0
- package/resources/gofer/system-skills/gofer_hydrate/SKILL.md +561 -0
- package/resources/gofer/system-skills/gofer_personality/SKILL.md +44 -0
- package/resources/gofer/system-skills/gofer_plan/SKILL.md +40 -0
- package/resources/gofer/system-skills/gofer_side/SKILL.md +45 -0
- package/resources/gofer/system-skills/gofer_spec_summary/SKILL.md +112 -0
- package/resources/gofer/system-skills/gofer_tdd/SKILL.md +112 -0
- package/resources/gofer/system-skills/gofer_vocabulary/SKILL.md +112 -0
- package/resources/gofer/system-skills/gofer_zoom_out/SKILL.md +112 -0
- package/resources/gofer/templates/agent-file-template.md +28 -0
- package/resources/gofer/templates/assumptions-template.md +94 -0
- package/resources/gofer/templates/audit-history-template.md +35 -0
- package/resources/gofer/templates/brand/brand-profile-template.json +45 -0
- package/resources/gofer/templates/brand/document-style-template.md +50 -0
- package/resources/gofer/templates/brand/marp-theme-template.css +58 -0
- package/resources/gofer/templates/brownfield-analysis.md +44 -0
- package/resources/gofer/templates/business-metrics-template.md +120 -0
- package/resources/gofer/templates/business-owner-summary-template.md +83 -0
- package/resources/gofer/templates/checklist-template.md +40 -0
- package/resources/gofer/templates/ciso-security-summary-template.md +70 -0
- package/resources/gofer/templates/context-bundle-template.md +76 -0
- package/resources/gofer/templates/contract-pack-template.md +109 -0
- package/resources/gofer/templates/cto-architecture-summary-template.md +83 -0
- package/resources/gofer/templates/discovery-template.md +92 -0
- package/resources/gofer/templates/eai-preflight-template.md +144 -0
- package/resources/gofer/templates/goal-ledger-template.json +69 -0
- package/resources/gofer/templates/gofer-model-policy.yaml +97 -0
- package/resources/gofer/templates/issues-template.md +106 -0
- package/resources/gofer/templates/journey/base-journey.md +95 -0
- package/resources/gofer/templates/journey/industry-variants.yaml +277 -0
- package/resources/gofer/templates/loop-contract-template.json +68 -0
- package/resources/gofer/templates/plan-template.md +215 -0
- package/resources/gofer/templates/problem-brief-template.md +85 -0
- package/resources/gofer/templates/proposal-review-template.md +79 -0
- package/resources/gofer/templates/research-template.md +222 -0
- package/resources/gofer/templates/reuse-scan-template.md +43 -0
- package/resources/gofer/templates/sequence-diagrams/option-spectrum.yaml +178 -0
- package/resources/gofer/templates/service-fit-matrix-template.md +29 -0
- package/resources/gofer/templates/session-handoff-template.md +172 -0
- package/resources/gofer/templates/spec-summary-template.md +118 -0
- package/resources/gofer/templates/spec-template.md +196 -0
- package/resources/gofer/templates/stakeholder-comms-template.md +330 -0
- package/resources/gofer/templates/stakeholder-review-index-template.md +54 -0
- package/resources/gofer/templates/tasks-template.md +323 -0
- package/resources/gofer/templates/ui-approval-template.md +32 -0
- package/resources/gofer/templates/ui-preview-brief-template.md +65 -0
- package/resources/gofer/templates/ui-review-log-template.md +11 -0
- package/resources/gofer/templates/visuals/.gitkeep +0 -0
- package/resources/gofer/templates/visuals/bounded-context-map.md +19 -0
- package/resources/gofer/templates/visuals/bounded-context-template.md +47 -0
- package/resources/gofer/templates/visuals/c4-container-template.md +38 -0
- package/resources/gofer/templates/visuals/c4-container.md +20 -0
- package/resources/gofer/templates/visuals/c4-context-template.md +46 -0
- package/resources/gofer/templates/visuals/capability-heatmap-template.md +54 -0
- package/resources/gofer/templates/visuals/data-model-erd-template.md +41 -0
- package/resources/gofer/templates/visuals/erd.md +19 -0
- package/resources/gofer/templates/visuals/impact-canvas.md +40 -0
- package/resources/gofer/templates/visuals/risk-heatmap-template.md +51 -0
- package/resources/gofer/templates/visuals/roi-projection.md +17 -0
- package/resources/gofer/templates/visuals/value-stream-asis.md +16 -0
- package/resources/gofer/templates/visuals/value-stream-tobe.md +18 -0
- package/resources/gofer/templates/working-backwards-prfaq-template.md +165 -0
- package/resources/linked-sources.json +25 -0
|
@@ -0,0 +1,712 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* eai deploy — deployment management.
|
|
3
|
+
*
|
|
4
|
+
* setup: Generate deploy-demo.yml + configure GitHub secrets
|
|
5
|
+
* trigger: Trigger deployment workflow
|
|
6
|
+
* status: Check deployment status
|
|
7
|
+
*/
|
|
8
|
+
import { Command } from 'commander';
|
|
9
|
+
import { execFile } from 'node:child_process';
|
|
10
|
+
import { promisify } from 'node:util';
|
|
11
|
+
import { access, writeFile, mkdir } from 'node:fs/promises';
|
|
12
|
+
import { join } from 'node:path';
|
|
13
|
+
import ora from 'ora';
|
|
14
|
+
import chalk from 'chalk';
|
|
15
|
+
import { findProjectRoot, loadEnvFile } from '../lib/config.js';
|
|
16
|
+
import * as out from '../lib/output.js';
|
|
17
|
+
import { ErrorCode, exitWithError } from '../lib/error-codes.js';
|
|
18
|
+
import { expectedStatuses, loadRuntimeContract, RUNTIME_CONTRACT_FILE, validateRuntimeContract, } from '../lib/runtime-contract.js';
|
|
19
|
+
const exec = promisify(execFile);
|
|
20
|
+
export const deployCommand = new Command('deploy')
|
|
21
|
+
.description('Deployment management');
|
|
22
|
+
// ─── eai deploy setup ─────────────────────────────────────────────────────
|
|
23
|
+
deployCommand
|
|
24
|
+
.command('setup')
|
|
25
|
+
.description('Generate deployment workflow and configure GitHub secrets')
|
|
26
|
+
.option('--repo <repo>', 'GitHub repo (org/name)')
|
|
27
|
+
.action(async (options) => {
|
|
28
|
+
const root = await findProjectRoot();
|
|
29
|
+
if (!root) {
|
|
30
|
+
exitWithError(ErrorCode.E001);
|
|
31
|
+
}
|
|
32
|
+
const envVars = await loadEnvFile(root);
|
|
33
|
+
const appName = envVars.NEXT_PUBLIC_APP_NAME || 'my-app';
|
|
34
|
+
// Check if workflow already exists
|
|
35
|
+
const workflowPath = join(root, '.github', 'workflows', 'deploy-demo.yml');
|
|
36
|
+
try {
|
|
37
|
+
await access(workflowPath);
|
|
38
|
+
out.warn('deploy-demo.yml already exists. Skipping workflow generation.');
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
const spinner = ora('Generating deploy-demo.yml...').start();
|
|
42
|
+
const workflowDir = join(root, '.github', 'workflows');
|
|
43
|
+
await mkdir(workflowDir, { recursive: true });
|
|
44
|
+
const workflow = generateWorkflow(appName);
|
|
45
|
+
await writeFile(workflowPath, workflow, 'utf-8');
|
|
46
|
+
spinner.succeed('Created .github/workflows/deploy-demo.yml');
|
|
47
|
+
}
|
|
48
|
+
// Configure GitHub secrets if repo is available
|
|
49
|
+
const repo = options.repo;
|
|
50
|
+
if (repo) {
|
|
51
|
+
out.heading('Configuring GitHub secrets');
|
|
52
|
+
out.info(`Repository: ${chalk.cyan(repo)}`);
|
|
53
|
+
const secrets = [
|
|
54
|
+
{ name: 'AZUREAPPSERVICE_CLIENTID', desc: 'Azure AD app client ID for deployment' },
|
|
55
|
+
{ name: 'AZUREAPPSERVICE_TENANTID', desc: 'Azure AD tenant ID' },
|
|
56
|
+
{ name: 'AZUREAPPSERVICE_SUBSCRIPTIONID', desc: 'Azure subscription ID' },
|
|
57
|
+
{ name: 'AZURE_RESOURCE_GROUP', desc: 'Resource group name' },
|
|
58
|
+
{ name: 'AZURE_WEBAPP_NAME', desc: 'App Service name' },
|
|
59
|
+
];
|
|
60
|
+
for (const secret of secrets) {
|
|
61
|
+
try {
|
|
62
|
+
await exec('gh', ['secret', 'list', '--repo', repo]);
|
|
63
|
+
out.info(`Configure ${chalk.cyan(secret.name)}: ${secret.desc}`);
|
|
64
|
+
}
|
|
65
|
+
catch {
|
|
66
|
+
out.warn(`Could not check secrets for ${repo}. Install and authenticate gh CLI.`);
|
|
67
|
+
break;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
out.blank();
|
|
71
|
+
out.info('Set secrets with: gh secret set SECRET_NAME --repo ' + repo);
|
|
72
|
+
}
|
|
73
|
+
else {
|
|
74
|
+
out.blank();
|
|
75
|
+
out.info('To configure GitHub secrets, re-run with --repo org/name');
|
|
76
|
+
}
|
|
77
|
+
});
|
|
78
|
+
// ─── eai deploy trigger ──────────────────────────────────────────────────
|
|
79
|
+
deployCommand
|
|
80
|
+
.command('trigger')
|
|
81
|
+
.description('Trigger deployment workflow')
|
|
82
|
+
.option('--repo <repo>', 'GitHub repo (org/name)')
|
|
83
|
+
.option('--branch <branch>', 'Branch to deploy', 'main')
|
|
84
|
+
.option('--workflow <name>', 'Workflow filename', 'deploy-demo.yml')
|
|
85
|
+
.option('--format <format>', 'Output format (text|json)', 'text')
|
|
86
|
+
.option('--json', 'Output raw JSON (deprecated, use --format json)', false)
|
|
87
|
+
.addHelpText('after', `
|
|
88
|
+
Examples:
|
|
89
|
+
$ eai deploy trigger
|
|
90
|
+
$ eai deploy trigger --branch develop
|
|
91
|
+
$ eai deploy trigger --repo eai-tools/my-app --format json
|
|
92
|
+
`)
|
|
93
|
+
.action(async (options) => {
|
|
94
|
+
let repo = options.repo;
|
|
95
|
+
if (options.json)
|
|
96
|
+
options.format = 'json';
|
|
97
|
+
if (!repo) {
|
|
98
|
+
// Try to detect from git remote
|
|
99
|
+
try {
|
|
100
|
+
const { stdout } = await exec('git', ['remote', 'get-url', 'origin']);
|
|
101
|
+
const match = stdout.trim().match(/github\.com[:/](.+?)(?:\.git)?$/);
|
|
102
|
+
if (match)
|
|
103
|
+
repo = match[1];
|
|
104
|
+
}
|
|
105
|
+
catch { /* can't detect */ }
|
|
106
|
+
}
|
|
107
|
+
if (!repo) {
|
|
108
|
+
exitWithError(ErrorCode.E305, { details: 'Could not detect GitHub repository. Use --repo org/name' }, options.format);
|
|
109
|
+
}
|
|
110
|
+
const spinner = options.format === 'json' ? null : ora(`Triggering ${options.workflow} on ${repo}...`).start();
|
|
111
|
+
try {
|
|
112
|
+
await exec('gh', [
|
|
113
|
+
'workflow', 'run', options.workflow,
|
|
114
|
+
'--repo', repo,
|
|
115
|
+
'--ref', options.branch,
|
|
116
|
+
]);
|
|
117
|
+
if (options.format === 'json') {
|
|
118
|
+
out.json({
|
|
119
|
+
triggered: true,
|
|
120
|
+
repo,
|
|
121
|
+
branch: options.branch,
|
|
122
|
+
workflow: options.workflow
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
else {
|
|
126
|
+
spinner.succeed(`Triggered deployment on ${chalk.cyan(repo)}@${options.branch}`);
|
|
127
|
+
out.info(`Check status: ${chalk.dim(`eai deploy status --repo ${repo}`)}`);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
catch (err) {
|
|
131
|
+
if (spinner)
|
|
132
|
+
spinner.fail(err instanceof Error ? err.message : String(err));
|
|
133
|
+
process.exit(1);
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
// ─── eai deploy status ──────────────────────────────────────────────────
|
|
137
|
+
deployCommand
|
|
138
|
+
.command('status')
|
|
139
|
+
.description('Check deployment status')
|
|
140
|
+
.option('--repo <repo>', 'GitHub repo (org/name)')
|
|
141
|
+
.option('--format <format>', 'Output format (text|json)', 'text')
|
|
142
|
+
.option('--json', 'Output raw JSON (deprecated, use --format json)', false)
|
|
143
|
+
.action(async (options) => {
|
|
144
|
+
let repo = options.repo;
|
|
145
|
+
if (options.json)
|
|
146
|
+
options.format = 'json';
|
|
147
|
+
if (!repo) {
|
|
148
|
+
try {
|
|
149
|
+
const { stdout } = await exec('git', ['remote', 'get-url', 'origin']);
|
|
150
|
+
const match = stdout.trim().match(/github\.com[:/](.+?)(?:\.git)?$/);
|
|
151
|
+
if (match)
|
|
152
|
+
repo = match[1];
|
|
153
|
+
}
|
|
154
|
+
catch { /* can't detect */ }
|
|
155
|
+
}
|
|
156
|
+
if (!repo) {
|
|
157
|
+
exitWithError(ErrorCode.E305, { details: 'Could not detect GitHub repository. Use --repo org/name' }, options.format);
|
|
158
|
+
}
|
|
159
|
+
const spinner = options.format === 'json' ? null : ora('Checking deployment status...').start();
|
|
160
|
+
try {
|
|
161
|
+
const { stdout } = await exec('gh', [
|
|
162
|
+
'run', 'list',
|
|
163
|
+
'--repo', repo,
|
|
164
|
+
'--limit', '5',
|
|
165
|
+
'--json', 'status,conclusion,name,createdAt,headBranch',
|
|
166
|
+
]);
|
|
167
|
+
const runs = JSON.parse(stdout);
|
|
168
|
+
if (options.format === 'json') {
|
|
169
|
+
out.json({ repo, runs });
|
|
170
|
+
}
|
|
171
|
+
else {
|
|
172
|
+
spinner.succeed(`Recent deployments for ${chalk.cyan(repo)}`);
|
|
173
|
+
for (const run of runs) {
|
|
174
|
+
const icon = run.conclusion === 'success' ? out.symbols.success
|
|
175
|
+
: run.conclusion === 'failure' ? out.symbols.error
|
|
176
|
+
: run.status === 'in_progress' ? chalk.blue('⟳')
|
|
177
|
+
: out.symbols.pending;
|
|
178
|
+
const time = new Date(run.createdAt).toLocaleString();
|
|
179
|
+
out.info(`${icon} ${run.name} — ${chalk.dim(run.headBranch)} — ${chalk.dim(time)}`);
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
catch (err) {
|
|
184
|
+
if (spinner)
|
|
185
|
+
spinner.fail(err instanceof Error ? err.message : String(err));
|
|
186
|
+
process.exit(1);
|
|
187
|
+
}
|
|
188
|
+
});
|
|
189
|
+
// ─── eai deploy env ──────────────────────────────────────────────────────
|
|
190
|
+
const DEPLOY_PROVIDERS = ['vercel', 'docker', 'aws', 'azure', 'kubernetes', 'vm', 'generic'];
|
|
191
|
+
function isDeployProvider(value) {
|
|
192
|
+
return DEPLOY_PROVIDERS.includes(value);
|
|
193
|
+
}
|
|
194
|
+
function providerNotes(provider) {
|
|
195
|
+
switch (provider) {
|
|
196
|
+
case 'vercel':
|
|
197
|
+
return [
|
|
198
|
+
'Add required environment variables and secrets in Project Settings > Environment Variables.',
|
|
199
|
+
'Add the deployed Auth.js callback URL to the Entra app registration.',
|
|
200
|
+
'Run eai deploy doctor --url against preview and production URLs before marking deployment complete.',
|
|
201
|
+
];
|
|
202
|
+
case 'docker':
|
|
203
|
+
return [
|
|
204
|
+
'Put non-secret values in an env file or container environment.',
|
|
205
|
+
'Inject secrets through the runtime or orchestrator secret store, not the image.',
|
|
206
|
+
'Run eai deploy doctor --url against the exposed container URL.',
|
|
207
|
+
];
|
|
208
|
+
case 'aws':
|
|
209
|
+
return [
|
|
210
|
+
'Map required env vars to the app runtime configuration for the selected AWS service.',
|
|
211
|
+
'Store secrets in the provider secret store and inject them at runtime.',
|
|
212
|
+
'Run eai deploy doctor --url against the public load balancer or app URL.',
|
|
213
|
+
];
|
|
214
|
+
case 'azure':
|
|
215
|
+
return [
|
|
216
|
+
'Map required env vars to App Settings or the selected Azure container runtime.',
|
|
217
|
+
'Store secrets in the platform secret store or Key Vault-backed settings.',
|
|
218
|
+
'Run eai deploy doctor --url against the deployed app URL after restart.',
|
|
219
|
+
];
|
|
220
|
+
case 'kubernetes':
|
|
221
|
+
return [
|
|
222
|
+
'Put non-secret values in a ConfigMap and secrets in a Secret.',
|
|
223
|
+
'Mount both into the workload as environment variables.',
|
|
224
|
+
'Run eai deploy doctor --url against the ingress URL after rollout.',
|
|
225
|
+
];
|
|
226
|
+
case 'vm':
|
|
227
|
+
return [
|
|
228
|
+
'Provide env vars and secrets through the process manager or host secret mechanism.',
|
|
229
|
+
'Do not commit runtime secret files to the repo.',
|
|
230
|
+
'Run eai deploy doctor --url against the public or internal app URL.',
|
|
231
|
+
];
|
|
232
|
+
case 'generic':
|
|
233
|
+
return [
|
|
234
|
+
'Translate the runtime contract into your host environment and secret mechanism.',
|
|
235
|
+
'Configure the Auth.js callback URL in the Entra app registration.',
|
|
236
|
+
'Run eai deploy doctor --url after deployment; /health alone is not enough.',
|
|
237
|
+
];
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
function buildDeployEnvPlan(provider, contractPath, validation) {
|
|
241
|
+
return {
|
|
242
|
+
provider,
|
|
243
|
+
contract: contractPath,
|
|
244
|
+
requiredEnv: validation.summary.requiredEnv,
|
|
245
|
+
requiredSecrets: validation.summary.requiredSecrets,
|
|
246
|
+
optionalSecrets: validation.summary.optionalSecrets,
|
|
247
|
+
notes: providerNotes(provider),
|
|
248
|
+
};
|
|
249
|
+
}
|
|
250
|
+
deployCommand
|
|
251
|
+
.command('env')
|
|
252
|
+
.description('Print provider-neutral runtime env and secret requirements')
|
|
253
|
+
.requiredOption('--provider <provider>', `Target provider (${DEPLOY_PROVIDERS.join('|')})`)
|
|
254
|
+
.option('--format <format>', 'Output format (text|json)', 'text')
|
|
255
|
+
.option('--json', 'Output raw JSON (deprecated, use --format json)', false)
|
|
256
|
+
.addHelpText('after', `
|
|
257
|
+
Examples:
|
|
258
|
+
$ eai deploy env --provider generic
|
|
259
|
+
$ eai deploy env --provider vercel --format json
|
|
260
|
+
$ eai deploy env --provider kubernetes
|
|
261
|
+
`)
|
|
262
|
+
.action(async (options) => {
|
|
263
|
+
if (options.json)
|
|
264
|
+
options.format = 'json';
|
|
265
|
+
if (!isDeployProvider(options.provider)) {
|
|
266
|
+
exitWithError(ErrorCode.E305, { details: `Unknown provider ${options.provider}. Use one of ${DEPLOY_PROVIDERS.join(', ')}` }, options.format);
|
|
267
|
+
}
|
|
268
|
+
const validation = await validateRuntimeContract();
|
|
269
|
+
const plan = buildDeployEnvPlan(options.provider, validation.contractPath, validation);
|
|
270
|
+
if (options.format === 'json') {
|
|
271
|
+
out.json({
|
|
272
|
+
provider: plan.provider,
|
|
273
|
+
contract: plan.contract,
|
|
274
|
+
requiredEnv: plan.requiredEnv,
|
|
275
|
+
requiredProtectedEnvNames: plan.requiredSecrets,
|
|
276
|
+
optionalProtectedEnvNames: plan.optionalSecrets,
|
|
277
|
+
notes: plan.notes,
|
|
278
|
+
validationStatus: validation.status,
|
|
279
|
+
validationFindings: validation.findings,
|
|
280
|
+
});
|
|
281
|
+
if (validation.status === 'fail')
|
|
282
|
+
process.exit(1);
|
|
283
|
+
return;
|
|
284
|
+
}
|
|
285
|
+
out.heading(`EAI Deploy Env: ${options.provider}`);
|
|
286
|
+
out.table([
|
|
287
|
+
['Contract', plan.contract],
|
|
288
|
+
['Validation', validation.status === 'pass' ? 'PASS' : 'FAIL'],
|
|
289
|
+
]);
|
|
290
|
+
out.blank();
|
|
291
|
+
out.heading('Required Environment Variables');
|
|
292
|
+
for (const name of plan.requiredEnv) {
|
|
293
|
+
out.info(name);
|
|
294
|
+
}
|
|
295
|
+
out.blank();
|
|
296
|
+
out.heading('Required Secrets');
|
|
297
|
+
for (const name of plan.requiredSecrets) {
|
|
298
|
+
out.info(name);
|
|
299
|
+
}
|
|
300
|
+
if (plan.optionalSecrets.length > 0) {
|
|
301
|
+
out.blank();
|
|
302
|
+
out.heading('Optional Secrets');
|
|
303
|
+
for (const name of plan.optionalSecrets) {
|
|
304
|
+
out.info(name);
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
out.blank();
|
|
308
|
+
out.heading('Provider Notes');
|
|
309
|
+
for (const note of plan.notes) {
|
|
310
|
+
out.info(note);
|
|
311
|
+
}
|
|
312
|
+
if (validation.status === 'fail') {
|
|
313
|
+
out.blank();
|
|
314
|
+
for (const finding of validation.findings) {
|
|
315
|
+
out.error(`${finding.code}: ${finding.message}`);
|
|
316
|
+
if (finding.fix)
|
|
317
|
+
out.info(`Fix: ${finding.fix}`);
|
|
318
|
+
}
|
|
319
|
+
process.exit(1);
|
|
320
|
+
}
|
|
321
|
+
});
|
|
322
|
+
function normalizeBaseUrl(url) {
|
|
323
|
+
const parsed = new URL(url);
|
|
324
|
+
parsed.hash = '';
|
|
325
|
+
parsed.search = '';
|
|
326
|
+
return parsed.toString().replace(/\/$/, '');
|
|
327
|
+
}
|
|
328
|
+
function combineUrl(baseUrl, pathValue) {
|
|
329
|
+
return `${baseUrl}${pathValue.startsWith('/') ? pathValue : `/${pathValue}`}`;
|
|
330
|
+
}
|
|
331
|
+
function coerceDoctorCategory(value, fallback) {
|
|
332
|
+
const allowed = new Set([
|
|
333
|
+
'host/infrastructure',
|
|
334
|
+
'app_not_running',
|
|
335
|
+
'authjs_config',
|
|
336
|
+
'entra_client_redirect_config',
|
|
337
|
+
'eai_publicapi_config',
|
|
338
|
+
'tenant_workflow_config',
|
|
339
|
+
'service_identity_app_only_auth_config',
|
|
340
|
+
'publicapi_authorization',
|
|
341
|
+
'app_code_runtime_error',
|
|
342
|
+
]);
|
|
343
|
+
return value && allowed.has(value) ? value : fallback;
|
|
344
|
+
}
|
|
345
|
+
function classifyStatus(pathValue, httpStatus, fallback) {
|
|
346
|
+
if (httpStatus === 401 || httpStatus === 403)
|
|
347
|
+
return 'publicapi_authorization';
|
|
348
|
+
if (httpStatus === 404 && pathValue.includes('/api/auth'))
|
|
349
|
+
return 'authjs_config';
|
|
350
|
+
if (httpStatus >= 500 && pathValue.includes('/api/eai'))
|
|
351
|
+
return 'app_code_runtime_error';
|
|
352
|
+
if (httpStatus >= 500)
|
|
353
|
+
return 'app_not_running';
|
|
354
|
+
return fallback;
|
|
355
|
+
}
|
|
356
|
+
async function readJsonSafely(response) {
|
|
357
|
+
const text = await response.text();
|
|
358
|
+
if (!text.trim())
|
|
359
|
+
return null;
|
|
360
|
+
try {
|
|
361
|
+
return JSON.parse(text);
|
|
362
|
+
}
|
|
363
|
+
catch {
|
|
364
|
+
return text;
|
|
365
|
+
}
|
|
366
|
+
}
|
|
367
|
+
function hasTenantWorkflowProblem(body) {
|
|
368
|
+
if (!body || typeof body !== 'object' || Array.isArray(body)) {
|
|
369
|
+
return 'Runtime config did not return a JSON object.';
|
|
370
|
+
}
|
|
371
|
+
const tenants = body.tenants;
|
|
372
|
+
if (!tenants || typeof tenants !== 'object' || Array.isArray(tenants)) {
|
|
373
|
+
return 'Runtime config did not include a tenants object.';
|
|
374
|
+
}
|
|
375
|
+
for (const [key, value] of Object.entries(tenants)) {
|
|
376
|
+
if (!value || typeof value !== 'object' || Array.isArray(value)) {
|
|
377
|
+
return `Tenant key ${key} did not return an object.`;
|
|
378
|
+
}
|
|
379
|
+
const tenant = value;
|
|
380
|
+
if (typeof tenant.tenantId !== 'string' || tenant.tenantId.trim() === '') {
|
|
381
|
+
return `Tenant key ${key} is missing tenantId.`;
|
|
382
|
+
}
|
|
383
|
+
if (typeof tenant.workflowId !== 'string' || tenant.workflowId.trim() === '') {
|
|
384
|
+
return `Tenant key ${key} is missing workflowId.`;
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
return null;
|
|
388
|
+
}
|
|
389
|
+
function hasAuthProvidersProblem(body) {
|
|
390
|
+
if (!body || typeof body !== 'object' || Array.isArray(body)) {
|
|
391
|
+
return 'Auth.js providers endpoint did not return a JSON object.';
|
|
392
|
+
}
|
|
393
|
+
if (Object.keys(body).length === 0) {
|
|
394
|
+
return 'Auth.js providers endpoint returned no providers.';
|
|
395
|
+
}
|
|
396
|
+
return null;
|
|
397
|
+
}
|
|
398
|
+
async function runDoctorCheck(baseUrl, test, fallbackCategory) {
|
|
399
|
+
const url = combineUrl(baseUrl, test.path);
|
|
400
|
+
const expected = expectedStatuses(test);
|
|
401
|
+
const category = coerceDoctorCategory(test.category, fallbackCategory);
|
|
402
|
+
try {
|
|
403
|
+
const response = await fetch(url, {
|
|
404
|
+
method: test.method,
|
|
405
|
+
signal: AbortSignal.timeout(10_000),
|
|
406
|
+
});
|
|
407
|
+
const body = await readJsonSafely(response);
|
|
408
|
+
if (!expected.includes(response.status)) {
|
|
409
|
+
const failureCategory = classifyStatus(test.path, response.status, category);
|
|
410
|
+
const optionalStatus = test.optional ? 'warning' : 'fail';
|
|
411
|
+
return {
|
|
412
|
+
name: test.name,
|
|
413
|
+
method: test.method,
|
|
414
|
+
path: test.path,
|
|
415
|
+
url,
|
|
416
|
+
category: failureCategory,
|
|
417
|
+
status: optionalStatus,
|
|
418
|
+
httpStatus: response.status,
|
|
419
|
+
message: `Expected HTTP ${expected.join(' or ')}, received ${response.status}.`,
|
|
420
|
+
fix: 'Check the deployed app logs and the runtime contract for this endpoint.',
|
|
421
|
+
};
|
|
422
|
+
}
|
|
423
|
+
if (test.path.includes('/api/eai/config')) {
|
|
424
|
+
const problem = hasTenantWorkflowProblem(body);
|
|
425
|
+
if (problem) {
|
|
426
|
+
return {
|
|
427
|
+
name: test.name,
|
|
428
|
+
method: test.method,
|
|
429
|
+
path: test.path,
|
|
430
|
+
url,
|
|
431
|
+
category: 'tenant_workflow_config',
|
|
432
|
+
status: test.optional ? 'warning' : 'fail',
|
|
433
|
+
httpStatus: response.status,
|
|
434
|
+
message: problem,
|
|
435
|
+
fix: 'Set TENANT_KEYS plus TENANT_{KEY}_ID and WORKFLOW_{KEY}_ID for the deployed app.',
|
|
436
|
+
};
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
if (test.path.includes('/api/auth/providers')) {
|
|
440
|
+
const problem = hasAuthProvidersProblem(body);
|
|
441
|
+
if (problem) {
|
|
442
|
+
return {
|
|
443
|
+
name: test.name,
|
|
444
|
+
method: test.method,
|
|
445
|
+
path: test.path,
|
|
446
|
+
url,
|
|
447
|
+
category: 'authjs_config',
|
|
448
|
+
status: test.optional ? 'warning' : 'fail',
|
|
449
|
+
httpStatus: response.status,
|
|
450
|
+
message: problem,
|
|
451
|
+
fix: 'Check AUTH_SECRET, AUTH_URL, Entra client settings, and callback URL registration.',
|
|
452
|
+
};
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
return {
|
|
456
|
+
name: test.name,
|
|
457
|
+
method: test.method,
|
|
458
|
+
path: test.path,
|
|
459
|
+
url,
|
|
460
|
+
category,
|
|
461
|
+
status: 'pass',
|
|
462
|
+
httpStatus: response.status,
|
|
463
|
+
message: `HTTP ${response.status}`,
|
|
464
|
+
};
|
|
465
|
+
}
|
|
466
|
+
catch (error) {
|
|
467
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
468
|
+
return {
|
|
469
|
+
name: test.name,
|
|
470
|
+
method: test.method,
|
|
471
|
+
path: test.path,
|
|
472
|
+
url,
|
|
473
|
+
category: test.path === '/health' ? 'app_not_running' : 'host/infrastructure',
|
|
474
|
+
status: test.optional ? 'warning' : 'fail',
|
|
475
|
+
message,
|
|
476
|
+
fix: 'Confirm the deployed URL is reachable from this machine and the app process is running.',
|
|
477
|
+
};
|
|
478
|
+
}
|
|
479
|
+
}
|
|
480
|
+
function dedupeSmokeTests(tests) {
|
|
481
|
+
const seen = new Set();
|
|
482
|
+
const unique = [];
|
|
483
|
+
for (const test of tests) {
|
|
484
|
+
const key = `${test.method}:${test.path}`;
|
|
485
|
+
if (!seen.has(key)) {
|
|
486
|
+
seen.add(key);
|
|
487
|
+
unique.push(test);
|
|
488
|
+
}
|
|
489
|
+
}
|
|
490
|
+
return unique;
|
|
491
|
+
}
|
|
492
|
+
export async function runDeployDoctor(url) {
|
|
493
|
+
const baseUrl = normalizeBaseUrl(url);
|
|
494
|
+
const validation = await validateRuntimeContract();
|
|
495
|
+
const loaded = await loadRuntimeContract(validation.projectRoot);
|
|
496
|
+
const checks = [];
|
|
497
|
+
if (validation.status === 'fail') {
|
|
498
|
+
for (const finding of validation.findings) {
|
|
499
|
+
checks.push({
|
|
500
|
+
name: finding.code,
|
|
501
|
+
method: 'LOCAL',
|
|
502
|
+
path: RUNTIME_CONTRACT_FILE,
|
|
503
|
+
url: validation.contractPath,
|
|
504
|
+
category: 'eai_publicapi_config',
|
|
505
|
+
status: 'fail',
|
|
506
|
+
message: finding.message,
|
|
507
|
+
fix: finding.fix,
|
|
508
|
+
});
|
|
509
|
+
}
|
|
510
|
+
}
|
|
511
|
+
const contract = loaded.contract;
|
|
512
|
+
const tests = dedupeSmokeTests([
|
|
513
|
+
{
|
|
514
|
+
name: 'health',
|
|
515
|
+
method: 'GET',
|
|
516
|
+
path: contract.endpoints.health || '/health',
|
|
517
|
+
expectedStatus: 200,
|
|
518
|
+
category: 'app_not_running',
|
|
519
|
+
},
|
|
520
|
+
{
|
|
521
|
+
name: 'auth-providers',
|
|
522
|
+
method: 'GET',
|
|
523
|
+
path: contract.endpoints.authProviders || '/api/auth/providers',
|
|
524
|
+
expectedStatus: 200,
|
|
525
|
+
category: 'authjs_config',
|
|
526
|
+
},
|
|
527
|
+
{
|
|
528
|
+
name: 'runtime-config',
|
|
529
|
+
method: 'GET',
|
|
530
|
+
path: contract.endpoints.runtimeConfig || '/api/eai/config',
|
|
531
|
+
expectedStatus: 200,
|
|
532
|
+
category: 'tenant_workflow_config',
|
|
533
|
+
},
|
|
534
|
+
...contract.endpoints.public.map((endpoint, index) => ({
|
|
535
|
+
name: `public-${index + 1}`,
|
|
536
|
+
method: endpoint.method || 'GET',
|
|
537
|
+
path: endpoint.path || '/',
|
|
538
|
+
expectedStatus: 200,
|
|
539
|
+
category: endpoint.serverSidePlatformAccess
|
|
540
|
+
? 'service_identity_app_only_auth_config'
|
|
541
|
+
: 'app_code_runtime_error',
|
|
542
|
+
})),
|
|
543
|
+
...contract.endpoints.smokeTests,
|
|
544
|
+
]);
|
|
545
|
+
for (const test of tests) {
|
|
546
|
+
checks.push(await runDoctorCheck(baseUrl, test, 'app_code_runtime_error'));
|
|
547
|
+
}
|
|
548
|
+
const hasBffSmoke = tests.some((test) => contract.endpoints.bffBasePath &&
|
|
549
|
+
test.path.startsWith(contract.endpoints.bffBasePath) &&
|
|
550
|
+
test.path !== contract.endpoints.runtimeConfig);
|
|
551
|
+
if (!hasBffSmoke) {
|
|
552
|
+
checks.push({
|
|
553
|
+
name: 'publicapi-bff-smoke-declared',
|
|
554
|
+
method: 'CONTRACT',
|
|
555
|
+
path: contract.endpoints.bffBasePath || '/api/eai',
|
|
556
|
+
url: contract.endpoints.bffBasePath || '/api/eai',
|
|
557
|
+
category: 'eai_publicapi_config',
|
|
558
|
+
status: 'warning',
|
|
559
|
+
message: 'No deployed BFF/PublicAPI smoke endpoint is declared; doctor cannot prove PublicAPI reachability through the app.',
|
|
560
|
+
fix: 'Add a safe read-only smoke endpoint to endpoints.smokeTests when the app exposes one.',
|
|
561
|
+
});
|
|
562
|
+
}
|
|
563
|
+
const summary = {
|
|
564
|
+
pass: checks.filter((check) => check.status === 'pass').length,
|
|
565
|
+
fail: checks.filter((check) => check.status === 'fail').length,
|
|
566
|
+
warning: checks.filter((check) => check.status === 'warning').length,
|
|
567
|
+
skip: checks.filter((check) => check.status === 'skip').length,
|
|
568
|
+
};
|
|
569
|
+
return {
|
|
570
|
+
url: baseUrl,
|
|
571
|
+
contract: loaded.contractPath,
|
|
572
|
+
status: summary.fail > 0 ? 'fail' : 'pass',
|
|
573
|
+
checks,
|
|
574
|
+
summary,
|
|
575
|
+
};
|
|
576
|
+
}
|
|
577
|
+
deployCommand
|
|
578
|
+
.command('doctor')
|
|
579
|
+
.description('Black-box check a deployed EAI app runtime')
|
|
580
|
+
.requiredOption('--url <url>', 'Deployed app base URL')
|
|
581
|
+
.option('--format <format>', 'Output format (text|json)', 'text')
|
|
582
|
+
.option('--json', 'Output raw JSON (deprecated, use --format json)', false)
|
|
583
|
+
.addHelpText('after', `
|
|
584
|
+
Examples:
|
|
585
|
+
$ eai deploy doctor --url https://my-app.example.com
|
|
586
|
+
$ eai deploy doctor --url https://my-app.example.com --format json
|
|
587
|
+
`)
|
|
588
|
+
.action(async (options) => {
|
|
589
|
+
if (options.json)
|
|
590
|
+
options.format = 'json';
|
|
591
|
+
let result;
|
|
592
|
+
try {
|
|
593
|
+
result = await runDeployDoctor(options.url);
|
|
594
|
+
}
|
|
595
|
+
catch (error) {
|
|
596
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
597
|
+
if (options.format === 'json') {
|
|
598
|
+
out.json({ status: 'fail', error: message });
|
|
599
|
+
}
|
|
600
|
+
else {
|
|
601
|
+
out.error(message);
|
|
602
|
+
}
|
|
603
|
+
process.exit(1);
|
|
604
|
+
return;
|
|
605
|
+
}
|
|
606
|
+
if (options.format === 'json') {
|
|
607
|
+
out.json(result);
|
|
608
|
+
if (result.status === 'fail')
|
|
609
|
+
process.exit(1);
|
|
610
|
+
return;
|
|
611
|
+
}
|
|
612
|
+
out.heading('EAI Deploy Doctor');
|
|
613
|
+
out.table([
|
|
614
|
+
['URL', result.url],
|
|
615
|
+
['Contract', result.contract],
|
|
616
|
+
['Status', result.status === 'pass' ? 'PASS' : 'FAIL'],
|
|
617
|
+
['Passed', String(result.summary.pass)],
|
|
618
|
+
['Failed', String(result.summary.fail)],
|
|
619
|
+
['Warnings', String(result.summary.warning)],
|
|
620
|
+
]);
|
|
621
|
+
out.blank();
|
|
622
|
+
for (const check of result.checks) {
|
|
623
|
+
const icon = check.status === 'pass'
|
|
624
|
+
? out.symbols.success
|
|
625
|
+
: check.status === 'warning'
|
|
626
|
+
? out.symbols.warning
|
|
627
|
+
: out.symbols.error;
|
|
628
|
+
console.log(`${icon} ${check.name} [${check.category}] ${check.method} ${check.path}: ${check.message}`);
|
|
629
|
+
if (check.fix && check.status !== 'pass')
|
|
630
|
+
out.info(`Fix: ${check.fix}`);
|
|
631
|
+
}
|
|
632
|
+
out.blank();
|
|
633
|
+
if (result.status === 'pass') {
|
|
634
|
+
out.success('Deployment runtime checks passed.');
|
|
635
|
+
}
|
|
636
|
+
else {
|
|
637
|
+
out.error('Deployment runtime checks failed.');
|
|
638
|
+
process.exit(1);
|
|
639
|
+
}
|
|
640
|
+
});
|
|
641
|
+
function generateWorkflow(appName) {
|
|
642
|
+
return `name: Deploy ${appName}
|
|
643
|
+
|
|
644
|
+
on:
|
|
645
|
+
push:
|
|
646
|
+
branches: [main]
|
|
647
|
+
workflow_dispatch:
|
|
648
|
+
|
|
649
|
+
env:
|
|
650
|
+
APP_NAME: ${appName}
|
|
651
|
+
NODE_VERSION: '20.x'
|
|
652
|
+
|
|
653
|
+
jobs:
|
|
654
|
+
build-and-deploy:
|
|
655
|
+
runs-on: ubuntu-latest
|
|
656
|
+
environment: demo
|
|
657
|
+
permissions:
|
|
658
|
+
id-token: write
|
|
659
|
+
contents: read
|
|
660
|
+
|
|
661
|
+
steps:
|
|
662
|
+
- uses: actions/checkout@v4
|
|
663
|
+
|
|
664
|
+
- name: Set up Node.js
|
|
665
|
+
uses: actions/setup-node@v4
|
|
666
|
+
with:
|
|
667
|
+
node-version: \${{ env.NODE_VERSION }}
|
|
668
|
+
cache: 'npm'
|
|
669
|
+
|
|
670
|
+
- name: Install dependencies
|
|
671
|
+
run: npm ci
|
|
672
|
+
|
|
673
|
+
- name: Build Object Types JSON
|
|
674
|
+
run: npm run build:object-types
|
|
675
|
+
|
|
676
|
+
- name: Build
|
|
677
|
+
run: npm run build
|
|
678
|
+
env:
|
|
679
|
+
APP_BASE_PATH: /\${{ env.APP_NAME }}
|
|
680
|
+
|
|
681
|
+
- name: Package standalone output
|
|
682
|
+
run: |
|
|
683
|
+
mkdir -p deploy/\${{ env.APP_NAME }}
|
|
684
|
+
cp -r .next/standalone/. deploy/\${{ env.APP_NAME }}/
|
|
685
|
+
cp -r .next/static deploy/\${{ env.APP_NAME }}/.next/
|
|
686
|
+
cp -r public deploy/\${{ env.APP_NAME }}/ 2>/dev/null || true
|
|
687
|
+
cd deploy && zip -r ../app-content.zip \${{ env.APP_NAME }}
|
|
688
|
+
|
|
689
|
+
- name: Azure Login
|
|
690
|
+
uses: azure/login@v2
|
|
691
|
+
with:
|
|
692
|
+
client-id: \${{ secrets.AZUREAPPSERVICE_CLIENTID }}
|
|
693
|
+
tenant-id: \${{ secrets.AZUREAPPSERVICE_TENANTID }}
|
|
694
|
+
subscription-id: \${{ secrets.AZUREAPPSERVICE_SUBSCRIPTIONID }}
|
|
695
|
+
|
|
696
|
+
- name: Deploy to Azure
|
|
697
|
+
run: |
|
|
698
|
+
az webapp deploy \\
|
|
699
|
+
--resource-group \${{ secrets.AZURE_RESOURCE_GROUP }} \\
|
|
700
|
+
--name \${{ secrets.AZURE_WEBAPP_NAME }} \\
|
|
701
|
+
--src-path app-content.zip \\
|
|
702
|
+
--type zip \\
|
|
703
|
+
--target-path /home/site/wwwroot/\${{ env.APP_NAME }}
|
|
704
|
+
|
|
705
|
+
- name: Restart App Service
|
|
706
|
+
run: |
|
|
707
|
+
az webapp restart \\
|
|
708
|
+
--resource-group \${{ secrets.AZURE_RESOURCE_GROUP }} \\
|
|
709
|
+
--name \${{ secrets.AZURE_WEBAPP_NAME }}
|
|
710
|
+
`;
|
|
711
|
+
}
|
|
712
|
+
//# sourceMappingURL=deploy.js.map
|