Skip to content

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

Merged
avrabe merged 1 commit intomainfrom
docs/cli-gaps-2026-04
Apr 22, 2026
Merged

docs: CLI gaps + severity backlog (real-world 3400-artifact project)#161
avrabe merged 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: 65d1889 Previous: 89d3f43 Ratio
query/10000 159874 ns/iter (± 571) 109298 ns/iter (± 621) 1.46

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 5 times, most recently from 8db26ba to 65d1889 Compare April 22, 2026 04:20
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 65d1889 to 292a3c9 Compare April 22, 2026 04:20
@avrabe avrabe merged commit 1dc7457 into main Apr 22, 2026
13 checks passed
@avrabe avrabe deleted the docs/cli-gaps-2026-04 branch April 22, 2026 04:20
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