Skip to content

About

Developer CLI and workflow DSL for Roadscript content authentication, with an interactive terminal interface.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cyphra CLI

cyphra-cli is the public command-line interface, workflow DSL, and terminal application for the Roadscript platform.

It demonstrates the developer-facing application layer around Roadscript, including command execution, workflow authoring, local tooling, and package integration, while the core watermarking engine remains private.

Roadscript is a C++ platform for content authentication and verifiable digital media. It combines invisible watermarking, workflow automation, and developer tooling into a modular architecture for building authenticity-aware applications.

Repository Role

This repository is part of the Roadscript public/private repository ecosystem:

Repository Visibility Purpose
roadscript-docs Public Public overview, architecture notes, repository boundaries, and development milestones.
cyphra-cli Public Standalone CLI, workflow DSL, interactive terminal UI, examples, tests, and tooling.
roadscript-site Public Public website and sample-driven demo surface.
roadscript-engine Private Private C++ core package consumed by the application layer.

cyphra-cli focuses on developer-facing workflow surfaces, command orchestration, examples, and application-layer tests. It does not include the private Engine source.

Overview

This repository contains:

  • the rse command-line application
  • a C++ command-line frontend
  • the Cyphra workflow DSL
  • an interactive terminal UI
  • runnable workflow examples
  • CLI regression tests and fixtures
  • evaluation and reporting tools

The repository should be read as a public engineering artifact and a working application shell around the private Engine package. It is not presented as a finished end-user product release.

Architecture

The CLI is built as a consumer of an installed CMake package:

find_package(RoadscriptEngine CONFIG REQUIRED)
target_link_libraries(rse PRIVATE Roadscript::rsengine)

The private roadscript-engine repository owns the core C++ engine implementation. Its public integration boundary is the installed RoadscriptEngine CMake package and the exported Roadscript::rsengine target.

This split is intentional:

  • roadscript-engine owns the private core package and implementation details.
  • cyphra-cli owns the public CLI, workflow DSL, local TUI prototype, tests, examples, and tooling.
  • The application layer consumes the Engine through a package boundary instead of directly bundling Engine source.
  • Public code demonstrates application architecture without exposing private Engine internals.

Build

Configure the project with an installed RoadscriptEngine package:

cmake -S . -B build \
  -DCMAKE_BUILD_TYPE=Release \
  -DRoadscriptEngine_DIR=/path/to/RoadscriptEngine/cmake

cmake --build build

The resulting Cyphra CLI binary is expected at:

build/rse

Example Usage

./build/rse --help
./build/rse run examples/classic_roundtrip.rsx --dry-run

The example workflow is designed to exercise the CLI and DSL planning path without requiring a production backend or public Engine source.

Repository Layout

.
├── apps/
│   ├── cli/        # C++ command-line application
│   └── tui/        # Local TUI prototype
├── docs/           # CLI, DSL, and tooling documentation
├── examples/       # Example workflow scripts
├── tests/          # CLI-level regression tests and fixtures
├── tools/          # Evaluation and reporting helpers
├── CMakeLists.txt
└── README.md

Documentation

Current Status

  • Actively developed
  • Public application-layer repository
  • Built against the private RoadscriptEngine package
  • Standalone CMake consumer project
  • Workflow examples and regression tests
  • Interactive terminal UI

This repository is published to demonstrate Cyphra CLI’s application architecture, tooling, tests, examples, and package-consumer design. It should not be interpreted as a complete commercial release.

Notes For Reviewers

This repository showcases:

  • modern C++ application architecture
  • package-based dependency management with CMake
  • CLI and terminal UI design
  • workflow DSL implementation
  • application-layer testing
  • developer tooling and documentation
  • clean separation between public application code and a private engine package

For the full project map and architecture context, start with roadscript-docs.

Design Goals

Cyphra CLI is designed around several engineering principles:

  • modular application architecture
  • package-oriented dependency boundaries
  • reproducible command-line workflows
  • clear separation between public tooling and private implementation
  • developer-first ergonomics

Related Repositories

  • roadscript-docs — public overview, architecture notes, and repository boundaries.
  • roadscript-site — public website and sample-driven demo surface.
  • roadscript-engine — private C++ core package consumed through RoadscriptEngine and Roadscript::rsengine.

License

License information will be added before external reuse. For now, this repository is published for portfolio and project review.

About

Developer CLI and workflow DSL for Roadscript content authentication, with an interactive terminal interface.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages