Skip to content

docs: CLI gaps + severity backlog (real-world 3400-artifact project)#161

Open
avrabe wants to merge 1 commit intomainfrom
docs/cli-gaps-2026-04
Open

docs: CLI gaps + severity backlog (real-world 3400-artifact project)#161
avrabe wants to merge 1 commit intomainfrom
docs/cli-gaps-2026-04

Conversation

@avrabe
Copy link
Copy Markdown
Contributor

@avrabe avrabe commented Apr 21, 2026

What this ships

`docs/design/rivet-cli-gaps-2026-04.md` — 434 lines synthesizing real-world pain points from a 3400-artifact project.

Contents

Top-of-doc backlog (10 + 4 minor items ranked by severity) with fix site (file:line) + LoC bucket. Two HIGH items are already in flight:

5 feature design proposals in implementation-dependency order:

  1. Schema `path` field type (foundation, ~120 LoC)
  2. `rivet discover` / `rivet scan` — walk source tree, count native test markers per language
  3. `rivet add --from-source ` — generative variant of `rivet add`
  4. JUnit → unit-verification generation — not just import-results
  5. `rivet gaps --rule --suggest` — bucketize remediation

Each section: Why / Scope / CLI shape / Impl anchor (real file:line refs) / Dependency / Risk / LoC.

Test plan

Doc only. No code.

🤖 Generated with Claude Code

Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Performance Alert ⚠️

Possible performance regression was detected for benchmark 'Rivet Criterion Benchmarks'.
Benchmark result of this commit is worse than the previous benchmark result exceeding threshold 1.20.

Benchmark suite Current: f5f39a9 Previous: 60d728a Ratio
store_lookup/1000 24709 ns/iter (± 47) 19280 ns/iter (± 48) 1.28
diff/1000 705461 ns/iter (± 2776) 584274 ns/iter (± 2706) 1.21
query/100 780 ns/iter (± 1) 619 ns/iter (± 1) 1.26
query/1000 6632 ns/iter (± 33) 5174 ns/iter (± 14) 1.28

This comment was automatically generated by workflow using github-action-benchmark.

@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 21, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@avrabe avrabe force-pushed the docs/cli-gaps-2026-04 branch from 2100746 to f5f39a9 Compare April 21, 2026 18:59
Design proposal only — captures five missing rivet features surfaced by a
3,400-artifact reporting-project session (discover/scan, add --from-source,
gaps --suggest, schema path type, JUnit artifact generation) plus a ranked
backlog of 10 improvements. File-path anchors verified against the current
rivet-cli and rivet-core trees.

Refs: FEAT-001
@avrabe avrabe force-pushed the docs/cli-gaps-2026-04 branch from f5f39a9 to 6dedff3 Compare April 21, 2026 19:47
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