COA Add Warehouse Sources (scaffold source nodes)
coa_add_warehouse_sourcesScaffold source-node YAML files from warehouse tables, reading database and schema from workspace config. Supports dry-run preview to list changes without writing.
Instructions
Scaffold source-node YAML files from warehouse tables. Wraps coa sources add --json. Database and schema are read from the workspace's storage-location config and copied onto each scaffolded source node — no separate placeholders to fix up afterward, but verify the workspace config itself is correct first (the bootstrap tool seeds placeholders into it).
DESTRUCTIVE: writes files into the project's nodes/ tree. Requires confirmed: true. Existing source nodes are skipped unless overwrite: true.
MUST pass exactly one of location or all (the CLI enforces this in non-TTY mode and so do we).
DRY-RUN: pass dryRun: true to list what would be imported without writing files. The JSON shape is the same as a real write, with wouldImport reflecting the delta. confirmed: true is still required for consistency, but no files are created.
Profile resolution: input profile > COALESCE_PROFILE env > [default].
Usage pattern: call coa_list_warehouse_sources --location <name> first to preview, then call this with the same scope.
Args:
projectPath (string, required)
location (string) OR all (boolean): exactly one required
include (string, optional): glob filter
overwrite (boolean, optional): re-import existing nodes
dryRun (boolean, optional): preview without writing
profile (string, optional)
confirmed (boolean): must be true to execute. Required even when
dryRun: true, for consistency with other destructive tools — no files are written in that case.
Returns: { command, exitCode, stdout, stderr, json?, coaVersion }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||