Skip to content
Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace
BranchesTags

Latest commit

 

History

76 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
.idea
.idea
 
 
docs
docs
 
 
examples
examples
 
 
CONTACT.md
CONTACT.md
 
 
NOTICE.md
NOTICE.md
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
action.yml
action.yml
 
 

Repository files navigation

Tobi Validator

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.

It is also not an unrestricted public binary-distribution channel. The Action wrapper is public; controlled validator delivery remains separate.

Released Tobi Validator Surface

The released surface is intentionally narrow:

  • installable tobi CLI
  • canonical ASCII output
  • current _h compatibility identity
  • deterministic diagnostics
  • golden conformance 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.

Start Here

For the shortest public path:

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.json

Tsubasa Conformance Corpus

The 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. Running the validator still requires authorized Tobi Validator access through the evaluation access path. It should not be read as free, unrestricted validator execution.

Validator-Backed Example Repository

See the first public flagship validator-first demo repository:

This repository shows:

  • a valid .tsubasa artifact
  • 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

Tobi Validator GitHub Action

This repository exposes the public Tobi Validator GitHub Action wrapper.

The wrapper is public. Validator delivery is controlled and separate.

That means:

  • the public Action wrapper lives here
  • evaluation users use TOBI_EVAL_TOKEN issued through Organetic evaluation access
  • private distribution credentials are internal to Organetic and are not required in customer repositories
  • controlled distribution is handled internally by Organetic's evaluation broker
  • the Action infers the release archive from runner OS and architecture when no explicit archive override is provided

The Action exposes validator success or failure to GitHub. The consuming workflow owns any merge, release, allow, block, or escalation policy.

Supported runner families for the controlled binary line:

  • Windows x86_64
  • Linux x86_64
  • macOS arm64
  • macOS x86_64

Current Action modes:

  • canon
  • golden

No validate mode is shipped.

Required Secret

For evaluation access, create this repository secret in the consuming GitHub repository:

  • TOBI_EVAL_TOKEN

The secret should contain the 7-day evaluation token issued through:

https://organetic.ai/eval-access

Minimal Linux canon Example

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:
          eval_token: ${{ secrets.TOBI_EVAL_TOKEN }}
          mode: canon
          canon_input: path/to/artifact.tsubasa

Minimal Windows golden Example

name: Tobi Golden

on:
  workflow_dispatch:
  pull_request:

jobs:
  golden:
    runs-on: windows-latest

    steps:
      - uses: actions/checkout@v4

      - uses: OrganeticSphere/tobi-validator@v2
        with:
          eval_token: ${{ secrets.TOBI_EVAL_TOKEN }}
          mode: golden
          golden_fixtures: path/to/fixtures.json

Current v2 Reading

Action v2 is intentionally narrow:

  • canon mode
  • golden mode
  • evaluation-token access for public onboarding and customer repositories
  • controlled distribution handled internally by Organetic's evaluation broker
  • 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.

What This Repository Contains

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
  • unrestricted public full-binary distribution
  • the production Tobi implementation

GitHub-First Public Path

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 controlled validator delivery

The repository is meant to help users understand Tobi Validator and evaluate workflow fit. It should not be read as a promise that unrestricted production usage is available through direct public binary download.

Support

For failure interpretation and issue reporting, start with:

Please keep reports exact and reproducible.

Contact

Current Bottom Line

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
  • controlled validator delivery: separate from unrestricted public repository access

Telegram Channel X Profile

About

Tobi Validator — Reasoning Artifact Validator. Deterministic validation for canonical Tsubasa reasoning artifacts.

organetic.ai

Topics

ai-agentscligithub-actionsreasoningvalidationverification

Resources

Readme

Security policy

Security policy
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors