Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions apps/oss/content/projects/ontoly/.provenance.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"sourceRepository": "0xsarwagya/ontoly",
"sourceCommit": "875b94588bc8a6effa1af2dc1cd0e294c85c361f",
"version": "0.1.0-alpha.13",
"publishedAt": "2026-07-14T21:01:42.373Z",
"sourceCommit": "3cf80c2650b81f357e98d12350a9cd1fd41ab62e",
"version": "0.1.0-alpha.19",
"publishedAt": "2026-07-15T09:49:18.609Z",
"manifestSchemaVersion": 1
}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/agent-skills.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Ontoly Agent Skills"
description: "Ontoly Agent Skills are portable SKILL.md packages that teach coding agents how to use Ontoly before searching source files."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/agent-skills"
canonical: "https://ontoly.sarwagya.wtf/docs/agent-skills"
source: "docs/agent-skills.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Agent", "Skills"]
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Architecture Reports"
description: "Architecture reports are generated from the Software Graph."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/architecture-reports"
canonical: "https://ontoly.sarwagya.wtf/docs/architecture-reports"
source: "docs/architecture-reports.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Architecture", "Reports"]
---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Benchmark Methodology"
description: "How Ontoly benchmarks semantic capabilities without measuring graph size alone."
order: 29
canonical: "https://oss.sarwagya.wtf/ontoly/docs/benchmark-methodology"
canonical: "https://ontoly.sarwagya.wtf/docs/benchmark-methodology"
source: "docs/benchmark-methodology.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Benchmark", "Methodology"]
---
Expand Down
20 changes: 10 additions & 10 deletions apps/oss/content/projects/ontoly/docs/capabilities.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Capabilities"
description: "Deterministic software-engineering capabilities over the Ontoly Software Graph."
order: 22
canonical: "https://oss.sarwagya.wtf/ontoly/docs/capabilities"
canonical: "https://ontoly.sarwagya.wtf/docs/capabilities"
source: "docs/capabilities.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Capabilities"]
---
Expand Down Expand Up @@ -50,7 +50,7 @@ This shape is used by:
- Agent Skills that consume MCP

If an LLM turns a capability result into a user-facing answer, it must do so
through [LLM Enhancement](/ontoly/docs/llm-enhancement). Capabilities remain
through [LLM Enhancement](/docs/llm-enhancement). Capabilities remain
deterministic and AI-free; LLM Enhancement governs evidence, confidence, and
fallback behavior around them.

Expand Down Expand Up @@ -135,11 +135,11 @@ question.

## Related Docs

- [Capability API](/ontoly/docs/capability-api)
- [Capability Registry](/ontoly/docs/capability-registry)
- [Evidence Model](/ontoly/docs/evidence-model)
- [Confidence Model](/ontoly/docs/confidence-model)
- [Implementation Planning](/ontoly/docs/implementation-planning)
- [Question Corpus](/ontoly/docs/question-corpus)
- [Benchmark Methodology](/ontoly/docs/benchmark-methodology)
- [Agent Skills](/ontoly/docs/agent-skills)
- [Capability API](/docs/capability-api)
- [Capability Registry](/docs/capability-registry)
- [Evidence Model](/docs/evidence-model)
- [Confidence Model](/docs/confidence-model)
- [Implementation Planning](/docs/implementation-planning)
- [Question Corpus](/docs/question-corpus)
- [Benchmark Methodology](/docs/benchmark-methodology)
- [Agent Skills](/docs/agent-skills)
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/capability-api.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Capability API"
description: "How Ontoly exposes deterministic software-engineering capabilities."
order: 23
canonical: "https://oss.sarwagya.wtf/ontoly/docs/capability-api"
canonical: "https://ontoly.sarwagya.wtf/docs/capability-api"
source: "docs/capability-api.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Capability", "API"]
---
Expand Down
4 changes: 2 additions & 2 deletions apps/oss/content/projects/ontoly/docs/capability-registry.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Capability Registry"
description: "How Ontoly registers, orders, and executes deterministic capabilities."
order: 24
canonical: "https://oss.sarwagya.wtf/ontoly/docs/capability-registry"
canonical: "https://ontoly.sarwagya.wtf/docs/capability-registry"
source: "docs/capability-registry.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Capability", "Registry"]
---
Expand Down Expand Up @@ -42,5 +42,5 @@ software-engineering logic.

