52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# TASK METADATA
|
|
|
|
- **Target Files:** `infra/setup/cli.ts`, `infra/setup/prompts/*.ts`,
|
|
`infra/setup/commands/*.ts`
|
|
- **Core Objective:** Phase 4.1 (CLI Setup Modularization): Decompose the
|
|
772-line `infra/setup/cli.ts` monolith into isolated prompt flows and Cliffy
|
|
command modules under `infra/setup/prompts/` and `infra/setup/commands/`.
|
|
- **Dependencies:**
|
|
`tasks/complete/2026-0825.01.jul.story.arch.monolith-decomposition-roadmap-1845.ph4.md`
|
|
- **Additional Important Notes:** Must reduce `infra/setup/cli.ts` to a clean
|
|
~60-line router, pass `deno check infra/setup.ts`, and preserve all CLI
|
|
subcommands (`auth`, `test`, `build`, `compile_proto`, `dump_compose`,
|
|
`spire`, `secrets`, `wizard`).
|
|
|
|
---
|
|
|
|
### 2. Architectural Considerations & Risks
|
|
|
|
- **Risks:**
|
|
- Breaking CLI argument parsing or flag inheritance in Cliffy commands if
|
|
command action handlers are miswired.
|
|
- **Alternatives:**
|
|
- Leaving 772 lines in `cli.ts`; rejected because it violates the Single
|
|
Responsibility Principle and combines UI prompts, network testers, and
|
|
command routing into one file.
|
|
|
|
### 3. Proposed Implementation
|
|
|
|
1. **Extract Interactive Prompts (`infra/setup/prompts/`):**
|
|
- `infra/setup/prompts/auth.ts`: `promptAuthConfig`, `promptSpireConfig`,
|
|
`promptConfirmation`.
|
|
- `infra/setup/prompts/wizard.ts`: `runSetupWizard`, `handleReviewConfigs`.
|
|
|
|
2. **Extract CLI Subcommands (`infra/setup/commands/`):**
|
|
- `infra/setup/commands/auth.ts`: `auth` command action & setup file
|
|
generator.
|
|
- `infra/setup/commands/test.ts`: `test` connection action
|
|
(`handleTestConnection`).
|
|
- `infra/setup/commands/build.ts`: `build` and `compile_proto` command
|
|
actions.
|
|
- `infra/setup/commands/compose.ts`: `dump_compose` and `spire` command
|
|
actions.
|
|
- `infra/setup/commands/secrets.ts`: `secrets` command action.
|
|
|
|
3. **Refactor `infra/setup/cli.ts`:**
|
|
- Keep `cli.ts` purely as the lightweight Cliffy Command router (~60-80
|
|
lines) registering the command modules and executing `runCli(args)`.
|
|
|
|
4. **Quality Gates & Validation:**
|
|
- Run `deno check infra/setup.ts`.
|
|
- Run `deno fmt infra/` and `deno test --allow-all`.
|