whatisgithub

What is ontoguard-extension?

cloudbadal007/ontoguard-extension — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A local VS Code and Cursor extension that checks written business rules for direct contradictions and unresolved end conditions before an AI agent or person acts on them.

Mindmap

mindmap
  root((OntoGuard))
    What it does
      Finds rule contradictions
      Flags unmatched end conditions
      Validates SHACL constraints
    Tech stack
      TypeScript
      VS Code extension
      SHACL
    Use cases
      Check policy files
      Validate SHACL data
      Run demo scenarios
    Audience
      Developers
      Rule and policy authors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Catch contradictory business rules, like one requiring a payment and another forbidding it under the same conditions.

USE CASE 2

Detect rules that say a duty continues 'until' some condition, when nothing else in the rule set actually checks for that condition.

USE CASE 3

Validate SHACL shape and data files for constraint violations directly inside the editor.

What is it built with?

TypeScriptVS Code Extension APISHACL

How does it compare?

cloudbadal007/ontoguard-extension0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs fully locally with no account or API key, developers clone the repo, run npm install and npm run compile, then launch it in VS Code with F5.

MIT license, free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

So what is it?

OntoGuard is a small VS Code and Cursor extension that checks written business rules for contradictions or gaps before an AI agent or a person acts on them. It runs entirely on your own machine, with no account, cloud service, or API key needed. The problem it solves is simple to describe but easy to miss by hand. Two rules might both look reasonable on their own, such as one saying a claim must be paid once coverage is confirmed, and another saying the same claim must not be paid while there is an open investigation. A person reading both might catch the conflict, but an automated system often will not, and could end up paying a claim it should have blocked. Similarly, a rule might say a duty continues until some condition is met, but if nothing in the rule set actually checks for that condition, the duty never really ends. You give OntoGuard your rules in one of two formats: a simple JSON file listing each rule's subject, required action, trigger condition, and optional end condition, or a Turtle file using SHACL, a standard way of describing data constraints. Running a command checks the rules and reports contradictions, unmatched end conditions, or SHACL violations in VS Code's Problems and Output panels, in plain language rather than technical jargon. The author is clear about its limits: this is a structural checker, not a full mathematical proof system, so it catches common and costly mistakes early rather than guaranteeing complete correctness. It also does not replace legal review, and it does not send any of your files off your machine. The project ships with sample rule files and a one-click demo scenario so a new user can see the tool work before writing their own rules.

Copy-paste prompts

Prompt 1
Show me how to write a .policies.json file for OntoGuard to check two rules for contradictions.
Prompt 2
Walk me through running the OntoGuard: Run Demo Scenario command to see how this extension works.
Prompt 3
Explain the difference between a 'temporal leak' and a direct contradiction as this extension defines them.
Prompt 4
Help me set up a SHACL shapes and data Turtle file that OntoGuard can validate.

Frequently asked questions

What is ontoguard-extension?

A local VS Code and Cursor extension that checks written business rules for direct contradictions and unresolved end conditions before an AI agent or person acts on them.

What language is ontoguard-extension written in?

Mainly TypeScript. The stack also includes TypeScript, VS Code Extension API, SHACL.

What license does ontoguard-extension use?

MIT license, free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

How hard is ontoguard-extension to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ontoguard-extension for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.