diff --git a/apps/oss/content/projects/ontoly/.provenance.json b/apps/oss/content/projects/ontoly/.provenance.json index a6c121f..15f1322 100644 --- a/apps/oss/content/projects/ontoly/.provenance.json +++ b/apps/oss/content/projects/ontoly/.provenance.json @@ -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 } diff --git a/apps/oss/content/projects/ontoly/assets/feature-comparison-table.svg b/apps/oss/content/projects/ontoly/assets/feature-comparison-table.svg index c1e73e5..9e207a8 100644 --- a/apps/oss/content/projects/ontoly/assets/feature-comparison-table.svg +++ b/apps/oss/content/projects/ontoly/assets/feature-comparison-table.svg @@ -3,7 +3,7 @@ Feature Comparison Surface -Ontoly Alpha +Ontoly Public Preview Non-goal Graph diff --git a/apps/oss/content/projects/ontoly/docs/agent-skills.mdx b/apps/oss/content/projects/ontoly/docs/agent-skills.mdx index 8d162e8..9dd362c 100644 --- a/apps/oss/content/projects/ontoly/docs/agent-skills.mdx +++ b/apps/oss/content/projects/ontoly/docs/agent-skills.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/architecture-reports.mdx b/apps/oss/content/projects/ontoly/docs/architecture-reports.mdx index b638470..123fa1a 100644 --- a/apps/oss/content/projects/ontoly/docs/architecture-reports.mdx +++ b/apps/oss/content/projects/ontoly/docs/architecture-reports.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/benchmark-methodology.mdx b/apps/oss/content/projects/ontoly/docs/benchmark-methodology.mdx index 0e84cd1..02af48c 100644 --- a/apps/oss/content/projects/ontoly/docs/benchmark-methodology.mdx +++ b/apps/oss/content/projects/ontoly/docs/benchmark-methodology.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/capabilities.mdx b/apps/oss/content/projects/ontoly/docs/capabilities.mdx index 5dd5c7e..10067dd 100644 --- a/apps/oss/content/projects/ontoly/docs/capabilities.mdx +++ b/apps/oss/content/projects/ontoly/docs/capabilities.mdx @@ -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"] --- @@ -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. @@ -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) diff --git a/apps/oss/content/projects/ontoly/docs/capability-api.mdx b/apps/oss/content/projects/ontoly/docs/capability-api.mdx index 1f11501..f2386b7 100644 --- a/apps/oss/content/projects/ontoly/docs/capability-api.mdx +++ b/apps/oss/content/projects/ontoly/docs/capability-api.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/capability-registry.mdx b/apps/oss/content/projects/ontoly/docs/capability-registry.mdx index 5f96cff..f1d2ed6 100644 --- a/apps/oss/content/projects/ontoly/docs/capability-registry.mdx +++ b/apps/oss/content/projects/ontoly/docs/capability-registry.mdx @@ -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"] --- @@ -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. diff --git a/apps/oss/content/projects/ontoly/docs/cli.mdx b/apps/oss/content/projects/ontoly/docs/cli.mdx index 37d33e5..da8e415 100644 --- a/apps/oss/content/projects/ontoly/docs/cli.mdx +++ b/apps/oss/content/projects/ontoly/docs/cli.mdx @@ -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"] --- @@ -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 @@ -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 diff --git a/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx b/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx index 45bc2d2..92beb67 100644 --- a/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx +++ b/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx @@ -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"] --- @@ -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 diff --git a/apps/oss/content/projects/ontoly/docs/compatibility.mdx b/apps/oss/content/projects/ontoly/docs/compatibility.mdx index 394e41b..15a59ad 100644 --- a/apps/oss/content/projects/ontoly/docs/compatibility.mdx +++ b/apps/oss/content/projects/ontoly/docs/compatibility.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/compiler-pipeline-v2.mdx b/apps/oss/content/projects/ontoly/docs/compiler-pipeline-v2.mdx index 2325d62..7722b5d 100644 --- a/apps/oss/content/projects/ontoly/docs/compiler-pipeline-v2.mdx +++ b/apps/oss/content/projects/ontoly/docs/compiler-pipeline-v2.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/concepts/compiler-pipeline.mdx b/apps/oss/content/projects/ontoly/docs/concepts/compiler-pipeline.mdx index bbdf051..8825012 100644 --- a/apps/oss/content/projects/ontoly/docs/concepts/compiler-pipeline.mdx +++ b/apps/oss/content/projects/ontoly/docs/concepts/compiler-pipeline.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/concepts/plugin-system.mdx b/apps/oss/content/projects/ontoly/docs/concepts/plugin-system.mdx index b868feb..40d1eae 100644 --- a/apps/oss/content/projects/ontoly/docs/concepts/plugin-system.mdx +++ b/apps/oss/content/projects/ontoly/docs/concepts/plugin-system.mdx @@ -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"] --- @@ -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: [ { diff --git a/apps/oss/content/projects/ontoly/docs/concepts/software-graph.mdx b/apps/oss/content/projects/ontoly/docs/concepts/software-graph.mdx index f89a76e..4fa7fa4 100644 --- a/apps/oss/content/projects/ontoly/docs/concepts/software-graph.mdx +++ b/apps/oss/content/projects/ontoly/docs/concepts/software-graph.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/confidence-model.mdx b/apps/oss/content/projects/ontoly/docs/confidence-model.mdx index 7a777d2..6c9c196 100644 --- a/apps/oss/content/projects/ontoly/docs/confidence-model.mdx +++ b/apps/oss/content/projects/ontoly/docs/confidence-model.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/configuration-graph.mdx b/apps/oss/content/projects/ontoly/docs/configuration-graph.mdx index e2b5b2d..4ce85fa 100644 --- a/apps/oss/content/projects/ontoly/docs/configuration-graph.mdx +++ b/apps/oss/content/projects/ontoly/docs/configuration-graph.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/contributing.mdx b/apps/oss/content/projects/ontoly/docs/contributing.mdx index 0b8b23a..f7d66ee 100644 --- a/apps/oss/content/projects/ontoly/docs/contributing.mdx +++ b/apps/oss/content/projects/ontoly/docs/contributing.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/enhancers.mdx b/apps/oss/content/projects/ontoly/docs/enhancers.mdx index faa5de7..af624fd 100644 --- a/apps/oss/content/projects/ontoly/docs/enhancers.mdx +++ b/apps/oss/content/projects/ontoly/docs/enhancers.mdx @@ -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"] --- @@ -114,6 +114,7 @@ Examples: - `SoftwareGraph` - `SemanticIndex` +- `Semantics` - `RepositorySummary` - `ArchitectureReport` - `HealthReport` @@ -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` | diff --git a/apps/oss/content/projects/ontoly/docs/errors.mdx b/apps/oss/content/projects/ontoly/docs/errors.mdx index eb4b856..5f86eeb 100644 --- a/apps/oss/content/projects/ontoly/docs/errors.mdx +++ b/apps/oss/content/projects/ontoly/docs/errors.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/evidence-model.mdx b/apps/oss/content/projects/ontoly/docs/evidence-model.mdx index b65eeba..f1627da 100644 --- a/apps/oss/content/projects/ontoly/docs/evidence-model.mdx +++ b/apps/oss/content/projects/ontoly/docs/evidence-model.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/examples.mdx b/apps/oss/content/projects/ontoly/docs/examples.mdx index 82853ce..80959c1 100644 --- a/apps/oss/content/projects/ontoly/docs/examples.mdx +++ b/apps/oss/content/projects/ontoly/docs/examples.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/faq.mdx b/apps/oss/content/projects/ontoly/docs/faq.mdx index 4d786aa..55eec55 100644 --- a/apps/oss/content/projects/ontoly/docs/faq.mdx +++ b/apps/oss/content/projects/ontoly/docs/faq.mdx @@ -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"] --- @@ -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? diff --git a/apps/oss/content/projects/ontoly/docs/feature-matrix.mdx b/apps/oss/content/projects/ontoly/docs/feature-matrix.mdx index 75dd970..47d4b29 100644 --- a/apps/oss/content/projects/ontoly/docs/feature-matrix.mdx +++ b/apps/oss/content/projects/ontoly/docs/feature-matrix.mdx @@ -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` | diff --git a/apps/oss/content/projects/ontoly/docs/framework-analyzer-api.mdx b/apps/oss/content/projects/ontoly/docs/framework-analyzer-api.mdx index daf6f43..5ff8570 100644 --- a/apps/oss/content/projects/ontoly/docs/framework-analyzer-api.mdx +++ b/apps/oss/content/projects/ontoly/docs/framework-analyzer-api.mdx @@ -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"] --- @@ -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 diff --git a/apps/oss/content/projects/ontoly/docs/framework-detection.mdx b/apps/oss/content/projects/ontoly/docs/framework-detection.mdx index 7584162..ccbe67a 100644 --- a/apps/oss/content/projects/ontoly/docs/framework-detection.mdx +++ b/apps/oss/content/projects/ontoly/docs/framework-detection.mdx @@ -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"] --- diff --git a/apps/oss/content/projects/ontoly/docs/framework-matrix.mdx b/apps/oss/content/projects/ontoly/docs/framework-matrix.mdx index 9c823f8..2d6aed7 100644 --- a/apps/oss/content/projects/ontoly/docs/framework-matrix.mdx +++ b/apps/oss/content/projects/ontoly/docs/framework-matrix.mdx @@ -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 | diff --git a/apps/oss/content/projects/ontoly/docs/framework-registry.mdx b/apps/oss/content/projects/ontoly/docs/framework-registry.mdx index bb53ee8..85527db 100644 --- a/apps/oss/content/projects/ontoly/docs/framework-registry.mdx +++ b/apps/oss/content/projects/ontoly/docs/framework-registry.mdx @@ -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"] --- @@ -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 diff --git a/apps/oss/content/projects/ontoly/docs/getting-started/build-a-graph.mdx b/apps/oss/content/projects/ontoly/docs/getting-started/build-a-graph.mdx index 162c62b..40a7827 100644 --- a/apps/oss/content/projects/ontoly/docs/getting-started/build-a-graph.mdx +++ b/apps/oss/content/projects/ontoly/docs/getting-started/build-a-graph.mdx @@ -2,7 +2,7 @@ title: "Build a Graph" description: "Compile a TypeScript repository into a deterministic Software Graph." order: 2 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/getting-started/build-a-graph" +canonical: "https://ontoly.sarwagya.wtf/docs/getting-started/build-a-graph" source: "docs/getting-started/build-a-graph.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Build", "Graph", "getting", "started"] --- @@ -17,7 +17,7 @@ query, validate, export, or expose it through MCP. Run: ```sh -ontoly build +ontoly build examples/basic ``` The compiler: @@ -29,7 +29,28 @@ The compiler: 5. builds indexes 6. writes graph artifacts -Artifacts are written to `.ontoly/`: +Artifacts are written to `ontoly-output/` by default: + +```text +SoftwareGraph.json +manifest.json +coverage.json +quality.json +semantic-model.json +reports/ +nodes/ +relationships/ +communities/ +html/ +``` + +For the compact cache-style artifact directory, pass `--output .ontoly`: + +```sh +ontoly build examples/basic --output .ontoly +``` + +That writes: ```text SoftwareGraph.json @@ -48,9 +69,10 @@ metadata so the graph hash is not invalidated by build time. ## Inspect ```sh -ontoly inspect AuthService -ontoly query find AuthService -ontoly coverage . +ontoly inspect UserService --root examples/basic +ontoly search UserService --root examples/basic +ontoly impact UserService --root examples/basic +ontoly coverage examples/basic ``` If something feels off: diff --git a/apps/oss/content/projects/ontoly/docs/getting-started/installation.mdx b/apps/oss/content/projects/ontoly/docs/getting-started/installation.mdx index f3c045a..d260716 100644 --- a/apps/oss/content/projects/ontoly/docs/getting-started/installation.mdx +++ b/apps/oss/content/projects/ontoly/docs/getting-started/installation.mdx @@ -2,7 +2,7 @@ title: "Installation" description: "Install Ontoly and initialize repository-local graph artifacts." order: 1 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/getting-started/installation" +canonical: "https://ontoly.sarwagya.wtf/docs/getting-started/installation" source: "docs/getting-started/installation.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Installation", "getting", "started"] --- @@ -20,12 +20,19 @@ Install the CLI as a development dependency: pnpm add -D @0xsarwagya/ontoly-cli ``` +Run commands through your package manager: + +```sh +pnpm exec ontoly --help +pnpm exec ontoly build . +``` + ## Initialize Initialize a repository: ```sh -ontoly init +pnpm exec ontoly init ``` This creates: @@ -53,6 +60,6 @@ Ontoly keeps generated graph artifacts local to the repository. ## Verify ```sh -ontoly --help -ontoly doctor . +pnpm exec ontoly --help +pnpm exec ontoly doctor . ``` diff --git a/apps/oss/content/projects/ontoly/docs/getting-started/mcp.mdx b/apps/oss/content/projects/ontoly/docs/getting-started/mcp.mdx index 517b170..5bbbcd3 100644 --- a/apps/oss/content/projects/ontoly/docs/getting-started/mcp.mdx +++ b/apps/oss/content/projects/ontoly/docs/getting-started/mcp.mdx @@ -2,7 +2,7 @@ title: "MCP" description: "Expose graph-backed capabilities to AI agents." order: 4 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/getting-started/mcp" +canonical: "https://ontoly.sarwagya.wtf/docs/getting-started/mcp" source: "docs/getting-started/mcp.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "getting", "started"] --- @@ -28,6 +28,6 @@ The MCP layer consumes the Software Graph. It does not rebuild repository context, search files, or use AI to infer relationships. When an LLM consumes MCP responses, use -[LLM Enhancement](/ontoly/docs/llm-enhancement). Non-LLM tools can call MCP +[LLM Enhancement](/docs/llm-enhancement). Non-LLM tools can call MCP directly, but LLM-facing answers must preserve graph evidence, confidence, and fallback boundaries. diff --git a/apps/oss/content/projects/ontoly/docs/getting-started/query-the-graph.mdx b/apps/oss/content/projects/ontoly/docs/getting-started/query-the-graph.mdx index 31bdebf..fe8a21a 100644 --- a/apps/oss/content/projects/ontoly/docs/getting-started/query-the-graph.mdx +++ b/apps/oss/content/projects/ontoly/docs/getting-started/query-the-graph.mdx @@ -1,12 +1,30 @@ --- title: "Query the Graph" -description: "Use Ontoly's deterministic query engine from TypeScript." +description: "Use Ontoly's deterministic CLI and query engine." order: 3 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/getting-started/query-the-graph" +canonical: "https://ontoly.sarwagya.wtf/docs/getting-started/query-the-graph" source: "docs/getting-started/query-the-graph.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Query", "Graph", "getting", "started"] --- +## CLI + +After building the included example, start with a symbol that exists in that +graph: + +```sh +ontoly build examples/basic +ontoly search UserService --root examples/basic +ontoly impact UserService --root examples/basic +ontoly evidence UserService --root examples/basic +``` + +`UserService` is used in first-run docs because it is present in +`examples/basic`; made-up placeholder terms are intentionally avoided because +they do not resolve to graph candidates. + +## TypeScript API + ```ts import { buildSoftwareGraph } from "@0xsarwagya/ontoly-compiler"; import { createQueryEngine } from "@0xsarwagya/ontoly-query"; diff --git a/apps/oss/content/projects/ontoly/docs/github-labels.mdx b/apps/oss/content/projects/ontoly/docs/github-labels.mdx index 9275c5f..0cab571 100644 --- a/apps/oss/content/projects/ontoly/docs/github-labels.mdx +++ b/apps/oss/content/projects/ontoly/docs/github-labels.mdx @@ -1,7 +1,7 @@ --- title: "GitHub Labels" description: "Recommended labels for the public repository:" -canonical: "https://oss.sarwagya.wtf/ontoly/docs/github-labels" +canonical: "https://ontoly.sarwagya.wtf/docs/github-labels" source: "docs/github-labels.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "GitHub", "Labels"] --- diff --git a/apps/oss/content/projects/ontoly/docs/graph.mdx b/apps/oss/content/projects/ontoly/docs/graph.mdx index 97aaf9f..9510e7c 100644 --- a/apps/oss/content/projects/ontoly/docs/graph.mdx +++ b/apps/oss/content/projects/ontoly/docs/graph.mdx @@ -1,7 +1,7 @@ --- title: "Software Graph" description: "The Software Graph is Ontoly's source of truth." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/graph" +canonical: "https://ontoly.sarwagya.wtf/docs/graph" source: "docs/graph.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Software", "Graph"] --- diff --git a/apps/oss/content/projects/ontoly/docs/guides/read-artifacts.mdx b/apps/oss/content/projects/ontoly/docs/guides/read-artifacts.mdx index 63e3e02..17309ae 100644 --- a/apps/oss/content/projects/ontoly/docs/guides/read-artifacts.mdx +++ b/apps/oss/content/projects/ontoly/docs/guides/read-artifacts.mdx @@ -2,7 +2,7 @@ title: "Read Artifacts" description: "Inspect the graph files generated under .ontoly." order: 1 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/guides/read-artifacts" +canonical: "https://ontoly.sarwagya.wtf/docs/guides/read-artifacts" source: "docs/guides/read-artifacts.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Read", "Artifacts", "guides"] --- diff --git a/apps/oss/content/projects/ontoly/docs/implementation-planning.mdx b/apps/oss/content/projects/ontoly/docs/implementation-planning.mdx index c9f8b2a..bf24db0 100644 --- a/apps/oss/content/projects/ontoly/docs/implementation-planning.mdx +++ b/apps/oss/content/projects/ontoly/docs/implementation-planning.mdx @@ -2,7 +2,7 @@ title: "Implementation Planning" description: "Graph-backed implementation planning without AI reasoning." order: 27 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/implementation-planning" +canonical: "https://ontoly.sarwagya.wtf/docs/implementation-planning" source: "docs/implementation-planning.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Implementation", "Planning"] --- diff --git a/apps/oss/content/projects/ontoly/docs/index.mdx b/apps/oss/content/projects/ontoly/docs/index.mdx index ddbdfb4..2a40546 100644 --- a/apps/oss/content/projects/ontoly/docs/index.mdx +++ b/apps/oss/content/projects/ontoly/docs/index.mdx @@ -2,7 +2,7 @@ title: "Introduction" description: "What Ontoly builds, what it refuses to be, and where to start." order: 1 -canonical: "https://oss.sarwagya.wtf/ontoly/docs" +canonical: "https://ontoly.sarwagya.wtf/docs" source: "docs/index.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Introduction", "index"] --- @@ -22,41 +22,42 @@ builds indexes, and persists a graph that other tools can consume. ## Where to start -- [Installation](/ontoly/docs/getting-started/installation) - add the package and initialize a repository. -- [Build your first graph](/ontoly/docs/getting-started/build-a-graph) - run the compiler and inspect artifacts. -- [Query the graph](/ontoly/docs/getting-started/query-the-graph) - use the deterministic query engine. -- [Semantic Index](/ontoly/docs/semantic-index) - resolve natural software concepts to graph entities without AI. -- [Software Graph](/ontoly/docs/concepts/software-graph) - understand the node and relationship model. -- [Capabilities](/ontoly/docs/capabilities) - deterministic software-engineering answers over the graph. -- [Capability API](/ontoly/docs/capability-api) - call the high-level capability engine from code, CLI, or MCP. -- [Enhancers](/ontoly/docs/enhancers) - build deterministic artifacts above the immutable Software Graph. -- [Evidence Model](/ontoly/docs/evidence-model) - understand how answers cite graph facts. -- [Confidence Model](/ontoly/docs/confidence-model) - see how confidence is derived from graph evidence. -- [LLM Enhancement](/ontoly/docs/llm-enhancement) - mandatory workflow rules when an LLM uses Ontoly. -- [TypeScript Semantic Model](/ontoly/docs/typescript-semantic-model) - inspect the pure language model. -- [Framework Analyzer API](/ontoly/docs/framework-analyzer-api) - add deterministic framework analyzers. -- [Semantic Generator](/ontoly/docs/semantic-generator) - understand how semantic facts become graph artifacts. -- [Plugin system](/ontoly/docs/concepts/plugin-system) - extend Ontoly without changing the compiler. -- [Semantic Coverage](/ontoly/docs/semantic-coverage) - measure graph completeness, confidence, and trustworthiness. -- [Semantic Evaluation Harness](/ontoly/docs/semantic-evaluation-harness) - gate releases on deterministic software-understanding questions. -- [Validation Lab](/ontoly/docs/validation-lab) - continuously measure correctness, determinism, performance, and regression resistance. -- [Agent Skills](/ontoly/docs/agent-skills) - install workflow-only skills that teach agents to use Ontoly first. -- [Skills Overview](/ontoly/docs/skills-overview) - browse the official skill and capability matrix. -- [Agent Skills Catalog](/ontoly/docs/skills) - browse public docs pages for every installable Ontoly Skill. -- [Skills Validation](/ontoly/docs/skills-validation) - validate skill structure, references, examples, and agent behavior. -- [FAQ](/ontoly/docs/faq) - common first-time user questions. -- [Troubleshooting](/ontoly/docs/troubleshooting) - actionable fixes for common failures. -- [Contributing](/ontoly/docs/contributing) - project workflow and release-gate expectations. -- [NestJS Support](/ontoly/docs/nestjs-support) - inspect framework-specific graph semantics. +- [Installation](/docs/getting-started/installation) - add the package and initialize a repository. +- [Build your first graph](/docs/getting-started/build-a-graph) - run the compiler and inspect artifacts. +- [Query the graph](/docs/getting-started/query-the-graph) - use the deterministic query engine. +- [Semantic Index](/docs/semantic-index) - resolve natural software concepts to graph entities without AI. +- [Semantic Intelligence](/docs/semantic-intelligence) - derive feature ownership, intent vocabulary, neighborhoods, and concept graphs. +- [Software Graph](/docs/concepts/software-graph) - understand the node and relationship model. +- [Capabilities](/docs/capabilities) - deterministic software-engineering answers over the graph. +- [Capability API](/docs/capability-api) - call the high-level capability engine from code, CLI, or MCP. +- [Enhancers](/docs/enhancers) - build deterministic artifacts above the immutable Software Graph. +- [Evidence Model](/docs/evidence-model) - understand how answers cite graph facts. +- [Confidence Model](/docs/confidence-model) - see how confidence is derived from graph evidence. +- [LLM Enhancement](/docs/llm-enhancement) - mandatory workflow rules when an LLM uses Ontoly. +- [TypeScript Semantic Model](/docs/typescript-semantic-model) - inspect the pure language model. +- [Framework Analyzer API](/docs/framework-analyzer-api) - add deterministic framework analyzers. +- [Semantic Generator](/docs/semantic-generator) - understand how semantic facts become graph artifacts. +- [Plugin system](/docs/concepts/plugin-system) - extend Ontoly without changing the compiler. +- [Semantic Coverage](/docs/semantic-coverage) - measure graph completeness, confidence, and trustworthiness. +- [Semantic Evaluation Harness](/docs/semantic-evaluation-harness) - gate releases on deterministic software-understanding questions. +- [Validation Lab](/docs/validation-lab) - continuously measure correctness, determinism, performance, and regression resistance. +- [Agent Skills](/docs/agent-skills) - install workflow-only skills that teach agents to use Ontoly first. +- [Skills Overview](/docs/skills-overview) - browse the official skill and capability matrix. +- [Agent Skills Catalog](/docs/skills) - browse public docs pages for every installable Ontoly Skill. +- [Skills Validation](/docs/skills-validation) - validate skill structure, references, examples, and agent behavior. +- [FAQ](/docs/faq) - common first-time user questions. +- [Troubleshooting](/docs/troubleshooting) - actionable fixes for common failures. +- [Contributing](/docs/contributing) - project workflow and release-gate expectations. +- [NestJS Support](/docs/nestjs-support) - inspect framework-specific graph semantics. ## Release references -- [Alpha Release Notes](/ontoly/docs/release-notes-alpha) - what ships in v0.1.0-alpha.13. -- [Known Limitations](/ontoly/docs/known-limitations) - what the alpha intentionally does not cover. -- [Compatibility Matrix](/ontoly/docs/compatibility-matrix) - runtime, graph, skill, and MCP compatibility. -- [Feature Matrix](/ontoly/docs/feature-matrix) - supported, alpha, and non-goal surfaces. -- [Framework Matrix](/ontoly/docs/framework-matrix) - current framework validation status. -- [Version Matrix](/ontoly/docs/version-matrix) - package and spec versions. +- [Historical Alpha Release Notes](/docs/release-notes-alpha) - what shipped before the Public Preview freeze. +- [Known Limitations](/docs/known-limitations) - what the Public Preview intentionally does not cover. +- [Compatibility Matrix](/docs/compatibility-matrix) - runtime, graph, skill, and MCP compatibility. +- [Feature Matrix](/docs/feature-matrix) - supported, Public Preview, and non-goal surfaces. +- [Framework Matrix](/docs/framework-matrix) - current framework validation status. +- [Version Matrix](/docs/version-matrix) - package and spec versions. ## Boundaries @@ -71,6 +72,7 @@ reports. The compiler remains deterministic and AI-free. ## Status -Experimental. The initial TypeScript parser and graph schema are usable for -small projects, but the stable v1 graph contract must go through RFC before -the public API is frozen. +Public Preview. The TypeScript frontend, Software Graph, Query Engine, +MCP, Skills, validation lab, and benchmarks are in v1 freeze. Changes that +affect the graph contract, public APIs, packages, or skill compatibility still +require the RFC and release-gate process. diff --git a/apps/oss/content/projects/ontoly/docs/known-limitations.mdx b/apps/oss/content/projects/ontoly/docs/known-limitations.mdx index 6fd944b..3a07096 100644 --- a/apps/oss/content/projects/ontoly/docs/known-limitations.mdx +++ b/apps/oss/content/projects/ontoly/docs/known-limitations.mdx @@ -1,17 +1,17 @@ --- title: "Known Limitations" -description: "Ontoly v0.1.0-alpha.13 is intentionally conservative." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/known-limitations" +description: "Ontoly v0.1.0-alpha.19 is intentionally conservative." +canonical: "https://ontoly.sarwagya.wtf/docs/known-limitations" source: "docs/known-limitations.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Known", "Limitations"] --- -Ontoly v0.1.0-alpha.13 is intentionally conservative. +Ontoly v0.1.0-alpha.19 is intentionally conservative. ## Language Support - TypeScript is the primary supported language. -- OpenAPI support is present as an alpha frontend. +- OpenAPI support is present as a Public Preview frontend. - Prisma, GraphQL, SQL, and cross-language relationships remain roadmap work. ## Framework Support diff --git a/apps/oss/content/projects/ontoly/docs/llm-enhancement.mdx b/apps/oss/content/projects/ontoly/docs/llm-enhancement.mdx index d3dcb53..a5b35e4 100644 --- a/apps/oss/content/projects/ontoly/docs/llm-enhancement.mdx +++ b/apps/oss/content/projects/ontoly/docs/llm-enhancement.mdx @@ -1,7 +1,7 @@ --- title: "LLM Enhancement" description: "Mandatory rules for using Ontoly from LLM-capable agents, MCP clients, and Agent Skills." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/llm-enhancement" +canonical: "https://ontoly.sarwagya.wtf/docs/llm-enhancement" source: "docs/llm-enhancement.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "LLM", "Enhancement"] --- diff --git a/apps/oss/content/projects/ontoly/docs/mcp.mdx b/apps/oss/content/projects/ontoly/docs/mcp.mdx index 4392814..915affe 100644 --- a/apps/oss/content/projects/ontoly/docs/mcp.mdx +++ b/apps/oss/content/projects/ontoly/docs/mcp.mdx @@ -1,7 +1,7 @@ --- title: "MCP" description: "Ontoly MCP exposes deterministic capabilities backed by the Query Engine." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/mcp" +canonical: "https://ontoly.sarwagya.wtf/docs/mcp" source: "docs/mcp.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools"] --- @@ -42,6 +42,12 @@ const response = runtime.execute({ - `FindEntrypoints` - `FindConfiguration` - `GraphStatistics` +- `SearchConcept` +- `ResolveIntent` +- `IntentExpansion` +- `FeatureOwnership` +- `SemanticNeighborhood` +- `SemanticContext` Each capability declares a name, version, description, input schema, output schema, and examples. diff --git a/apps/oss/content/projects/ontoly/docs/migration-notes.mdx b/apps/oss/content/projects/ontoly/docs/migration-notes.mdx index 3903506..9897fc6 100644 --- a/apps/oss/content/projects/ontoly/docs/migration-notes.mdx +++ b/apps/oss/content/projects/ontoly/docs/migration-notes.mdx @@ -1,14 +1,54 @@ --- title: "Migration Notes" -description: "This is the first public alpha, so there is no previous public API to migrate from." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/migration-notes" +description: "Projects upgrading from 0.1.0-alpha.18 do not need a Software Graph schema migration." +canonical: "https://ontoly.sarwagya.wtf/docs/migration-notes" source: "docs/migration-notes.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Migration", "Notes"] --- +## 0.1.0-alpha.19 + +Projects upgrading from `0.1.0-alpha.18` do not need a Software Graph schema +migration. + +Recommended upgrade steps: + +1. Upgrade Ontoly packages together to `0.1.0-alpha.19`. +2. Rebuild the repository graph. +3. Run `ontoly semantics build .` to create the derived Semantics artifact. +4. Run `ontoly semantics validate --ci`. +5. Reinstall Agent Skills so installed artifacts match the alpha.19 source. + +## 0.1.0-alpha.18 + +Projects upgrading from `0.1.0-alpha.17` do not need a Software Graph schema +migration. + +Recommended upgrade steps: + +1. Upgrade Ontoly packages together to `0.1.0-alpha.18`. +2. Rebuild the repository graph. +3. Reinstall Agent Skills so installed artifacts match the alpha.18 source. +4. Rerun semantic evaluation, skills validation, and release gates for your + repository. + +## 0.1.0-alpha.16 + +This is the first Public Preview. Projects upgrading from +`0.1.0-alpha.14` do not need a Software Graph schema migration. + +Recommended upgrade steps: + +1. Upgrade Ontoly packages together to `0.1.0-alpha.16`. +2. Rebuild the repository graph. +3. Rerun semantic evaluation, skills validation, and release gates for your + repository. +4. Reinstall Agent Skills so installed artifacts match the Public Preview source. + ## 0.1.0-alpha.1 -This is the first public alpha, so there is no previous public API to migrate from. +This was the first public alpha, so there was no previous public API to migrate +from. ## Internal Alpha Changes diff --git a/apps/oss/content/projects/ontoly/docs/migration-semantic-platform.mdx b/apps/oss/content/projects/ontoly/docs/migration-semantic-platform.mdx index 53c78db..da0d0a5 100644 --- a/apps/oss/content/projects/ontoly/docs/migration-semantic-platform.mdx +++ b/apps/oss/content/projects/ontoly/docs/migration-semantic-platform.mdx @@ -1,7 +1,7 @@ --- title: "Semantic Platform Migration" description: "The migration path from frontend-owned framework extraction to Ontoly's TypeScript Semantic Model and Semantic Generator." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/migration-semantic-platform" +canonical: "https://ontoly.sarwagya.wtf/docs/migration-semantic-platform" source: "docs/migration-semantic-platform.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Platform", "Migration"] --- @@ -9,7 +9,7 @@ keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", " Ontoly separates language analysis, framework analysis, and graph generation. Earlier alpha builds had the TypeScript frontend emit compiler symbols and -contain framework extraction rules. Current alpha builds use the frontend as an +contain framework extraction rules. Current Public Preview builds use the frontend as an adapter around the TypeScript Semantic Model and the Semantic Generator. ## New Packages diff --git a/apps/oss/content/projects/ontoly/docs/nestjs-support.mdx b/apps/oss/content/projects/ontoly/docs/nestjs-support.mdx index 7dcd0cf..74c7e1a 100644 --- a/apps/oss/content/projects/ontoly/docs/nestjs-support.mdx +++ b/apps/oss/content/projects/ontoly/docs/nestjs-support.mdx @@ -1,7 +1,7 @@ --- title: "NestJS Support" description: "Ontoly's NestJS support now lives in the framework analyzer layer." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/nestjs-support" +canonical: "https://ontoly.sarwagya.wtf/docs/nestjs-support" source: "docs/nestjs-support.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "NestJS", "Support"] --- diff --git a/apps/oss/content/projects/ontoly/docs/openapi-frontend.mdx b/apps/oss/content/projects/ontoly/docs/openapi-frontend.mdx index a67b0de..9eef761 100644 --- a/apps/oss/content/projects/ontoly/docs/openapi-frontend.mdx +++ b/apps/oss/content/projects/ontoly/docs/openapi-frontend.mdx @@ -1,7 +1,7 @@ --- title: "OpenAPI Frontend" description: "The OpenAPI frontend begins Ontoly's non-TypeScript parser surface." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/openapi-frontend" +canonical: "https://ontoly.sarwagya.wtf/docs/openapi-frontend" source: "docs/openapi-frontend.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "OpenAPI", "Frontend"] --- diff --git a/apps/oss/content/projects/ontoly/docs/query-engine.mdx b/apps/oss/content/projects/ontoly/docs/query-engine.mdx index 8564579..1ed2f05 100644 --- a/apps/oss/content/projects/ontoly/docs/query-engine.mdx +++ b/apps/oss/content/projects/ontoly/docs/query-engine.mdx @@ -1,7 +1,7 @@ --- title: "Query Engine" description: "The query engine operates only on SoftwareGraph." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/query-engine" +canonical: "https://ontoly.sarwagya.wtf/docs/query-engine" source: "docs/query-engine.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Query", "Engine"] --- diff --git a/apps/oss/content/projects/ontoly/docs/question-corpus.mdx b/apps/oss/content/projects/ontoly/docs/question-corpus.mdx index 47fef6d..b8fe96a 100644 --- a/apps/oss/content/projects/ontoly/docs/question-corpus.mdx +++ b/apps/oss/content/projects/ontoly/docs/question-corpus.mdx @@ -2,7 +2,7 @@ title: "Question Corpus" description: "Deterministic semantic questions used to evaluate capability quality." order: 28 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/question-corpus" +canonical: "https://ontoly.sarwagya.wtf/docs/question-corpus" source: "docs/question-corpus.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Question", "Corpus"] --- diff --git a/apps/oss/content/projects/ontoly/docs/reference/cli.mdx b/apps/oss/content/projects/ontoly/docs/reference/cli.mdx index e8fa0ac..cae3a03 100644 --- a/apps/oss/content/projects/ontoly/docs/reference/cli.mdx +++ b/apps/oss/content/projects/ontoly/docs/reference/cli.mdx @@ -2,7 +2,7 @@ title: "CLI" description: "Ontoly command reference." order: 1 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/reference/cli" +canonical: "https://ontoly.sarwagya.wtf/docs/reference/cli" source: "docs/reference/cli.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "CLI", "reference"] --- diff --git a/apps/oss/content/projects/ontoly/docs/reference/schema.mdx b/apps/oss/content/projects/ontoly/docs/reference/schema.mdx index e382f30..c6b6417 100644 --- a/apps/oss/content/projects/ontoly/docs/reference/schema.mdx +++ b/apps/oss/content/projects/ontoly/docs/reference/schema.mdx @@ -2,7 +2,7 @@ title: "Schema" description: "The top-level Software Graph shape." order: 2 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/reference/schema" +canonical: "https://ontoly.sarwagya.wtf/docs/reference/schema" source: "docs/reference/schema.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Schema", "reference"] --- diff --git a/apps/oss/content/projects/ontoly/docs/release-notes-alpha.mdx b/apps/oss/content/projects/ontoly/docs/release-notes-alpha.mdx index 3e35100..01e70cb 100644 --- a/apps/oss/content/projects/ontoly/docs/release-notes-alpha.mdx +++ b/apps/oss/content/projects/ontoly/docs/release-notes-alpha.mdx @@ -1,11 +1,98 @@ --- title: "Alpha Release Notes" -description: "This stabilization release fixes the real-world agent workflow bugs discovered against Ovok Core and the validation corpus." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/release-notes-alpha" +description: "This Semantic Intelligence release turns the trusted Software Graph into richer deterministic derived intelligence without changing the compiler or graph schema." +canonical: "https://ontoly.sarwagya.wtf/docs/release-notes-alpha" source: "docs/release-notes-alpha.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Alpha", "Release", "Notes"] --- +## v0.1.0-alpha.19 + +This Semantic Intelligence release turns the trusted Software Graph into richer +deterministic derived intelligence without changing the compiler or graph +schema. + +- Added the official `semantics` enhancer, published as + `@0xsarwagya/ontoly-enhancer-semantics`. +- Added `@0xsarwagya/ontoly-intelligence` for deterministic query expansion, + evidence, feature ownership, and semantic neighborhoods over graph artifacts. +- Added `ontoly semantics build`, `ontoly semantics inspect`, and + `ontoly semantics validate`. +- Added MCP capabilities `SemanticNeighborhood`, `FeatureOwnership`, + `IntentExpansion`, and `SemanticContext`. +- The generated `semantics.json` includes a Graphify-style `semanticGraph` + with concept nodes and links for feature, vocabulary, intent, and software + node relationships. +- Software Graph hash, graph schema, compiler behavior, CALLS generation, and + framework analyzers remain unchanged. +- Agent Skills now require Ontoly `0.1.0-alpha.19`. + +## v0.1.0-alpha.18 + +This NestJS semantic-resolution release completes deterministic method-level +impact analysis for common NestJS runtime paths while preserving the Software +Graph schema. + +- TypeScript symbol resolution now backs method-level `CALLS` edges for + `this.*`, `super.*`, local method, and injected-service method calls. +- NestJS runtime topology now models BullMQ processors, cron handlers, event + handlers, websocket gateways, repository injection, queue injection, and model + injection with existing graph node and relationship types. +- A synthetic NestJS runtime-topology corpus records deterministic expected + questions for processor, service, repository, queue, model, and handler flows. +- Fresh Ovok graph validation produced 21,686 nodes, 52,548 edges, and 5,823 + `CALLS` edges. +- The Ovok 40-question benchmark passed at 40 PASS, 0 PARTIAL, 0 FAIL, and + 39 Top-1 results. +- Agent Skills now require Ontoly `0.1.0-alpha.18`. + +## v0.1.0-alpha.17 + +This engineering-excellence release keeps alpha.16 behavior intact while +cleaning private CLI source and publishing the measured alpha.17 audit report. + +- Removed unused private CLI plumbing with no public API changes. +- Added `reports/alpha17-engineering-excellence.md` with runtime/docs LOC, + public export counts, package dependency graph, complexity observations, and + validation evidence. +- Preserved the Ovok 40-question benchmark at 40 PASS, 0 PARTIAL, 0 FAIL, and + 38 Top-1 results. +- Agent Skills now require Ontoly `0.1.0-alpha.17`. + +## v0.1.0-alpha.16 + +This retrieval stabilization release restores the alpha.14 Ovok benchmark +quality line while keeping the alpha.15 enhancer fixes. + +- Action-oriented code queries now include a bounded executable-action ranking + signal, so methods/functions can outrank owner classes when the user asks what + code calculates, builds, resolves, writes, or performs a similar action. +- The regression query `What code calculates sleep duration averages for + thresholds?` now ranks `calculateSleepDurationAverages` first. +- The Ovok 40-question Ontoly benchmark is now at 40 PASS, 0 PARTIAL, 0 FAIL, + and 38 Top-1 results. +- Agent Skills now require Ontoly `0.1.0-alpha.16`. + +## v0.1.0-alpha.14 + +This stabilization release fixes retrieval quality, bounded evidence, and +capability latency issues discovered during real-world Ovok Core evaluation. + +- Natural-language seed resolution now favors repository-local feature owners + and penalizes expanded-term false positives, so `sleep duration thresholds` + resolves to threshold services/methods instead of observation helpers or + external FHIR package symbols. +- Evidence Packs remain compact and ranked through serialization, include + scoped diagnostics, and avoid unrelated repository-wide warnings lowering + confidence. +- Semantic Index artifacts are versioned at `1.0.1`; stale or incompatible + indexes are rebuilt and persisted automatically. +- CLI capability commands now reuse the loaded Semantic Index instead of + rebuilding it for each `impact`, `evidence`, or `implementation-plan` call. +- The agent workflow regression corpus now covers sleep thresholds, batch-data + observations, authentication, JWT, signals, FHIR, and PlanDefinition queries. +- Agent Skills now require Ontoly `0.1.0-alpha.14`. + ## v0.1.0-alpha.13 This stabilization release fixes the real-world agent workflow bugs discovered @@ -133,7 +220,7 @@ This CLI release adds interactive Software Graph HTML export. ## v0.1.0-alpha.1 -This release candidate prepares Ontoly for its first public alpha. +This public preview prepares Ontoly for its first public alpha. ## What Works @@ -144,7 +231,7 @@ This release candidate prepares Ontoly for its first public alpha. - Install Ontoly Agent Skills as self-contained folders. - Run validation, semantic evaluation, package checks, docs checks, and release gates. -## What Changed in the RC Pass +## What Changed in the Public Preview Pass - Skill installation no longer depends on a sibling `skills/shared` folder after install. - Installed skill artifacts are validated in CI. diff --git a/apps/oss/content/projects/ontoly/docs/repository-intelligence.mdx b/apps/oss/content/projects/ontoly/docs/repository-intelligence.mdx index 06a2802..f88c350 100644 --- a/apps/oss/content/projects/ontoly/docs/repository-intelligence.mdx +++ b/apps/oss/content/projects/ontoly/docs/repository-intelligence.mdx @@ -1,7 +1,7 @@ --- title: "Repository Intelligence" description: "Repository intelligence is implemented as a compiler pass:" -canonical: "https://oss.sarwagya.wtf/ontoly/docs/repository-intelligence" +canonical: "https://ontoly.sarwagya.wtf/docs/repository-intelligence" source: "docs/repository-intelligence.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Repository", "Intelligence"] --- diff --git a/apps/oss/content/projects/ontoly/docs/security.mdx b/apps/oss/content/projects/ontoly/docs/security.mdx index ed8bd78..b138cfd 100644 --- a/apps/oss/content/projects/ontoly/docs/security.mdx +++ b/apps/oss/content/projects/ontoly/docs/security.mdx @@ -2,7 +2,7 @@ title: "Security" description: "What Ontoly does and does not protect." order: 99 -canonical: "https://oss.sarwagya.wtf/ontoly/docs/security" +canonical: "https://ontoly.sarwagya.wtf/docs/security" source: "docs/security.mdx" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Security"] --- diff --git a/apps/oss/content/projects/ontoly/docs/semantic-coverage.mdx b/apps/oss/content/projects/ontoly/docs/semantic-coverage.mdx index bde7f70..7a7d4dd 100644 --- a/apps/oss/content/projects/ontoly/docs/semantic-coverage.mdx +++ b/apps/oss/content/projects/ontoly/docs/semantic-coverage.mdx @@ -1,7 +1,7 @@ --- title: "Semantic Coverage" description: "Semantic Coverage measures how trustworthy a Software Graph is." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/semantic-coverage" +canonical: "https://ontoly.sarwagya.wtf/docs/semantic-coverage" source: "docs/semantic-coverage.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Coverage"] --- diff --git a/apps/oss/content/projects/ontoly/docs/semantic-evaluation-harness.mdx b/apps/oss/content/projects/ontoly/docs/semantic-evaluation-harness.mdx index b89e3a2..2460f7d 100644 --- a/apps/oss/content/projects/ontoly/docs/semantic-evaluation-harness.mdx +++ b/apps/oss/content/projects/ontoly/docs/semantic-evaluation-harness.mdx @@ -1,7 +1,7 @@ --- title: "Semantic Evaluation Harness" description: "The Semantic Evaluation Harness measures whether a system answers software understanding questions correctly." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/semantic-evaluation-harness" +canonical: "https://ontoly.sarwagya.wtf/docs/semantic-evaluation-harness" source: "docs/semantic-evaluation-harness.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Evaluation", "Harness"] --- diff --git a/apps/oss/content/projects/ontoly/docs/semantic-generator.mdx b/apps/oss/content/projects/ontoly/docs/semantic-generator.mdx index 29d6d49..4bd2390 100644 --- a/apps/oss/content/projects/ontoly/docs/semantic-generator.mdx +++ b/apps/oss/content/projects/ontoly/docs/semantic-generator.mdx @@ -1,7 +1,7 @@ --- title: "Semantic Generator" description: "The Semantic Generator converts language semantics and framework semantic facts into compiler symbols and relationships." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/semantic-generator" +canonical: "https://ontoly.sarwagya.wtf/docs/semantic-generator" source: "docs/semantic-generator.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Generator"] --- diff --git a/apps/oss/content/projects/ontoly/docs/semantic-index.mdx b/apps/oss/content/projects/ontoly/docs/semantic-index.mdx index 847d0fe..fde2dae 100644 --- a/apps/oss/content/projects/ontoly/docs/semantic-index.mdx +++ b/apps/oss/content/projects/ontoly/docs/semantic-index.mdx @@ -1,7 +1,7 @@ --- title: "Semantic Index" description: "The Semantic Index maps natural software concepts to deterministic Software Graph entities." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/semantic-index" +canonical: "https://ontoly.sarwagya.wtf/docs/semantic-index" source: "docs/semantic-index.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Index"] --- diff --git a/apps/oss/content/projects/ontoly/docs/semantic-intelligence.mdx b/apps/oss/content/projects/ontoly/docs/semantic-intelligence.mdx new file mode 100644 index 0000000..cc0e2aa --- /dev/null +++ b/apps/oss/content/projects/ontoly/docs/semantic-intelligence.mdx @@ -0,0 +1,62 @@ +--- +title: "Semantic Intelligence" +description: "Semantic Intelligence is Ontoly's deterministic layer above the immutable Software Graph." +canonical: "https://ontoly.sarwagya.wtf/docs/semantic-intelligence" +source: "docs/semantic-intelligence.md" +keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Intelligence"] +--- + +Semantic Intelligence is Ontoly's deterministic layer above the immutable Software Graph. + +It does not change compiler behavior, graph schema, CALLS generation, framework analyzers, or retrieval ranking unless a caller explicitly consumes the derived artifacts. + +## Artifacts + +`ontoly semantics build` writes: + +```text +.ontoly/enhancers/artifacts/semantics.json +``` + +The artifact contains: + +- feature ownership +- domain vocabulary +- intent vocabulary +- semantic neighborhoods for graph nodes +- deterministic confidence +- a Graphify-style `semanticGraph` with concept nodes and links + +The Software Graph remains the source of truth. Deleting `semantics.json` and rerunning `ontoly semantics build` produces the same derived artifact for the same graph and semantic index. + +## CLI + +```bash +ontoly semantics build . +ontoly semantics inspect +ontoly semantics inspect "sleep duration thresholds" --json +ontoly semantics validate --ci +``` + +## MCP Capabilities + +Semantic Intelligence adds deterministic MCP capabilities: + +- `SemanticNeighborhood` +- `FeatureOwnership` +- `IntentExpansion` +- `SemanticContext` + +These capabilities use the graph-derived Semantics artifact. They do not call LLMs, generate embeddings, or use vector search. + +## Packages + +- `@0xsarwagya/ontoly-enhancer-semantics` +- `@0xsarwagya/ontoly-intelligence` + +## Invariants + +- Semantics is a derived artifact. +- Enhancers never mutate `SoftwareGraph.json`. +- The semantic graph is a concept graph, not a replacement Software Graph. +- Confidence is derived from syntax, semantic index evidence, feature grouping, and graph relationships. diff --git a/apps/oss/content/projects/ontoly/docs/semantic-relationships.mdx b/apps/oss/content/projects/ontoly/docs/semantic-relationships.mdx index 7255b03..1f5e54c 100644 --- a/apps/oss/content/projects/ontoly/docs/semantic-relationships.mdx +++ b/apps/oss/content/projects/ontoly/docs/semantic-relationships.mdx @@ -1,7 +1,7 @@ --- title: "Semantic Relationships" description: "Deterministic relationship extraction rules for calls, dependencies, configuration usage, routes, providers, and framework semantics." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/semantic-relationships" +canonical: "https://ontoly.sarwagya.wtf/docs/semantic-relationships" source: "docs/semantic-relationships.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Relationships"] --- diff --git a/apps/oss/content/projects/ontoly/docs/skills-best-practices.mdx b/apps/oss/content/projects/ontoly/docs/skills-best-practices.mdx index 5772acc..d703926 100644 --- a/apps/oss/content/projects/ontoly/docs/skills-best-practices.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills-best-practices.mdx @@ -1,7 +1,7 @@ --- title: "Skills Best Practices" description: "Keep skills small and procedural." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills-best-practices" +canonical: "https://ontoly.sarwagya.wtf/docs/skills-best-practices" source: "docs/skills-best-practices.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Skills", "Best", "Practices"] --- diff --git a/apps/oss/content/projects/ontoly/docs/skills-development.mdx b/apps/oss/content/projects/ontoly/docs/skills-development.mdx index aa3d97d..b727820 100644 --- a/apps/oss/content/projects/ontoly/docs/skills-development.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills-development.mdx @@ -1,7 +1,7 @@ --- title: "Skills Development" description: "Create, version, document, and validate Ontoly Agent Skills that remain self-contained after installation." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills-development" +canonical: "https://ontoly.sarwagya.wtf/docs/skills-development" source: "docs/skills-development.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Skills", "Development"] --- @@ -30,11 +30,11 @@ name must match the directory. Every skill `README.md` should link back to the canonical public docs with absolute URLs so installed skills stay self-contained: -- `https://oss.sarwagya.wtf/ontoly/docs/agent-skills` -- `https://oss.sarwagya.wtf/ontoly/docs/skills-overview` -- `https://oss.sarwagya.wtf/ontoly/docs/mcp` -- `https://oss.sarwagya.wtf/ontoly/docs/capabilities` -- `https://oss.sarwagya.wtf/ontoly/docs/skills-validation` +- `https://ontoly.sarwagya.wtf/docs/agent-skills` +- `https://ontoly.sarwagya.wtf/docs/skills-overview` +- `https://ontoly.sarwagya.wtf/docs/mcp` +- `https://ontoly.sarwagya.wtf/docs/capabilities` +- `https://ontoly.sarwagya.wtf/docs/skills-validation` ## Metadata @@ -42,8 +42,8 @@ Use Ontoly metadata keys: ```yaml metadata: - ontoly.skill.version: "0.1.0-alpha.13" - ontoly.min.version: "0.1.0-alpha.13" + ontoly.skill.version: "0.1.0-alpha.19" + ontoly.min.version: "0.1.0-alpha.19" ontoly.capabilities: "ExplainArchitecture, GraphStatistics" ontoly.category: "architecture" ontoly.enhancement: "LLM Enhancement" diff --git a/apps/oss/content/projects/ontoly/docs/skills-overview.mdx b/apps/oss/content/projects/ontoly/docs/skills-overview.mdx index 76446fa..ce4bd5d 100644 --- a/apps/oss/content/projects/ontoly/docs/skills-overview.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills-overview.mdx @@ -1,7 +1,7 @@ --- title: "Skills Overview" description: "Browse the official Ontoly Agent Skills, source directories, install commands, capability mappings, and related docs." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills-overview" +canonical: "https://ontoly.sarwagya.wtf/docs/skills-overview" source: "docs/skills-overview.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Skills", "Overview"] --- @@ -23,26 +23,26 @@ references that preserve evidence, confidence, and fallback rules. - [LLM Enhancement](./llm-enhancement) - mandatory rules for LLM-facing Ontoly use. - [Skills Development](./skills-development) - how to add or change a skill. - [Skills Validation](./skills-validation) - source and installed-artifact validation. -- [Agent Skills Catalog](https://oss.sarwagya.wtf/ontoly/docs/skills) - public installable skill pages. +- [Agent Skills Catalog](https://ontoly.sarwagya.wtf/docs/skills) - public installable skill pages. ## Official Skills | Skill | Category | Enhancement | Source | Install | | --- | --- | --- | --- | --- | -| Architecture Review | architecture | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/architecture-review) | `npx skills add 0xsarwagya/ontoly --skill architecture-review` | -| Impact Analysis | change-analysis | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/impact-analysis) | `npx skills add 0xsarwagya/ontoly --skill impact-analysis` | -| Codebase Onboarding | onboarding | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/codebase-onboarding) | `npx skills add 0xsarwagya/ontoly --skill codebase-onboarding` | -| Request Tracing | request-flow | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/request-tracing) | `npx skills add 0xsarwagya/ontoly --skill request-tracing` | -| Dependency Analysis | dependencies | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/dependency-analysis) | `npx skills add 0xsarwagya/ontoly --skill dependency-analysis` | -| Security Review | security | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/security-review) | `npx skills add 0xsarwagya/ontoly --skill security-review` | -| Configuration Analysis | configuration | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/configuration-analysis) | `npx skills add 0xsarwagya/ontoly --skill configuration-analysis` | -| Framework Analysis | frameworks | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/framework-analysis) | `npx skills add 0xsarwagya/ontoly --skill framework-analysis` | -| Documentation | documentation | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/documentation) | `npx skills add 0xsarwagya/ontoly --skill documentation` | -| Refactoring | refactoring | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/refactoring) | `npx skills add 0xsarwagya/ontoly --skill refactoring` | -| Performance Analysis | performance | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/performance-analysis) | `npx skills add 0xsarwagya/ontoly --skill performance-analysis` | -| Dead Code Analysis | static-analysis | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/dead-code-analysis) | `npx skills add 0xsarwagya/ontoly --skill dead-code-analysis` | -| Migration Analysis | migration | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/migration-analysis) | `npx skills add 0xsarwagya/ontoly --skill migration-analysis` | -| SDK Generation | sdk-planning | LLM Enhancement | [Docs](https://oss.sarwagya.wtf/ontoly/docs/skills/sdk-generation) | `npx skills add 0xsarwagya/ontoly --skill sdk-generation` | +| Architecture Review | architecture | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/architecture-review) | `npx skills add 0xsarwagya/ontoly --skill architecture-review` | +| Impact Analysis | change-analysis | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/impact-analysis) | `npx skills add 0xsarwagya/ontoly --skill impact-analysis` | +| Codebase Onboarding | onboarding | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/codebase-onboarding) | `npx skills add 0xsarwagya/ontoly --skill codebase-onboarding` | +| Request Tracing | request-flow | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/request-tracing) | `npx skills add 0xsarwagya/ontoly --skill request-tracing` | +| Dependency Analysis | dependencies | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/dependency-analysis) | `npx skills add 0xsarwagya/ontoly --skill dependency-analysis` | +| Security Review | security | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/security-review) | `npx skills add 0xsarwagya/ontoly --skill security-review` | +| Configuration Analysis | configuration | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/configuration-analysis) | `npx skills add 0xsarwagya/ontoly --skill configuration-analysis` | +| Framework Analysis | frameworks | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/framework-analysis) | `npx skills add 0xsarwagya/ontoly --skill framework-analysis` | +| Documentation | documentation | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/documentation) | `npx skills add 0xsarwagya/ontoly --skill documentation` | +| Refactoring | refactoring | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/refactoring) | `npx skills add 0xsarwagya/ontoly --skill refactoring` | +| Performance Analysis | performance | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/performance-analysis) | `npx skills add 0xsarwagya/ontoly --skill performance-analysis` | +| Dead Code Analysis | static-analysis | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/dead-code-analysis) | `npx skills add 0xsarwagya/ontoly --skill dead-code-analysis` | +| Migration Analysis | migration | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/migration-analysis) | `npx skills add 0xsarwagya/ontoly --skill migration-analysis` | +| SDK Generation | sdk-planning | LLM Enhancement | [Docs](https://ontoly.sarwagya.wtf/docs/skills/sdk-generation) | `npx skills add 0xsarwagya/ontoly --skill sdk-generation` | ## Release Assets diff --git a/apps/oss/content/projects/ontoly/docs/skills-validation.mdx b/apps/oss/content/projects/ontoly/docs/skills-validation.mdx index 54794f0..af961de 100644 --- a/apps/oss/content/projects/ontoly/docs/skills-validation.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills-validation.mdx @@ -1,7 +1,7 @@ --- title: "Skills Validation" description: "Validate Ontoly Agent Skill metadata, references, templates, examples, installed artifacts, and release-gate behavior." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills-validation" +canonical: "https://ontoly.sarwagya.wtf/docs/skills-validation" source: "docs/skills-validation.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Skills", "Validation"] --- diff --git a/apps/oss/content/projects/ontoly/docs/skills/architecture-review.mdx b/apps/oss/content/projects/ontoly/docs/skills/architecture-review.mdx index bab1e71..96a331b 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/architecture-review.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/architecture-review.mdx @@ -1,7 +1,7 @@ --- title: "Architecture Review Skill" description: "Review repository architecture using Ontoly Software Graph and MCP capabilities. Use when asked to explain architecture, module boundaries, package topology, service ownership, or architectural risk." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/architecture-review" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/architecture-review" source: "skills/architecture-review/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Architecture", "Review", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill architecture-review ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `architecture` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/codebase-onboarding.mdx b/apps/oss/content/projects/ontoly/docs/skills/codebase-onboarding.mdx index 9935b74..9e08865 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/codebase-onboarding.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/codebase-onboarding.mdx @@ -1,7 +1,7 @@ --- title: "Codebase Onboarding Skill" description: "Onboard a developer to a repository using Ontoly graph summaries. Use when asked to explain a new codebase, identify entrypoints, map packages, or suggest first files to inspect." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/codebase-onboarding" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/codebase-onboarding" source: "skills/codebase-onboarding/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Codebase", "Onboarding", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill codebase-onboarding ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `onboarding` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/configuration-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/configuration-analysis.mdx index 6f51e84..18f97fb 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/configuration-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/configuration-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Configuration Analysis Skill" description: "Audit configuration and environment variable usage through Ontoly configuration capabilities. Use when asked where env vars, build config, runtime config, or feature flags are read." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/configuration-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/configuration-analysis" source: "skills/configuration-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Configuration", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill configuration-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `configuration` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/dead-code-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/dead-code-analysis.mdx index c7c506f..1fd33f6 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/dead-code-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/dead-code-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Dead Code Analysis Skill" description: "Find potentially unused functions, methods, services, routes, or features using Ontoly dead-code and entrypoint capabilities. Use when asked what code appears unreachable or safe to remove." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/dead-code-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/dead-code-analysis" source: "skills/dead-code-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Dead", "Code", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill dead-code-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `static-analysis` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/dependency-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/dependency-analysis.mdx index c6bf975..b956e6a 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/dependency-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/dependency-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Dependency Analysis Skill" description: "Analyze internal and package dependencies using Ontoly graph traversal. Use when asked which modules, packages, services, or files depend on each other." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/dependency-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/dependency-analysis" source: "skills/dependency-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Dependency", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill dependency-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `dependencies` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/documentation.mdx b/apps/oss/content/projects/ontoly/docs/skills/documentation.mdx index 5233230..8c2d411 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/documentation.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/documentation.mdx @@ -1,7 +1,7 @@ --- title: "Documentation Skill" description: "Draft graph-backed documentation from Ontoly summaries and traces. Use when asked to document architecture, APIs, modules, packages, or request lifecycles without re-parsing source files." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/documentation" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/documentation" source: "skills/documentation/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Documentation", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill documentation ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `documentation` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/framework-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/framework-analysis.mdx index cb7eb3b..5653eaa 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/framework-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/framework-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Framework Analysis Skill" description: "Explain detected frameworks and framework-specific graph coverage using Ontoly framework reports. Use when asked whether a repository uses NestJS, Next.js, React, Turborepo, or other supported framework concepts." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/framework-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/framework-analysis" source: "skills/framework-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Framework", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill framework-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `frameworks` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/impact-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/impact-analysis.mdx index fe029c5..8c279ff 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/impact-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/impact-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Impact Analysis Skill" description: "Analyze change impact using Ontoly dependency and dependent traversal. Use when asked what breaks if a symbol, service, route, package, or repository node changes or is removed." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/impact-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/impact-analysis" source: "skills/impact-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Impact", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill impact-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `change-analysis` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/index.mdx b/apps/oss/content/projects/ontoly/docs/skills/index.mdx index af4424a..2dd3b49 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/index.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/index.mdx @@ -1,7 +1,7 @@ --- title: "Agent Skills Catalog" description: "Installable Ontoly Agent Skills with capability mappings and documentation links." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills" +canonical: "https://ontoly.sarwagya.wtf/docs/skills" source: "skills/website-assets/skill-catalog.json" keywords: ["Ontoly", "Agent Skills", "MCP", "Software Graph", "AI coding agents"] --- @@ -13,20 +13,20 @@ Each skill teaches workflow only; Ontoly provides software understanding through | Skill | Category | Enhancement | Version | Capabilities | | --- | --- | --- | --- | --- | -| [Architecture Review](./architecture-review) | architecture | LLM Enhancement | 0.1.0-alpha.13 | `ExplainArchitecture`, `GraphStatistics`, `FindCycles`, `FindDependencies`, `EvidencePack` | -| [Impact Analysis](./impact-analysis) | change-analysis | LLM Enhancement | 0.1.0-alpha.13 | `ImpactAnalysis`, `FindDependents`, `FindDependencies`, `FindNode`, `EvidencePack` | -| [Codebase Onboarding](./codebase-onboarding) | onboarding | LLM Enhancement | 0.1.0-alpha.13 | `ExplainArchitecture`, `FindEntrypoints`, `GraphStatistics`, `FindFeatureOwner`, `EvidencePack` | -| [Request Tracing](./request-tracing) | request-flow | LLM Enhancement | 0.1.0-alpha.13 | `TraceRequestLifecycle`, `FindResponsibleFunction`, `TraceExecution`, `FindNode`, `EvidencePack` | -| [Dependency Analysis](./dependency-analysis) | dependencies | LLM Enhancement | 0.1.0-alpha.13 | `FindDependencies`, `FindDependents`, `FindCycles`, `GraphStatistics`, `EvidencePack` | -| [Security Review](./security-review) | security | LLM Enhancement | 0.1.0-alpha.13 | `FindAuthenticationFlow`, `FindResponsibleFunction`, `TraceRequestLifecycle`, `FindConfigurationUsage`, `EvidencePack` | -| [Configuration Analysis](./configuration-analysis) | configuration | LLM Enhancement | 0.1.0-alpha.13 | `FindConfiguration`, `FindConfigurationUsage`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | -| [Framework Analysis](./framework-analysis) | frameworks | LLM Enhancement | 0.1.0-alpha.13 | `ExplainArchitecture`, `GraphStatistics`, `FindNode`, `FindFeatureOwner`, `EvidencePack` | -| [Documentation](./documentation) | documentation | LLM Enhancement | 0.1.0-alpha.13 | `ExplainArchitecture`, `TraceRequestLifecycle`, `InspectModule`, `GraphStatistics`, `EvidencePack` | -| [Refactoring](./refactoring) | refactoring | LLM Enhancement | 0.1.0-alpha.13 | `ImpactAnalysis`, `FindDependencies`, `FindDependents`, `FindCycles`, `EvidencePack` | -| [Performance Analysis](./performance-analysis) | performance | LLM Enhancement | 0.1.0-alpha.13 | `TraceExecution`, `TraceRequestLifecycle`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | -| [Dead Code Analysis](./dead-code-analysis) | static-analysis | LLM Enhancement | 0.1.0-alpha.13 | `FindDeadCode`, `FindUnusedFeature`, `FindEntrypoints`, `FindDependents`, `EvidencePack` | -| [Migration Analysis](./migration-analysis) | migration | LLM Enhancement | 0.1.0-alpha.13 | `ExplainArchitecture`, `ImpactAnalysis`, `FindConfigurationUsage`, `FindDependencies`, `EvidencePack` | -| [SDK Generation](./sdk-generation) | sdk-planning | LLM Enhancement | 0.1.0-alpha.13 | `ExplainArchitecture`, `TraceRequestLifecycle`, `FindResponsibleFunction`, `GraphStatistics`, `EvidencePack` | +| [Architecture Review](./architecture-review) | architecture | LLM Enhancement | 0.1.0-alpha.19 | `ExplainArchitecture`, `GraphStatistics`, `FindCycles`, `FindDependencies`, `EvidencePack` | +| [Impact Analysis](./impact-analysis) | change-analysis | LLM Enhancement | 0.1.0-alpha.19 | `ImpactAnalysis`, `FindDependents`, `FindDependencies`, `FindNode`, `EvidencePack` | +| [Codebase Onboarding](./codebase-onboarding) | onboarding | LLM Enhancement | 0.1.0-alpha.19 | `ExplainArchitecture`, `FindEntrypoints`, `GraphStatistics`, `FindFeatureOwner`, `EvidencePack` | +| [Request Tracing](./request-tracing) | request-flow | LLM Enhancement | 0.1.0-alpha.19 | `TraceRequestLifecycle`, `FindResponsibleFunction`, `TraceExecution`, `FindNode`, `EvidencePack` | +| [Dependency Analysis](./dependency-analysis) | dependencies | LLM Enhancement | 0.1.0-alpha.19 | `FindDependencies`, `FindDependents`, `FindCycles`, `GraphStatistics`, `EvidencePack` | +| [Security Review](./security-review) | security | LLM Enhancement | 0.1.0-alpha.19 | `FindAuthenticationFlow`, `FindResponsibleFunction`, `TraceRequestLifecycle`, `FindConfigurationUsage`, `EvidencePack` | +| [Configuration Analysis](./configuration-analysis) | configuration | LLM Enhancement | 0.1.0-alpha.19 | `FindConfiguration`, `FindConfigurationUsage`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | +| [Framework Analysis](./framework-analysis) | frameworks | LLM Enhancement | 0.1.0-alpha.19 | `ExplainArchitecture`, `GraphStatistics`, `FindNode`, `FindFeatureOwner`, `EvidencePack` | +| [Documentation](./documentation) | documentation | LLM Enhancement | 0.1.0-alpha.19 | `ExplainArchitecture`, `TraceRequestLifecycle`, `InspectModule`, `GraphStatistics`, `EvidencePack` | +| [Refactoring](./refactoring) | refactoring | LLM Enhancement | 0.1.0-alpha.19 | `ImpactAnalysis`, `FindDependencies`, `FindDependents`, `FindCycles`, `EvidencePack` | +| [Performance Analysis](./performance-analysis) | performance | LLM Enhancement | 0.1.0-alpha.19 | `TraceExecution`, `TraceRequestLifecycle`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | +| [Dead Code Analysis](./dead-code-analysis) | static-analysis | LLM Enhancement | 0.1.0-alpha.19 | `FindDeadCode`, `FindUnusedFeature`, `FindEntrypoints`, `FindDependents`, `EvidencePack` | +| [Migration Analysis](./migration-analysis) | migration | LLM Enhancement | 0.1.0-alpha.19 | `ExplainArchitecture`, `ImpactAnalysis`, `FindConfigurationUsage`, `FindDependencies`, `EvidencePack` | +| [SDK Generation](./sdk-generation) | sdk-planning | LLM Enhancement | 0.1.0-alpha.19 | `ExplainArchitecture`, `TraceRequestLifecycle`, `FindResponsibleFunction`, `GraphStatistics`, `EvidencePack` | ## Shared Docs diff --git a/apps/oss/content/projects/ontoly/docs/skills/migration-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/migration-analysis.mdx index f352b4f..a61bc7a 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/migration-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/migration-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Migration Analysis Skill" description: "Plan migrations using Ontoly architecture, dependency, impact, and configuration evidence. Use when asked to migrate frameworks, packages, APIs, modules, or runtime configuration." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/migration-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/migration-analysis" source: "skills/migration-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Migration", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill migration-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `migration` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/performance-analysis.mdx b/apps/oss/content/projects/ontoly/docs/skills/performance-analysis.mdx index 6775f62..c210948 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/performance-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/performance-analysis.mdx @@ -1,7 +1,7 @@ --- title: "Performance Analysis Skill" description: "Investigate performance-sensitive architecture using Ontoly call, dependency, and graph statistics evidence. Use when asked about hot paths, expensive flows, or performance investigation starting points." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/performance-analysis" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/performance-analysis" source: "skills/performance-analysis/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Performance", "Analysis", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill performance-analysis ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `performance` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/refactoring.mdx b/apps/oss/content/projects/ontoly/docs/skills/refactoring.mdx index 78604f8..e853981 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/refactoring.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/refactoring.mdx @@ -1,7 +1,7 @@ --- title: "Refactoring Skill" description: "Plan refactors with Ontoly impact and dependency evidence. Use when asked to move, rename, split, extract, or remove code while preserving behavior." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/refactoring" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/refactoring" source: "skills/refactoring/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Refactoring", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill refactoring ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `refactoring` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/request-tracing.mdx b/apps/oss/content/projects/ontoly/docs/skills/request-tracing.mdx index da0f9ad..22a49d4 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/request-tracing.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/request-tracing.mdx @@ -1,7 +1,7 @@ --- title: "Request Tracing Skill" description: "Trace request lifecycle behavior through Ontoly route, handler, and call graph capabilities. Use when asked to trace login, API, controller, route, or request execution flow." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/request-tracing" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/request-tracing" source: "skills/request-tracing/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Request", "Tracing", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill request-tracing ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `request-flow` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/sdk-generation.mdx b/apps/oss/content/projects/ontoly/docs/skills/sdk-generation.mdx index e68c467..b95d0e2 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/sdk-generation.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/sdk-generation.mdx @@ -1,7 +1,7 @@ --- title: "SDK Generation Skill" description: "Plan SDK generation from Ontoly API, route, model, and operation evidence. Use when asked to design or scope SDK generation without implementing code generation in the skill layer." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/sdk-generation" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/sdk-generation" source: "skills/sdk-generation/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "SDK", "Generation", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill sdk-generation ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `sdk-planning` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/skills/security-review.mdx b/apps/oss/content/projects/ontoly/docs/skills/security-review.mdx index 7866901..2b38179 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/security-review.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/security-review.mdx @@ -1,7 +1,7 @@ --- title: "Security Review Skill" description: "Review authentication, authorization, and security-sensitive flows using Ontoly graph evidence. Use when asked about auth ownership, protected routes, permissions, guards, or security risk." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/skills/security-review" +canonical: "https://ontoly.sarwagya.wtf/docs/skills/security-review" source: "skills/security-review/README.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Security", "Review", "Skill", "skills"] --- @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill security-review ## Compatibility -- Skill version: `0.1.0-alpha.13` -- Minimum Ontoly version: `0.1.0-alpha.13` +- Skill version: `0.1.0-alpha.19` +- Minimum Ontoly version: `0.1.0-alpha.19` - Category: `security` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/troubleshooting.mdx b/apps/oss/content/projects/ontoly/docs/troubleshooting.mdx index 57286d8..7adc65f 100644 --- a/apps/oss/content/projects/ontoly/docs/troubleshooting.mdx +++ b/apps/oss/content/projects/ontoly/docs/troubleshooting.mdx @@ -1,7 +1,7 @@ --- title: "Troubleshooting" description: "Fix common Ontoly CLI, graph build, MCP, validation, and Agent Skill issues with evidence-backed steps." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/troubleshooting" +canonical: "https://ontoly.sarwagya.wtf/docs/troubleshooting" source: "docs/troubleshooting.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Troubleshooting"] --- diff --git a/apps/oss/content/projects/ontoly/docs/typescript-semantic-model.mdx b/apps/oss/content/projects/ontoly/docs/typescript-semantic-model.mdx index 5bd2ee2..9696d27 100644 --- a/apps/oss/content/projects/ontoly/docs/typescript-semantic-model.mdx +++ b/apps/oss/content/projects/ontoly/docs/typescript-semantic-model.mdx @@ -1,7 +1,7 @@ --- title: "TypeScript Semantic Model" description: "The TypeScript Semantic Model is Ontoly's language layer." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/typescript-semantic-model" +canonical: "https://ontoly.sarwagya.wtf/docs/typescript-semantic-model" source: "docs/typescript-semantic-model.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Semantic", "Model"] --- diff --git a/apps/oss/content/projects/ontoly/docs/validation-lab.mdx b/apps/oss/content/projects/ontoly/docs/validation-lab.mdx index 9eaa6ca..c7458bd 100644 --- a/apps/oss/content/projects/ontoly/docs/validation-lab.mdx +++ b/apps/oss/content/projects/ontoly/docs/validation-lab.mdx @@ -1,7 +1,7 @@ --- title: "Validation Lab" description: "The Validation Lab is Ontoly's permanent release-gate infrastructure." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/validation-lab" +canonical: "https://ontoly.sarwagya.wtf/docs/validation-lab" source: "docs/validation-lab.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Validation", "Lab"] --- diff --git a/apps/oss/content/projects/ontoly/docs/version-matrix.mdx b/apps/oss/content/projects/ontoly/docs/version-matrix.mdx index 5c42610..28c3b95 100644 --- a/apps/oss/content/projects/ontoly/docs/version-matrix.mdx +++ b/apps/oss/content/projects/ontoly/docs/version-matrix.mdx @@ -1,25 +1,27 @@ --- title: "Version Matrix" description: "The Software Graph version is negotiated independently from Ontoly package versions." -canonical: "https://oss.sarwagya.wtf/ontoly/docs/version-matrix" +canonical: "https://ontoly.sarwagya.wtf/docs/version-matrix" source: "docs/version-matrix.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Version", "Matrix"] --- | Component | Version | | --------- | ------- | -| Ontoly core packages | 0.1.0-alpha.13 | -| Query Engine | 0.1.0-alpha.13 | -| TypeScript analyzer | 0.1.0-alpha.13 | -| TypeScript parser frontend | 0.1.0-alpha.13 | -| Semantic Index | exported by `@0xsarwagya/ontoly-core` 0.1.0-alpha.13 | -| Semantic Capability Engine | 0.1.0-alpha.13 | -| Enhancer API | 0.1.0-alpha.13 | -| MCP runtime | 0.1.0-alpha.13 | -| Ontoly CLI | 0.1.0-alpha.13 | -| HTML graph plugin | 0.1.0-alpha.13 | +| Ontoly core packages | 0.1.0-alpha.19 | +| Query Engine | 0.1.0-alpha.19 | +| TypeScript analyzer | 0.1.0-alpha.19 | +| TypeScript parser frontend | 0.1.0-alpha.19 | +| Semantic Index | exported by `@0xsarwagya/ontoly-core` 0.1.0-alpha.19 | +| Semantic Capability Engine | 0.1.0-alpha.19 | +| Enhancer API | 0.1.0-alpha.19 | +| Semantics Enhancer | 0.1.0-alpha.19 | +| Intelligence API | 0.1.0-alpha.19 | +| MCP runtime | 0.1.0-alpha.19 | +| Ontoly CLI | 0.1.0-alpha.19 | +| HTML graph plugin | 0.1.0-alpha.19 | | Software Graph Spec | 1.0 draft | -| Agent Skills | 0.1.0-alpha.13 | +| Agent Skills | 0.1.0-alpha.19 | | Node.js engine | 22+ | | pnpm engine | 11+ | | TypeScript | 5.9 | diff --git a/apps/oss/content/projects/ontoly/landing.mdx b/apps/oss/content/projects/ontoly/landing.mdx index e0f0613..902d5dc 100644 --- a/apps/oss/content/projects/ontoly/landing.mdx +++ b/apps/oss/content/projects/ontoly/landing.mdx @@ -1,11 +1,11 @@ --- title: "Ontoly - Deterministic Software Graphs" description: "Build deterministic Software Graphs from TypeScript repositories for MCP, AI agents, query tooling, validation, and architecture analysis." -canonical: "https://oss.sarwagya.wtf/ontoly" +canonical: "https://ontoly.sarwagya.wtf" keywords: ["Ontoly", "Software Graph", "TypeScript static analysis", "MCP", "AI coding agents", "Query Engine", "developer tools"] --- - + Turn a TypeScript repository into a deterministic Software Graph that every developer tool can share. @@ -19,7 +19,7 @@ versioned, and portable. -If the alpha package is not published yet, clone the repository and run: +If the Public Preview package is not published yet, clone the repository and run: ```sh git clone https://github.com/0xsarwagya/ontoly.git @@ -60,18 +60,18 @@ The Skill layer teaches workflow. MCP exposes structured capabilities. The graph itself is still produced by deterministic compiler infrastructure, not model output. -Browse the public [Agent Skills Catalog](/ontoly/docs/skills) for install +Browse the public [Agent Skills Catalog](/docs/skills) for install commands, capability mappings, and source references for every official Skill. -## Validation-first alpha +## Validation-first Public Preview Ontoly includes a validation lab, semantic evaluation harness, skill validator, package validator, documentation checker, benchmark runner, graph diff tooling, -and release readiness reports. Alpha readiness is based on evidence, not graph +and release readiness reports. Public Preview readiness is based on evidence, not graph size. diff --git a/apps/oss/content/projects/ontoly/manifest.json b/apps/oss/content/projects/ontoly/manifest.json index 0e7e030..8600ea2 100644 --- a/apps/oss/content/projects/ontoly/manifest.json +++ b/apps/oss/content/projects/ontoly/manifest.json @@ -4,18 +4,28 @@ "slug": "ontoly", "name": "Ontoly", "description": "TypeScript-native software intelligence engine that builds deterministic Software Graphs for MCP, AI agents, query tooling, validation, and architecture analysis.", - "status": "alpha", + "status": "public-preview", "license": "MIT", "packageName": "@0xsarwagya/ontoly-cli", "repository": "https://github.com/0xsarwagya/ontoly", - "homepage": "https://oss.sarwagya.wtf/ontoly", + "homepage": "https://ontoly.sarwagya.wtf", + "legacyUrls": [ + "https://oss.sarwagya.wtf/ontoly" + ], + "redirects": [ + { + "from": "https://oss.sarwagya.wtf/ontoly", + "to": "https://ontoly.sarwagya.wtf", + "status": 301 + } + ], "landing": "site/landing.mdx", "docs": "site/docs", "assets": "site/assets", "seo": { "title": "Ontoly - Deterministic Software Graphs", - "canonical": "https://oss.sarwagya.wtf/ontoly", - "image": "https://oss.sarwagya.wtf/ontoly/opengraph-image", + "canonical": "https://ontoly.sarwagya.wtf", + "image": "https://ontoly.sarwagya.wtf/opengraph-image", "keywords": [ "Ontoly", "Software Graph", @@ -30,8 +40,8 @@ }, "links": { "github": "https://github.com/0xsarwagya/ontoly", - "docs": "https://oss.sarwagya.wtf/ontoly/docs", - "skills": "https://oss.sarwagya.wtf/ontoly/docs/skills", + "docs": "https://ontoly.sarwagya.wtf/docs", + "skills": "https://ontoly.sarwagya.wtf/docs/skills", "npm": "https://www.npmjs.com/package/@0xsarwagya/ontoly-cli" } }