Clarify Stage 2 target config docs node

Author: anth-volk

docs/engineering/pipeline-map.md

@@ -384,7 +384,7 @@ Build sparse calibration matrix (targets x households x clones)
 | `util_takeup_s5` compute_block_takeup_for_entities() | `utility` | `unknown` | `unknown` |  |
 | `util_scipy` scipy.sparse | `utility` | `unknown` | `unknown` |  |
 | `stage2_target_config_identity` Stage 2 Target Config Identity | `library` | `current` | `moving` | `policyengine_us_data.calibration_package.specs.resolve_target_config_identity` |
-| `stage2_target_catalog_load` Load Stage 2 Target Config | `library` | `current` | `moving` | `policyengine_us_data.calibration.unified_calibration.load_target_config` |
+| `stage2_target_config_load` Load Stage 2 Target Config | `library` | `current` | `moving` | `policyengine_us_data.calibration.unified_calibration.load_target_config` |
 | `stage2_target_config_apply` Apply Stage 2 Target Config | `library` | `current` | `moving` | `policyengine_us_data.calibration.unified_calibration.apply_target_config_to_targets` |
 | `state_precomp` Per-State Simulation Precomputation | `library` | `current` | `moving` | `policyengine_us_data.calibration.unified_matrix_builder._compute_single_state` |
 | `clone_assembly` Clone Value Assembly | `library` | `current` | `moving` | `policyengine_us_data.calibration.unified_matrix_builder._assemble_clone_values_standalone` |
@@ -400,8 +400,8 @@ Build sparse calibration matrix (targets x households x clones)
 - `in_cps_s5` -> `target_resolve` `data_flow`
 - `in_db_s5` -> `target_resolve` `external_source` (SQL targets)
 - `in_config_s5` -> `stage2_target_config_identity` `data_flow` (config file)
-- `stage2_target_config_identity` -> `stage2_target_catalog_load` `data_flow` (resolved path and checksum)
-- `stage2_target_catalog_load` -> `stage2_target_config_apply` `data_flow` (include/exclude rules)
+- `stage2_target_config_identity` -> `stage2_target_config_load` `data_flow` (resolved path and checksum)
+- `stage2_target_config_load` -> `stage2_target_config_apply` `data_flow` (include/exclude rules)
 - `target_resolve` -> `stage2_target_config_apply` `data_flow` (candidate targets)
 - `stage2_target_config_apply` -> `target_uprate` `data_flow` (selected targets)
 - `target_uprate` -> `geo_build` `data_flow`

docs/generated/pipeline_api.json

@@ -3788,34 +3788,6 @@
     "signature": "def save_calibration_package(path: str, X_sparse, targets_df: 'pd.DataFrame', target_names: list, metadata: dict, initial_weights: np.ndarray = None, cd_geoid: np.ndarray = None, block_geoid: np.ndarray = None) -> None",
     "source_file": "policyengine_us_data/calibration/unified_calibration.py"
   },
-  "stage2_target_catalog_load": {
-    "docstring": "Load target include/exclude config from YAML.\n\nArgs:\n    path: Path to YAML config file.\n\nReturns:\n    Parsed config dict with include and exclude lists.",
-    "id": "stage2_target_catalog_load",
-    "kind": "function",
-    "line": 522,
-    "metadata": {
-      "api_refs": [
-        "policyengine_us_data.calibration.unified_calibration.load_target_config"
-      ],
-      "artifacts_in": "[DEFAULT_TARGET_CONFIG_RELATIVE_PATH]",
-      "description": "Load the include/exclude target-selection catalog used by Stage 2 package construction.",
-      "id": "stage2_target_catalog_load",
-      "label": "Load Stage 2 Target Config",
-      "node_type": "library",
-      "pathways": [
-        "calibration_package"
-      ],
-      "source_file": "policyengine_us_data/calibration/unified_calibration.py",
-      "stability": "moving",
-      "status": "current",
-      "validation_commands": [
-        "uv run pytest tests/unit/calibration/test_target_config.py"
-      ]
-    },
-    "object_path": "policyengine_us_data.calibration.unified_calibration.load_target_config",
-    "signature": "def load_target_config(path: str) -> dict",
-    "source_file": "policyengine_us_data/calibration/unified_calibration.py"
-  },
   "stage2_target_config_apply": {
     "docstring": "Filter target rows before matrix construction.",
     "id": "stage2_target_config_apply",
@@ -3871,6 +3843,34 @@
     "signature": "def resolve_target_config_identity(target_config_path: str | Path | None = None, *, all_active_targets: bool = False, repo_root: str | Path | None = None) -> TargetConfigIdentity",
     "source_file": "policyengine_us_data/calibration_package/specs.py"
   },