## Versioning

Capability versions start at `1.0.0` for the alpha surface. Breaking changes to
Capability versions start at `1.0.0` for the Public Preview surface. Breaking changes to
input or output shape require a new capability version and documentation update.
7 changes: 6 additions & 1 deletion apps/oss/content/projects/ontoly/docs/cli.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "CLI"
description: "The CLI builds, inspects, validates, and benchmarks the Software Graph."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/cli"
canonical: "https://ontoly.sarwagya.wtf/docs/cli"
source: "docs/cli.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "CLI"]
---
Expand Down Expand Up @@ -263,6 +263,8 @@ parse repositories or mutate the Software Graph.
ontoly enhancer list
ontoly enhancer inspect semantic-index
ontoly enhancer run semantic-index .
ontoly semantics build .
ontoly semantics inspect "sleep duration thresholds" --json
ontoly enhancer run MarkdownDocs .
ontoly enhancer graph --format mermaid
ontoly enhancer validate --ci
Expand All @@ -274,6 +276,9 @@ ontoly enhancer validate --ci
See [Enhancers](./enhancers) for the API, lifecycle, artifact model, caching,
manifests, and pipeline visualization.

See [Semantic Intelligence](./semantic-intelligence) for the derived Semantics
artifact and concept graph.

## Semantic Index Search

Use Semantic Index commands when you know the concept but not the exact graph
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Compatibility Matrix"
description: "Runtime, package, Software Graph, Agent Skill, MCP, CLI, and release compatibility for Ontoly alpha builds."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/compatibility-matrix"
description: "Runtime, package, Software Graph, Agent Skill, MCP, CLI, and release compatibility for Ontoly Public Preview builds."
canonical: "https://ontoly.sarwagya.wtf/docs/compatibility-matrix"
source: "docs/compatibility-matrix.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Compatibility", "Matrix"]
---
Expand All @@ -14,7 +14,7 @@ keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "
| Package module format | ESM | Supported |
| Software Graph Spec | 1.0 draft | Supported |
| Agent Skills | Vercel-style `SKILL.md` folders | Supported |
| MCP transport | JSON lines through CLI runtime | Alpha |
| MCP transport | JSON lines through CLI runtime | Public Preview |

## Package Compatibility

Expand Down
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/compatibility.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Compatibility"
description: "Runtime and language support."
order: 98
canonical: "https://oss.sarwagya.wtf/ontoly/docs/compatibility"
canonical: "https://ontoly.sarwagya.wtf/docs/compatibility"
source: "docs/compatibility.mdx"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Compatibility"]
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Compiler Pipeline v2"
description: "How Ontoly separates TypeScript analysis, framework analysis, semantic generation, graph construction, validation, and serialization."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/compiler-pipeline-v2"
canonical: "https://ontoly.sarwagya.wtf/docs/compiler-pipeline-v2"
source: "docs/compiler-pipeline-v2.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Compiler", "Pipeline"]
---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Compiler Pipeline"
description: "How Ontoly turns source files into graph artifacts."
order: 2
canonical: "https://oss.sarwagya.wtf/ontoly/docs/concepts/compiler-pipeline"
canonical: "https://ontoly.sarwagya.wtf/docs/concepts/compiler-pipeline"
source: "docs/concepts/compiler-pipeline.mdx"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Compiler", "Pipeline", "concepts"]
---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Plugin System"
description: "How plugins consume the Software Graph."
order: 3
canonical: "https://oss.sarwagya.wtf/ontoly/docs/concepts/plugin-system"
canonical: "https://ontoly.sarwagya.wtf/docs/concepts/plugin-system"
source: "docs/concepts/plugin-system.mdx"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Plugin", "System", "concepts"]
---
Expand All @@ -21,7 +21,7 @@ import type { OntolyPlugin } from "@0xsarwagya/ontoly-core";

