Merge pull request #5 from sabino/feat/m1-jaffle-parse

Add seed ref parsing

Author: sabino

.agent/research/m1-seed-ref-slice.md

@@ -0,0 +1,25 @@
+# M1 Seed Ref Slice
+
+## Scope
+
+This slice adds read compatibility for CSV seeds in the native Zig parser. It is parser/artifact-only and does not execute or load seed data.
+
+Implemented surface:
+
+- `seed-paths` from `dbt_project.yml`, defaulting to `seeds`.
+- Recursive `.csv` seed discovery under configured seed paths.
+- Seed nodes with `seed.<package>.<name>` unique IDs.
+- Duplicate seed-name diagnostics for basename collisions across recursive seed paths.
+- Literal `ref()` resolution to active models first, then active seeds.
+- Seed entries in manifest `nodes`, `parent_map`, `child_map`, and `dxt ls`.
+- `dxt ls --resource-type seed`.
+
+## Compatibility Notes
+
+The slice exists to unblock public Jaffle Shop DuckDB parse read-compatibility, where staging models reference CSV seeds such as `raw_customers`, `raw_orders`, and `raw_payments`.
+
+Seed execution, CSV type inference, catalog generation, and full dbt seed artifact fidelity remain later work. The partial manifest intentionally records only the fields needed by the current M1 graph and selector surface.
+
+## Validation
+
+Synthetic fixtures cover deterministic seed discovery, seed-aware `ref()` dependency resolution, parent/child maps, seed listing, and duplicate seed-name diagnostics. The public Jaffle Shop DuckDB clone is used as a non-committed manual gate and parses into a partial manifest with five model nodes and three seed nodes.

PLAN.md

@@ -514,7 +514,7 @@ Exit criteria:
 
 - M0 is under PR review as the Zig `0.16.0` runtime scaffold.
 - M1 has started on stacked branches with native Zig artifact-first parser slices.
-- `dxt parse` now targets the supported Tier 0 subset: project name/model paths, SQL model discovery, literal `ref`, literal `source`, inline `config(materialized=..., tags=...)`, narrow YAML model properties for scalar descriptions, simple columns, tags, materialization, disabled SQL models, dependency maps, and deterministic partial `manifest.json`. Generic tests are parsed for later graph work but are not yet emitted as dbt-shaped `test.*` nodes.
+- `dxt parse` now targets the supported Tier 0 subset: project name/model paths/seed paths, SQL model discovery, CSV seed discovery, literal `ref` to models or seeds, literal `source`, inline `config(materialized=..., tags=...)`, narrow YAML model properties for scalar descriptions, simple columns, tags, materialization, disabled SQL models, dependency maps, and deterministic partial `manifest.json`. Generic tests are parsed for later graph work but are not yet emitted as dbt-shaped `test.*` nodes.
 - `dxt ls` now lists resources from the same parser graph with stable text/JSON output and basic name, tag, path, resource type, and exact exclude filters.
-- Synthetic fixtures cover one model, model refs, source refs, combined source/model YAML, inline config/tag selection, YAML model properties and columns, disabled models, disabled ref diagnostics, unmatched model-property warnings, duplicate model diagnostics, unsupported dynamic ref diagnostics, and unsupported macro-call diagnostics.
-- The next M1 slices should add published schema validation, docs blocks, macros, stronger selector parity, and Jaffle Shop DuckDB parse exploration.
+- Synthetic fixtures cover one model, model refs, seed refs, source refs, combined source/model YAML, inline config/tag selection, YAML model properties and columns, disabled models, disabled ref diagnostics, unmatched model-property warnings, duplicate model diagnostics, unsupported dynamic ref diagnostics, and unsupported macro-call diagnostics.
+- The current M1 manual gate parses the public Jaffle Shop DuckDB project into a partial manifest with SQL models and CSV seeds. The next M1 slices should add published schema validation, docs blocks, macros, generic test nodes, stronger selector parity, and deeper Jaffle artifact parity.

README.md

@@ -35,7 +35,7 @@ Implemented pre-alpha commands:
 ./zig-out/bin/dxt ls --project-dir tests/fixtures/model_ref --output json
 ```
 
-`parse` and `ls` currently support only the documented M1 parser subset: `dbt_project.yml` name/model paths/target path, SQL model discovery, literal `ref`, literal `source`, basic inline `config`, narrow YAML model properties for scalar descriptions, simple columns, tags, materialization and disabled SQL models, deterministic partial `manifest.json`, and simple name/tag/path/resource filters. dbt-shaped generic test nodes, `compile`, `build`, and `docs generate` remain planned placeholders.
+`parse` and `ls` currently support only the documented M1 parser subset: `dbt_project.yml` name/model paths/seed paths/target path, SQL model discovery, CSV seed discovery, literal `ref` to models or seeds, literal `source`, basic inline `config`, narrow YAML model properties for scalar descriptions, simple columns, tags, materialization and disabled SQL models, deterministic partial `manifest.json`, and simple name/tag/path/resource filters. dbt-shaped generic test nodes, `compile`, `build`, and `docs generate` remain planned placeholders.
 
 ## Development