Skip to content

Conversation

@tcdent
Copy link
Owner

@tcdent tcdent commented Jan 21, 2026

Summary

Combines validator and agent into a single worldview binary with subcommands.

Changes

  • Renamed agent/cli/
  • Unified binary with subcommands:
    • worldview validate - validate .wvf files
    • worldview add - add facts using AI agent
  • Embedded spec in --help output via include_str!("../../system.md")
  • Removed separate worldview-validate binary
  • Updated workflows to use cli/, uv, and single binary
  • Updated docs (README.md, RELEASE.md)

Usage

# Validate
worldview validate example.wvf

# Add fact with AI
worldview add "Trust erodes faster than it builds" -f worldview.wvf

# View full spec
worldview --help

Notes

  • Validation runs automatically on add before writing
  • system.md (generated from spec) is embedded at compile time
  • All 35 validator tests pass

Build dependencies don't affect the final binary - no reason to avoid them.
The previous implementation was fragile and would break on formatting changes.
References like &Concept.facet now validated to ensure the target
concept and facet actually exist in the document.

- Added UndefinedReference error variant
- collect_valid_references() builds set of valid targets
- validate_claim_syntax() checks references against the set
- Added test_undefined_reference test case
- Added test_valid_cross_reference test case
- Fixed test_claim_with_reference to include referenced facet
- Added pyproject.toml at project root with uv support
- Updated README to use uv commands
- Removed evals/requirements.txt
- Added uv.lock for reproducible builds
Builds for macOS ARM, Linux x86_64, and Linux ARM on tag push.
Creates GitHub release with:
- worldview-validate-{platform}.tar.gz
- worldview-{platform}.tar.gz

Added RELEASE.md with release process documentation.
- Rename agent/ to cli/ with single 'worldview' binary
- Add subcommands: 'validate' and 'add'
- Embed system.md spec in --help output via include_str!()
- Remove separate worldview-validate binary
- Update all workflows for cli/, uv, and single binary
- Update README and RELEASE.md documentation
- Add .codey/ to gitignore
@tcdent tcdent merged commit 130df11 into main Jan 22, 2026
4 checks passed
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.

2 participants