feat(ingest): conda-forge and Spack recipes to EasyBuild scaffolds

Add foreign recipe parsers (plain meta.yaml; restricted package.py) and
eb-stack ingest CLI that emit parseable .eb files with input-derived
name/version/source/deps and residual warnings. Frozen zlib fixtures and
library+CLI integration tests drive the shipped path.

Author: HaoZeke

CHANGELOG.md

@@ -7,14 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-07-13
+
 ### Added
 
-- GitHub Actions CI for unit tests, known-bump regression, packaging fixtures,
-  solve/stack-diff, and CLI smoke.
-- Operator guide for the annual toolchain-generation bump
-  (`docs/orgmode/howto/run-annual-bump.org`).
-- CLI auto-bump regression tests for frozen maintainer pairs under
-  `tests/repro_fixtures/`.
+- `eb-stack ingest`: convert conda-forge (`meta.yaml` / `recipe.yaml`) and
+  Spack (`package.py`, restricted parse) recipes into parseable EasyBuild
+  scaffolds (name, version, source identity, dependency names; residual
+  warnings for toolchain/build logic and EB generation-native dep versions).
+- Frozen fixtures under `fixtures/foreign_ingest/` and integration tests
+  (`tests/foreign_ingest.rs`) for library + CLI ingest paths.
+- In-site Rust API docs path (sphinx-rustdocgen) and public packaging hygiene
+  from the 0.2.x docs/CI workline.
+
+### Changed
+
+- Project version surfaces (`Cargo.toml`, `pixi.toml`, `CITATION.cff`, docs
+  `release`, binary `--version`) aligned at **0.3.0**.
 
 ## [0.2.0] - 2026-07-10
 
@@ -28,6 +37,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Annual-bump skill and agent driver contract (`skills/annual-bump/`,
   `AGENTS.md`).
 - Frozen eOn and QMCPACK foss-2026.1 packaging fixtures.
+- GitHub Actions CI for unit tests, known-bump regression, packaging fixtures,
+  solve/stack-diff, and CLI smoke.
+- Operator guide for the annual toolchain-generation bump
+  (`docs/orgmode/howto/run-annual-bump.org`).
+- CLI auto-bump regression tests for frozen maintainer pairs under
+  `tests/repro_fixtures/`.
 
 ### Changed
 

CITATION.cff

@@ -10,8 +10,8 @@ authors:
 license: MIT
 repository-code: "https://github.com/HaoZeke/eb-stack"
 url: "https://eb-stack.rgoswami.me"
-version: 0.2.0
-date-released: "2026-07-10"
+version: 0.3.0
+date-released: "2026-07-13"
 keywords:
   - EasyBuild
   - HPC

CONTRIBUTING.md

@@ -62,3 +62,30 @@ unless a maintainer says otherwise in the live conversation.
    `docs/source/conf.py` release.
 3. Tag `vX.Y.Z` and push the tag; CI publishes the GitHub Release when the
    release workflow is enabled.
+
+
+## Tag and release
+
+Version source of truth: `version` in root `Cargo.toml` (currently **0.3.0**).
+Keep these in lockstep on every release:
+
+1. `Cargo.toml` / `pixi.toml` `version`
+2. `CITATION.cff` `version` (+ `date-released` when cutting)
+3. `docs/source/conf.py` `release`
+4. `CHANGELOG.md` — move Unreleased notes into `## [X.Y.Z] - YYYY-MM-DD`
+
+Then:
+
+```bash
+git tag -a v0.3.0 -m "eb-stack 0.3.0"
+git push origin v0.3.0
+# GitHub Actions ci_release.yml builds linux x86_64 tarball + checksum
+```
+
+Verify the binary surface:
+
+```bash
+cargo build --release
+./target/release/eb-stack --version
+# → eb-stack 0.3.0
+```

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "eb_stack"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 rust-version = "1.75"
 description = "EasyBuild stack lock solver: parse .eb, resolvo SAT co-select, hierarchy-aware bump, planned CycloneDX SBOM"

Cargo.toml

@@ -77,6 +77,31 @@ Optional `--sbom-out` writes a planned CycloneDX inventory. Baseline generation
 selection (nearest lower vs explicit) is documented in the
 [solve howto](docs/orgmode/howto/solve-lock.org).
 
