Skip to content

feat: cross-repository artifact linking#8

Merged
avrabe merged 15 commits intomainfrom
feat/cross-repo-linking
Mar 14, 2026
Merged

feat: cross-repository artifact linking#8
avrabe merged 15 commits intomainfrom
feat/cross-repo-linking

Conversation

@avrabe
Copy link
Copy Markdown
Contributor

@avrabe avrabe commented Mar 10, 2026

Summary

  • Add externals config block in rivet.yaml for declaring cross-repo dependencies (git URL or local path)
  • Prefixed ID syntax (rivet:REQ-001) for cross-repo artifact references
  • rivet sync — fetch/clone external repos into .rivet/repos/ cache (symlinks for local paths)
  • rivet lock — pin externals to exact commit SHAs in rivet.lock
  • rivet validate — cross-repo link validation, bidirectional backlink detection, circular dependency warnings, version conflict detection, V-model lifecycle completeness checks
  • rivet baseline verify <name> / rivet baseline list — distributed baselining via baseline/* convention tags
  • embed-wasm feature flag for single-binary WASM/JS asset embedding
  • Built-in docs: cross-repo topic, STPA/ASPICE/cybersecurity methodology references
  • Dogfood artifacts: REQ-020/021/022, DD-014–017, FEAT-033–039

Architecture

Mesh topology — any rivet repo can link to any other. No central authority. Bidirectional links stored on one side, backlinks computed at analysis time (OSLC model). Transitive dependency discovery. Distributed baselines via git tags.

New modules

  • rivet-core/src/externals.rs (1361 lines) — sync, load, validate, lockfile, baseline, backlinks, cycle/conflict detection
  • rivet-core/src/lifecycle.rs (218 lines) — V-model traceability completeness checks

Test plan

  • 30 new tests (24 externals, 4 lifecycle, 2 config integration)
  • 194 total tests passing
  • Clippy clean with -D warnings
  • Manual: rivet sync with a real external repo
  • Manual: rivet baseline verify with tagged repos
  • Manual: rivet validate with cross-repo links in meld

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 10, 2026

Codecov Report

❌ Patch coverage is 88.23529% with 122 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
rivet-core/src/externals.rs 86.47% 122 Missing ⚠️

📢 Thoughts on this report? Let us know!

avrabe and others added 15 commits March 13, 2026 18:33
Add ExternalProject struct and optional externals field to ProjectConfig,
supporting both git URL and local path sources with prefix-based
cross-linking. This is the foundation for cross-repo artifact tracing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-033

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements sync_external (symlink for path, clone/fetch for git),
sync_all (batch sync), and ensure_gitignore (.rivet/ cache entry).

Implements: FEAT-034

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-038

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-038

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-035

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-038

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-038

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-038

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Checks that artifacts with "done"/"implemented" status have complete
downstream traceability chains (requirement → architecture → design → test).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-037

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Trace: skip

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements: FEAT-036

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Trace: skip

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Fix clippy for_kv_map warnings
- Extract resolve_external_dir helper
- Add serial_test for flaky git-dependent tests

Trace: skip

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@avrabe avrabe force-pushed the feat/cross-repo-linking branch from 9ee3657 to bfe997b Compare March 14, 2026 15:10
@avrabe avrabe merged commit 7e36c8e into main Mar 14, 2026
13 of 15 checks passed
@avrabe avrabe deleted the feat/cross-repo-linking branch March 14, 2026 15:26
avrabe added a commit that referenced this pull request Apr 22, 2026
* docs+feat(variant): feature-model schema reference + init scaffolder

Pain point: users reverse-engineer the feature-model YAML schema because
`rivet variant --help` has no field reference and `selects:` vs
`selected:` / group types / s-expression constraint syntax / bindings
file shape are undocumented.

Changes:
- Add docs/feature-model-schema.md: top-level reference for feature
  model YAML (root, features, group types, constraint syntax) with a
  worked example.
- Add docs/feature-model-bindings.md: dedicated binding file reference.
- Link both from docs/getting-started.md.
- Variant subcommand doc-comment now points at the schema reference so
  `rivet variant --help` surfaces it.
- Add `rivet variant init <name>` scaffolder that writes a starter
  feature-model.yaml + bindings/<name>.yaml with comments documenting
  every field.

Tests: 3 new integration tests in rivet-cli/tests/variant_init.rs
covering scaffolded file contents, overwrite protection, and that the
scaffolded template parses clean via `rivet variant list`.

Implements: REQ-042, REQ-043, REQ-044
Refs: REQ-046

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(hooks): pre-commit hook walks up to find rivet.yaml (marker discovery)

Pain point: `rivet init --hooks` emitted a pre-commit hook that ran
`rivet validate` at the git root. If the rivet project is relocated
inside the working tree (e.g. moved to subdir/), the hook either
silently validates the wrong directory or fails to find rivet.yaml.

Fix: the installed pre-commit hook now walks up from $PWD until it
finds a directory containing rivet.yaml, then cd's there before
invoking `rivet validate`. If no rivet.yaml exists in the ancestor
chain, the hook exits 0 silently so it does not block commits in
unrelated repositories.

Tests: rivet-cli/tests/hooks_install.rs adds 2 integration tests — one
verifies the hook body does not embed a hard-coded -p/--project flag and
uses the walk-up pattern; one stages a fresh project, moves rivet.yaml
into a subdirectory, and confirms the hook still discovers it when run
from a nested path.

Fixes: REQ-051

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(variant): check-all + optional --variant on validate (API ergonomics)

Pain point: variant-scoped validation required --model, --variant, and
--binding to be passed together — there was no way to validate just
model/binding consistency, and no single-invocation way to assert a
whole batch of variants is valid.

Changes:
- `rivet validate --model X --binding Y` (no --variant) now parses the
  model, parses the binding, and checks that every feature referenced
  in the binding exists in the model. Reports a clear diagnostic on
  unknown feature names instead of the old "must all be provided
  together" error. The full --model + --variant + --binding mode is
  unchanged.
- `rivet variant check-all --model M --binding B` iterates every
  variant declared under `variants:` in the binding file, prints a
  PASS/FAIL line per variant, and exits non-zero if any fail.
- `FeatureBinding` in rivet-core grows an optional `variants:` field
  (default empty) so the same file can carry bindings and declared
  variants without schema churn.

Tests: 5 new integration tests in rivet-cli/tests/variant_scoped_api.rs
cover the no-variant validate mode, the unknown-feature diagnostic,
check-all exit codes for mixed/all-pass fixtures, and JSON output shape.
Existing feature_model unit tests still pass (binding YAML is
backward-compatible — `variants:` defaults to empty).

Implements: REQ-044, REQ-045, REQ-046

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(sexpr): semantic notes on filter parse errors

Pain point: `[FilterError { offset: 14, message: "unexpected atom at
top level" }]` exposed parser internals. Users writing `A and B`,
`and A B`, or `(bogus A B)` got a positional offset with no hint that
they were using the wrong syntax.

Fix: extend `FilterError` with an optional `note` field, populated by a
classifier that inspects the source before parsing. Three common shapes
get a semantic nudge:
  - bare infix (`A and B`) → suggest `(and A B)`.
  - missing outer parens (`and A B`) → suggest wrapping it.
  - unknown head (`(bogus …)`) → reference the supported form list.
`FilterError::Display` renders the positional detail followed by the
note on a new line. Feature-model constraint errors now format via
Display instead of Debug, so the note bubbles out through
`rivet variant check` / `rivet validate --model` paths.

Tests: 4 new unit tests in sexpr_eval covering the three error shapes
plus a success case that must carry no note. All pre-existing tests
unchanged.

Fixes: REQ-043
Implements: REQ-042

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(variant-solve): per-feature origin tracking (selected vs mandatory vs implied)

Pain point: `rivet variant solve` output mixed user-picked features with
ones the solver added via mandatory-group propagation or constraint
implication. A flat list like `base, auth, oauth, token-cache, metrics`
didn't tell the user which features were their intent and which were
downstream effects.

Minimum-impact change per scope-limits brief (risk of conflict with
PR #156 cross-tree constraint work):
- Extend `ResolvedVariant` with a per-feature `origins: BTreeMap<String,
  FeatureOrigin>` where FeatureOrigin is UserSelected / Mandatory /
  ImpliedBy(name) / AllowedButUnbound.
- Populate origins alongside the existing selected-set fixpoint loop —
  no algorithmic changes. First-reason-wins on insertion so user
  selection beats later mandatory/implied discoveries.
- Text output of `rivet variant solve` prints one feature per line,
  prefixed with `+`, labeled (mandatory) / (selected) / (implied by X).
- JSON output is strictly additive: `effective_features` + `feature_count`
  preserved, new `origins` object keyed by feature name.

Tests:
- 4 new unit tests in rivet-core/src/feature_model.rs covering each
  origin variant.
- 2 new integration tests in rivet-cli/tests/variant_solve_origins.rs
  asserting text prefixes/labels and JSON backwards compatibility.
- All 15 pre-existing feature_model unit tests still pass; all 6
  proptest_feature_model properties still hold.

Implements: REQ-043, REQ-046
Refs: REQ-052

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant