Reasoning Artifact Validator
Deterministic validation for canonical reasoning artifacts.
Tobi Validator deterministically validates and canonicalizes Tsubasa reasoning artifacts for use at workflow boundaries.
The public authoring and validation model is:
authored Tsubasa source
→ validation and Tsubasa canonicalization through Tobi
→ canonical ASCII + _h compatibility identity
or, for rejected input:
authored Tsubasa source
→ validation through Tobi
→ deterministic diagnostics
Authored source is not assumed to be canonical. The Tsubasa language contract defines the semantic and canonical rules; Tobi is the reference validator that implements and operationally enforces that contract.
This repository is the public GitHub entry surface for Tobi Validator. It provides:
- public documentation
- shipped examples
- GitHub workflow adoption guidance
- diagnostics and support guidance
- workflow-fit and issue intake
- the public Tobi Validator GitHub Action wrapper
It is a public documentation and adoption repository.
It is not the full development source repository.
The Action runs freely without registration or repository secrets. Released validator binaries and SHA-256 sidecars are available in this repository's GitHub Releases.
The released surface is intentionally narrow:
- installable
tobiCLI - canonical ASCII output
- current
_hcompatibility identity - deterministic diagnostics
goldenconformance execution- thin packaging and install / usage framing
Tobi Validator should not be read as:
- a runtime / backend product
- a public verification API
- a platform SDK
- a theorem prover or universal truth engine
- a broader Organetic platform release
_h is compatibility identity only. Canonical equality does not establish
factual truth, and validator acceptance is not universal correctness.
For the shortest public path:
- Tobi Validator Quickstart
- Finding Your First Reasoning Artifacts
- Agent Workflow Governance vs Reasoning Verification
- Tsubasa Public Syntax and Authoring Reference
- Tsubasa Conformance Corpus
- Tobi Validator Install and Usage
- Tobi Validator Diagnostics Reference
- Tobi Validator Support and Issue Reporting
- Tobi Validator GitHub Action Starter
The public syntax-and-authoring document above is an interim reference for the current released validator corridor. It does not replace the forthcoming complete Tsubasa Language Reference book.
The physical filenames above retain legacy STAGE1 spelling for link stability.
Their visible titles and current product language follow the active Tobi public
naming contract.
Representative command shapes:
.\tobi.exe canon .\examples\sample.tsubasa
.\tobi.exe golden .\examples\golden\fixtures.json./tobi canon ./examples/sample.tsubasa
./tobi golden ./examples/golden/fixtures.jsonThe public Tsubasa Conformance Corpus is available at
OrganeticSphere/tsubasa-stage1-conformance.
The repository slug is retained for link stability. The corpus provides
public-safe .tsubasa examples, manifest records, verified canonical outputs,
diagnostics, and coverage limitations. It makes observable Tobi Validator
behavior more inspectable without publishing the private validator
implementation.
Read the local overview in Tsubasa Conformance Corpus, or inspect the public corpus manifest, verification report, and coverage limitations.
The public corpus can be reviewed independently and checked with the freely available Tobi Validator GitHub Action or public release binaries.
See the first public flagship validator-first demo repository:
This repository shows:
- a valid
.tsubasaartifact - a surface-different accepted variant with the same recorded canonical result
- a malformed reject sibling
- a GitHub workflow that uses Tobi Validator results as a pull-request check
This repository exposes the public Tobi Validator GitHub Action wrapper.
The Action is free to run in public and private repositories, including fork pull requests. No registration, access token, or repository secret is required.
- the public Action wrapper lives here
- binaries are downloaded directly from this repository's public GitHub Releases
- SHA-256 checksums are verified before extraction
- the Action selects the archive for the runner OS and architecture
The Action exposes validator success or failure to GitHub. The consuming workflow owns any merge, release, allow, block, or escalation policy.
Supported runner families:
- Windows x86_64
- Linux x86_64
- macOS arm64
- macOS x86_64
Current Action modes:
canongolden
No validate mode is shipped.
Check out your repository and run OrganeticSphere/tobi-validator@v2 with
mode and the input path. No secret setup is needed.
name: Tobi Canon
on:
workflow_dispatch:
pull_request:
jobs:
canon:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: OrganeticSphere/tobi-validator@v2
with:
mode: canon
canon_input: path/to/artifact.tsubasaname: Tobi Golden
on:
workflow_dispatch:
pull_request:
jobs:
golden:
runs-on: windows-latest
steps:
- uses: actions/checkout@v4
- uses: OrganeticSphere/tobi-validator@v2
with:
mode: golden
golden_fixtures: path/to/fixtures.jsonAction v2 is intentionally narrow:
canonmodegoldenmode- free execution without repository secrets
- public GitHub Release downloads
- checksum verification before extraction
- OS-aware archive selection for Windows, Linux, and macOS
- no runtime, backend, public API, or platform claims
See the Action version policy and v2 migration guide for the supported line and legacy migration boundaries.
This repository contains:
- public Tobi Validator documentation
- shipped examples
- GitHub workflow starter materials
- support and diagnostics guidance
- public workflow-fit and issue-intake paths
- the public Action wrapper surface
This repository does not contain:
- the full private development source tree
- internal product-boundary notes
- internal launch-control documents
- the production Tobi implementation
The current public adoption path is GitHub-first:
- product understanding
- documentation
- shipped examples
- a narrow workflow path around the released validator CLI
- a public Action wrapper with free execution and public binary downloads
Use the examples to check workflow fit, then point the Action at your own Tsubasa artifacts. Public release downloads support local CLI use as well.
For failure interpretation and issue reporting, start with:
Please keep reports exact and reproducible.
- Website: https://organetic.ai
- support@organetic.ai
This repository is the public GitHub entry surface for Tobi Validator.
In short:
- product: Tobi Validator
- descriptor: Reasoning Artifact Validator
- category line: Deterministic validation for canonical reasoning artifacts.
- public path: GitHub-first
- current surface: narrow validator-first CLI + GitHub Action wrapper
- this repository: docs + examples + workflow guidance + Action wrapper + issue intake
- execution: free GitHub Action + public release binaries