+
+## Ingest foreign recipes (conda-forge / Spack)
+
+Scaffold a parseable EasyBuild `.eb` from a frozen foreign recipe (name,
+version, source identity, dependency **names**; build logic and EB generation
+versions remain residual):
+
+```bash
+./target/release/eb-stack ingest \
+  --source fixtures/foreign_ingest/conda_zlib/meta.yaml \
+  --toolchain-name foss --toolchain-version 2024a \
+  --out /tmp/zlib-from-conda.eb
+
+./target/release/eb-stack ingest \
+  --source fixtures/foreign_ingest/spack_zlib/package.py \
+  --format spack \
+  --out /tmp/zlib-from-spack.eb
+```
+
+## Version
+
+```bash
+eb-stack --version   # crate version (Cargo.toml); tag releases as vX.Y.Z
+```
+
 ## Documentation
 
 | Kind | Where |

README.md

@@ -5,6 +5,11 @@ The full Keep a Changelog history lives in
 [[https://github.com/HaoZeke/eb-stack/blob/main/CHANGELOG.md][CHANGELOG.md]]
 at the repository root. Highlights for the documentation site:
 
+* 0.3.0
+
+- ~eb-stack ingest~: conda-forge ~meta.yaml~ / Spack ~package.py~ → EB scaffold
+- Version surfaces aligned at 0.3.0; tag path ~vX.Y.Z~ documented in CONTRIBUTING
+
 * 0.2.0
 
 - Hierarchy-aware ~bump --easyconfigs~ with loud fail on unresolved deps

docs/orgmode/changelog.org

@@ -175,7 +175,7 @@ eb-stack --version
   Cite the repository and version (or the [[https://github.com/HaoZeke/eb-stack/blob/main/CITATION.cff][CITATION.cff]] metadata):
 
 #+begin_src text
-Rohit Goswami, eb-stack (version 0.2.0), https://github.com/HaoZeke/eb-stack
+Rohit Goswami, eb-stack (version 0.3.0), https://github.com/HaoZeke/eb-stack
 #+end_src
 
 * License

docs/orgmode/index.org

@@ -4,7 +4,7 @@
 * Top-level usage
 
 #+begin_src text
-eb-stack {solve|parse|check-recipe|solve-json|sbom|bump|mcp} [subcommand options]
+eb-stack {solve|parse|check-recipe|solve-json|sbom|bump|mcp|ingest} [subcommand options]
 #+end_src
 
 Built on [[https://docs.rs/clap][clap]]'s derive API. Every subcommand accepts
@@ -22,6 +22,7 @@ Subcommands at a glance:
 | ~sbom~ | CycloneDX from an existing lock |
 | ~bump~ | Next-generation easyconfig rewrite (hierarchy-aware auto deps) |
 | ~mcp~ | Stdio MCP server (~eb_check_recipe~ / ~eb_bump~ / ~eb_solve~) |
+| ~ingest~ | Foreign conda-forge / Spack recipe → EB scaffold |
 
 * solve
 
@@ -300,3 +301,31 @@ errors, per the MCP tools/call contract. Library entry point:
 |------+-------------------------------------------------------------------|
 |    0 | Success                                                          |
 |    1 | Error: parse failure, unsatisfiable policy, missing dep, packaging gate failure, missing file, or rewrite failure. The message names real package/version/field data, not internal solver identifiers. |
+
+* ingest
+
+Convert a foreign package recipe into a parseable EasyBuild scaffold.
+
+#+begin_src text
+eb-stack ingest
+  --source PATH
+  [--format auto|conda-forge|spack]
+  [--toolchain-name foss]
+  [--toolchain-version 2024a]
+  [--out PATH | --out-dir DIR]
+#+end_src
+
+- ~--source~ :: ~meta.yaml~ / ~recipe.yaml~ (conda-forge) or ~package.py~
+  (Spack). Required.
+- ~--format~ :: ~auto~ (default, from filename), ~conda-forge~, or ~spack~.
+- ~--toolchain-name~ / ~--toolchain-version~ :: scaffold toolchain identity
+  (operator-supplied generation; not invented from the foreign recipe).
+- ~--out~ / ~--out-dir~ :: output path or letter/name layout directory.
+
+The emit path is honest: name, version, source URL/filename, sha256 when
+present, and dependency *names* come from the foreign input. Easyblock,
+build steps, and EB generation-native dependency versions are residual
+(header warnings). Re-parse the result with ~check-recipe~ (robot completeness
+may still fail until companions and pins are filled).
+
+Fixtures: ~fixtures/foreign_ingest/~.

docs/orgmode/reference/cli.org

@@ -4,7 +4,7 @@
 project = "eb-stack"
 copyright = "2026, Rohit Goswami"
 author = "Rohit Goswami"
-release = "0.2.0"
+release = "0.3.0"
 
 # -- General configuration ---------------------------------------------------
 extensions = [