export const plugin: OntolyPlugin = {
name: "example",
version: "0.1.0-alpha.1",
version: "1.0.0",
run: ({ graph }) => ({
artifacts: [
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Software Graph"
description: "The semantic graph Ontoly builds from a repository."
order: 1
canonical: "https://oss.sarwagya.wtf/ontoly/docs/concepts/software-graph"
canonical: "https://ontoly.sarwagya.wtf/docs/concepts/software-graph"
source: "docs/concepts/software-graph.mdx"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Software", "Graph", "concepts"]
---
Expand Down
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/confidence-model.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Confidence Model"
description: "How Ontoly derives capability confidence from graph evidence."
order: 26
canonical: "https://oss.sarwagya.wtf/ontoly/docs/confidence-model"
canonical: "https://ontoly.sarwagya.wtf/docs/confidence-model"
source: "docs/confidence-model.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Confidence", "Model"]
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Configuration Graph"
description: "Configuration is first-class in the Software Graph."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/configuration-graph"
canonical: "https://ontoly.sarwagya.wtf/docs/configuration-graph"
source: "docs/configuration-graph.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Configuration", "Graph"]
---
Expand Down
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/contributing.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Contributing"
description: "Ontoly changes should preserve determinism, explainability, and graph stability."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/contributing"
canonical: "https://ontoly.sarwagya.wtf/docs/contributing"
source: "docs/contributing.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Contributing"]
---
Expand Down
4 changes: 3 additions & 1 deletion apps/oss/content/projects/ontoly/docs/enhancers.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Enhancers"
description: "Enhancers are deterministic compiler-pass-style transformations over Ontoly artifacts."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/enhancers"
canonical: "https://ontoly.sarwagya.wtf/docs/enhancers"
source: "docs/enhancers.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Enhancers"]
---
Expand Down Expand Up @@ -114,6 +114,7 @@ Examples:

- `SoftwareGraph`
- `SemanticIndex`
- `Semantics`
- `RepositorySummary`
- `ArchitectureReport`
- `HealthReport`
Expand Down Expand Up @@ -242,6 +243,7 @@ Built-ins wrap existing Ontoly behavior without changing compiler output:
| Enhancer | Produces |
| --- | --- |
| `semantic-index` | `SemanticIndex` |
| `semantics` | `Semantics` |
| `capability-catalog` | `CapabilityCatalog` |
| `evidence-pack` | `EvidencePack` |
| `validation-report` | `ValidationReport`, `Coverage` |
Expand Down
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/errors.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Error System"
description: "Ontoly CLI errors are structured around stable codes."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/errors"
canonical: "https://ontoly.sarwagya.wtf/docs/errors"
source: "docs/errors.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Error", "System", "errors"]
---
Expand Down
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/evidence-model.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Evidence Model"
description: "How capabilities cite graph evidence for deterministic answers."
order: 25
canonical: "https://oss.sarwagya.wtf/ontoly/docs/evidence-model"
canonical: "https://ontoly.sarwagya.wtf/docs/evidence-model"
source: "docs/evidence-model.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Evidence", "Model"]
---
Expand Down
2 changes: 1 addition & 1 deletion apps/oss/content/projects/ontoly/docs/examples.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Examples"
description: "Run Ontoly graph generation, inspection, architecture reports, HTML graph export, Mermaid export, and MCP commands from a repository root."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/examples"
canonical: "https://ontoly.sarwagya.wtf/docs/examples"
source: "docs/examples.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Examples"]
---
Expand Down
4 changes: 2 additions & 2 deletions apps/oss/content/projects/ontoly/docs/faq.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "FAQ"
description: "Developer tools keep rebuilding the same understanding of a codebase."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/faq"
canonical: "https://ontoly.sarwagya.wtf/docs/faq"
source: "docs/faq.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "FAQ"]
---
Expand All @@ -19,7 +19,7 @@ graph through MCP or plugins, but every LLM-facing Ontoly workflow must use

## What languages are supported?

