COA Bootstrap workspaces.yml (doctor --fix)
coa_bootstrap_workspacesGenerates a starter workspaces.yml for a Coalesce project from locations.yml. Confirmation needed before file is written.
Instructions
Run coa doctor --fix — writes a starter workspaces.yml in the project root, seeded from locations.yml. Safe to re-run; coa will not overwrite a valid existing file.
IMPORTANT: the generated file contains placeholder database/schema values. The user MUST open it and set real values before running coa_create / coa_run — otherwise warehouse operations will target non-existent databases.
KNOWN ISSUE (CD-16983): the workspaces.yml profile controls coa create/run, but coa plan/deploy/refresh fall through to [default] in ~/.coa/config. After bootstrap, check that the two profiles point at the same cloud account before relying on plan/deploy results.
DESTRUCTIVE: writes a new file to the project directory. Requires confirmed=true after explicit user approval.
Args:
projectPath (string, required): Path to the COA project root (directory with data.yml)
workspace (string, optional): workspaces.yml workspace name (default: dev)
confirmed (boolean): must be true to execute
Returns: { command, exitCode, stdout, stderr, json?, coaVersion }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirmed | No | Set to true after the user explicitly confirms. Without this, the tool returns a STOP_AND_CONFIRM response instead of executing. | |
| workspace | No | COA workspace name from workspaces.yml. Defaults to 'dev'. | |
| projectPath | Yes | Absolute or relative path to the COA project root (the directory containing data.yml). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| json | No | ||
| stderr | Yes | ||
| stdout | Yes | ||
| command | Yes | ||
| exitCode | Yes | ||
| timedOut | Yes | ||
| coaVersion | Yes | ||
| jsonParseError | No | ||
| preflightWarnings | No |