+  "stage2_target_config_load": {
+    "docstring": "Load target include/exclude config from YAML.\n\nArgs:\n    path: Path to YAML config file.\n\nReturns:\n    Parsed config dict with include and exclude lists.",
+    "id": "stage2_target_config_load",
+    "kind": "function",
+    "line": 522,
+    "metadata": {
+      "api_refs": [
+        "policyengine_us_data.calibration.unified_calibration.load_target_config"
+      ],
+      "artifacts_in": "[DEFAULT_TARGET_CONFIG_RELATIVE_PATH]",
+      "description": "Load the YAML include/exclude target-selection config used by Stage 2 package construction.",
+      "id": "stage2_target_config_load",
+      "label": "Load Stage 2 Target Config",
+      "node_type": "library",
+      "pathways": [
+        "calibration_package"
+      ],
+      "source_file": "policyengine_us_data/calibration/unified_calibration.py",
+      "stability": "moving",
+      "status": "current",
+      "validation_commands": [
+        "uv run pytest tests/unit/calibration/test_target_config.py"
+      ]
+    },
+    "object_path": "policyengine_us_data.calibration.unified_calibration.load_target_config",
+    "signature": "def load_target_config(path: str) -> dict",
+    "source_file": "policyengine_us_data/calibration/unified_calibration.py"
+  },
   "stage4_release_candidate_bundle_builder": {
     "docstring": "Build a candidate bundle from a Stage 4 output contract shape.",
     "id": "stage4_release_candidate_bundle_builder",

docs/generated/pipeline_map.json

@@ -3781,12 +3781,12 @@
           "edge_type": "data_flow",
           "label": "resolved path and checksum",
           "source": "stage2_target_config_identity",
-          "target": "stage2_target_catalog_load"
+          "target": "stage2_target_config_load"
         },
         {
           "edge_type": "data_flow",
           "label": "include/exclude rules",
-          "source": "stage2_target_catalog_load",
+          "source": "stage2_target_config_load",
           "target": "stage2_target_config_apply"
         },
         {
@@ -3940,7 +3940,7 @@
           "label": "run_calibration()",
           "node_ids": [
             "stage2_target_config_identity",
-            "stage2_target_catalog_load",
+            "stage2_target_config_load",
             "target_resolve",
             "stage2_target_config_apply",
             "target_uprate",
@@ -4088,8 +4088,8 @@
             "policyengine_us_data.calibration.unified_calibration.load_target_config"
           ],
           "artifacts_in": "[DEFAULT_TARGET_CONFIG_RELATIVE_PATH]",
-          "description": "Load the include/exclude target-selection catalog used by Stage 2 package construction.",
-          "id": "stage2_target_catalog_load",
+          "description": "Load the YAML include/exclude target-selection config used by Stage 2 package construction.",
+          "id": "stage2_target_config_load",
           "label": "Load Stage 2 Target Config",
           "node_type": "library",
           "pathways": [

docs/pipeline_map.yaml

@@ -806,7 +806,7 @@ stages:
     description: 'Build phase: resolve targets and constraints, assemble clone values, and package the sparse calibration matrix'
     node_ids:
     - stage2_target_config_identity
-    - stage2_target_catalog_load
+    - stage2_target_config_load
     - target_resolve
     - stage2_target_config_apply
     - target_uprate
@@ -902,10 +902,10 @@ stages:
     edge_type: data_flow
     label: config file
   - source: stage2_target_config_identity
-    target: stage2_target_catalog_load
+    target: stage2_target_config_load
     edge_type: data_flow
     label: resolved path and checksum
-  - source: stage2_target_catalog_load
+  - source: stage2_target_config_load
     target: stage2_target_config_apply
     edge_type: data_flow
     label: include/exclude rules

policyengine_us_data/calibration/unified_calibration.py

@@ -505,10 +505,10 @@ def parse_args(argv=None):
 
 @pipeline_node(
     PipelineNode(
-        id="stage2_target_catalog_load",
+        id="stage2_target_config_load",
         label="Load Stage 2 Target Config",
         node_type="library",
-        description="Load the include/exclude target-selection catalog used by Stage 2 package construction.",
+        description="Load the YAML include/exclude target-selection config used by Stage 2 package construction.",
         source_file="policyengine_us_data/calibration/unified_calibration.py",
         status="current",
         stability="moving",

tests/unit/test_pipeline_docs_extractor.py

@@ -131,7 +131,7 @@ def test_pipeline_map_manifest_validates():
     stage2_node_ids = {node["id"] for node in stage2["nodes"]}
     assert {
         "stage2_target_config_identity",
-        "stage2_target_catalog_load",
+        "stage2_target_config_load",
         "build_matrix",
         "build_matrix_chunked",
         "stage2_calibration_package_writer",