The alpha focuses on TypeScript and repository intelligence. OpenAPI support is
The Public Preview focuses on TypeScript and repository intelligence. OpenAPI support is
available as a frontend. Other frontends are planned through RFCs and plugins.

## Where are artifacts written?
Expand Down
6 changes: 3 additions & 3 deletions apps/oss/content/projects/ontoly/docs/feature-matrix.mdx
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: "Feature Matrix"
description: "Supported, alpha, and non-goal surfaces across Ontoly packages, validation, MCP, skills, and graph tooling."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/feature-matrix"
description: "Supported, Public Preview, and non-goal surfaces across Ontoly packages, validation, MCP, skills, and graph tooling."
canonical: "https://ontoly.sarwagya.wtf/docs/feature-matrix"
source: "docs/feature-matrix.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Feature", "Matrix"]
---

| Feature | Alpha Status | Evidence |
| Feature | Public Preview Status | Evidence |
| ------- | ------------ | -------- |
| Software Graph JSON | Supported | `@0xsarwagya/ontoly-core` |
| TypeScript frontend | Supported | `@0xsarwagya/ontoly-parser-typescript` |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Framework Analyzer API"
description: "Framework analyzers turn a TypeScript Semantic Model into framework semantic facts."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/framework-analyzer-api"
canonical: "https://ontoly.sarwagya.wtf/docs/framework-analyzer-api"
source: "docs/framework-analyzer-api.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Framework", "Analyzer", "API"]
---
Expand Down Expand Up @@ -110,7 +110,7 @@ The NestJS analyzer is the first complete analyzer. It supports:

The default registry also includes deterministic detection for Express,
Fastify, Hono, Next.js, React, and Prisma. Only NestJS performs complete
semantic extraction in the current alpha.
semantic extraction in the current Public Preview.

## Flow

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Framework Detection"
description: "Framework detection uses explicit deterministic signatures."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/framework-detection"
canonical: "https://ontoly.sarwagya.wtf/docs/framework-detection"
source: "docs/framework-detection.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Framework", "Detection"]
---
Expand Down
10 changes: 5 additions & 5 deletions apps/oss/content/projects/ontoly/docs/framework-matrix.mdx
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
title: "Framework Matrix"
description: "Framework coverage should be measured through Validation Lab, not inferred from package names alone."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/framework-matrix"
canonical: "https://ontoly.sarwagya.wtf/docs/framework-matrix"
source: "docs/framework-matrix.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Framework", "Matrix"]
---

| Framework or Surface | Status | Notes |
| -------------------- | ------ | ----- |
| TypeScript projects | Supported | Primary alpha target |
| NestJS-style APIs | Alpha | Validated through examples and corpus fixtures |
| Turborepo workspaces | Alpha | Workspace graph validation present |
| TypeScript projects | Supported | Primary Public Preview target |
| NestJS-style APIs | Public Preview | Validated through examples and corpus fixtures |
| Turborepo workspaces | Public Preview | Workspace graph validation present |
| React | Corpus fixture | Validation evidence only |
| Next.js | Corpus fixture | Validation evidence only |
| Express | Corpus fixture | Validation evidence only |
| Hono | Corpus fixture | Validation evidence only |
| OpenAPI | Alpha frontend | Schema-driven graph facts |
| OpenAPI | Public Preview frontend | Schema-driven graph facts |
| Prisma | Roadmap | Not implemented |
| GraphQL | Roadmap | Not implemented |

Expand Down
4 changes: 2 additions & 2 deletions apps/oss/content/projects/ontoly/docs/framework-registry.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Framework Registry"
description: "The Framework Registry owns analyzer registration, deterministic ordering, detection, and fact collection."
canonical: "https://oss.sarwagya.wtf/ontoly/docs/framework-registry"
canonical: "https://ontoly.sarwagya.wtf/docs/framework-registry"
source: "docs/framework-registry.md"
keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Framework", "Registry"]
---
Expand Down Expand Up @@ -43,7 +43,7 @@ It does not construct graph nodes and does not run compiler passes.

## Default Analyzers

The alpha registry includes:
The Public Preview registry includes:

- NestJS
- Express
Expand Down
Loading
Loading