diff --git a/apps/oss/content/projects/ontoly/.provenance.json b/apps/oss/content/projects/ontoly/.provenance.json index dd22701..66f135f 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": "59d0fbe911c3c2ea07f4c719f7e3aeae71664344", - "version": "1.0.0-rc.3", - "publishedAt": "2026-07-15T13:58:03.301Z", + "sourceCommit": "177eefeb737c6c7cdb3f00032a4781b6d3af7e6d", + "version": "1.0.0-rc.5", + "publishedAt": "2026-07-17T19:33:47.148Z", "manifestSchemaVersion": 1 } diff --git a/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx b/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx index 8d6b436..3dda7d1 100644 --- a/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx +++ b/apps/oss/content/projects/ontoly/docs/compatibility-matrix.mdx @@ -8,7 +8,7 @@ keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", " | Surface | Version | Status | | ------- | ------- | ------ | -| Ontoly packages | 1.0.0-rc.3 | Release Candidate | +| Ontoly packages | 1.0.0-rc.5 | Release Candidate | | Node.js | 20+ | Supported | | pnpm | 10+ | Supported | | TypeScript | 5.9 | Supported | diff --git a/apps/oss/content/projects/ontoly/docs/in-memory-processing.mdx b/apps/oss/content/projects/ontoly/docs/in-memory-processing.mdx new file mode 100644 index 0000000..3a25f07 --- /dev/null +++ b/apps/oss/content/projects/ontoly/docs/in-memory-processing.mdx @@ -0,0 +1,72 @@ +--- +title: "In-Memory Source Processing" +description: "Ontoly can build a Software Graph from source held in memory, without a repository checked out on disk." +canonical: "https://oss.sarwagya.wtf/ontoly/docs/in-memory-processing" +source: "docs/in-memory-processing.md" +keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Memory", "Source", "Processing"] +--- + +Ontoly can build a Software Graph from source held in memory, without a +repository checked out on disk. This is useful for editor and language-server +integrations, serverless and browser hosts, content that is not yet saved, and +programmatic callers such as tests or embedding services. + +## Quick start + +```ts +import { buildSoftwareGraphFromMemory } from "@0xsarwagya/ontoly-compiler"; +import { defaultCompilerPasses } from "@0xsarwagya/ontoly-cli"; + +const result = await buildSoftwareGraphFromMemory({ + files: { + "package.json": JSON.stringify({ name: "demo" }), + "src/index.ts": "export const answer = 42;\n", + }, + passes: defaultCompilerPasses(), +}); + +console.log(result.status, result.graph?.nodes.length); +``` + +Keys are repository-relative POSIX paths; values are UTF-8 contents. Graph node +ids are always repository-relative, so the identity of the resulting graph does +not depend on where (or whether) the sources are materialized. + +## Strategies + +`buildSoftwareGraphFromMemory` accepts a `strategy`: + +| Strategy | Behavior | When to use | +| --- | --- | --- | +| `materialize` (default) | Writes the sources to a private scratch directory, runs the standard on-disk pipeline, then removes the directory. | Highest fidelity; reuses the exact filesystem-backed toolchain. | +| `zero-disk` | Serves sources from memory end to end. No provided source is written to disk. | Browser, serverless, or sandboxes where writing source is not possible. | + +```ts +const result = await buildSoftwareGraphFromMemory({ + files, + passes: defaultCompilerPasses(), + strategy: "zero-disk", +}); +``` + +The two strategies produce identical graph node identity for the same input. + +> **Note on `zero-disk`:** files provided in the source map never touch disk. +> TypeScript's default library declarations (`lib.*.d.ts`) may still be read +> from the installed compiler so that type resolution works. + +## Lower-level building blocks + +- `createInMemorySourceProvider(files)` returns the `SourceProvider` the + compiler reads through. Supply it directly via + `buildSoftwareGraph({ sourceProvider, passes })` for full control. +- `createInMemoryCompilerHost(root, sources, options)` (from + `@0xsarwagya/ontoly-typescript`) builds the in-memory `ts.CompilerHost` used + by the zero-disk TypeScript frontend. + +## Passes + +`buildSoftwareGraphFromMemory` is a low-level primitive and runs only the passes +you supply. Use `defaultCompilerPasses()` from `@0xsarwagya/ontoly-cli` for the +batteries-included set (repository intelligence, TypeScript frontend, OpenAPI +frontend). diff --git a/apps/oss/content/projects/ontoly/docs/known-limitations.mdx b/apps/oss/content/projects/ontoly/docs/known-limitations.mdx index 90283d9..ec94f93 100644 --- a/apps/oss/content/projects/ontoly/docs/known-limitations.mdx +++ b/apps/oss/content/projects/ontoly/docs/known-limitations.mdx @@ -1,12 +1,12 @@ --- title: "Known Limitations" -description: "Ontoly v1.0.0-rc.3 is intentionally conservative." +description: "Ontoly v1.0.0-rc.5 is intentionally conservative." canonical: "https://oss.sarwagya.wtf/ontoly/docs/known-limitations" source: "docs/known-limitations.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Known", "Limitations"] --- -Ontoly v1.0.0-rc.3 is intentionally conservative. +Ontoly v1.0.0-rc.5 is intentionally conservative. ## Language Support diff --git a/apps/oss/content/projects/ontoly/docs/migration-notes.mdx b/apps/oss/content/projects/ontoly/docs/migration-notes.mdx index a24d930..032d29b 100644 --- a/apps/oss/content/projects/ontoly/docs/migration-notes.mdx +++ b/apps/oss/content/projects/ontoly/docs/migration-notes.mdx @@ -1,11 +1,24 @@ --- title: "Migration Notes" -description: "Projects upgrading from 0.1.0-alpha.19 do not need a Software Graph schema migration." +description: "Projects upgrading from 1.0.0-rc.3 do not need a Software Graph schema migration." canonical: "https://oss.sarwagya.wtf/ontoly/docs/migration-notes" source: "docs/migration-notes.md" keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", "AI coding agents", "developer tools", "Migration", "Notes"] --- +## 1.0.0-rc.5 + +Projects upgrading from `1.0.0-rc.3` do not need a Software Graph schema +migration. This release is additive: it introduces in-memory source processing +(`buildSoftwareGraphFromMemory`, `SourceProvider`, `createInMemorySourceProvider`, +and `createInMemoryCompilerHost`) without changing existing on-disk behavior. + +Recommended upgrade steps: + +1. Upgrade Ontoly packages together to `1.0.0-rc.5`. +2. Rebuild the repository graph. +3. Reinstall Agent Skills so installed artifacts match the rc.5 source. + ## 1.0.0-rc.3 Projects upgrading from `0.1.0-alpha.19` do not need a Software Graph schema diff --git a/apps/oss/content/projects/ontoly/docs/skills-development.mdx b/apps/oss/content/projects/ontoly/docs/skills-development.mdx index 2712a27..af6afae 100644 --- a/apps/oss/content/projects/ontoly/docs/skills-development.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills-development.mdx @@ -42,8 +42,8 @@ Use Ontoly metadata keys: ```yaml metadata: - ontoly.skill.version: "1.0.0-rc.3" - ontoly.min.version: "1.0.0-rc.3" + ontoly.skill.version: "1.0.0-rc.5" + ontoly.min.version: "1.0.0-rc.5" ontoly.capabilities: "ExplainArchitecture, GraphStatistics" ontoly.category: "architecture" ontoly.enhancement: "LLM Enhancement" 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 7186856..79e751a 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/architecture-review.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/architecture-review.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill architecture-review ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 e628aaa..db99718 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/codebase-onboarding.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/codebase-onboarding.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill codebase-onboarding ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 f6fcbf9..b336192 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/configuration-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/configuration-analysis.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill configuration-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 b48c0c7..70e3a8e 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 @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill dead-code-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 31619e3..d30b376 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/dependency-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/dependency-analysis.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill dependency-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 37a1407..5de52ad 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/documentation.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/documentation.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill documentation ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 93157e4..0b09b12 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/framework-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/framework-analysis.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill framework-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 e358b20..187e23e 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/impact-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/impact-analysis.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill impact-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 e29b612..99c9a58 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/index.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/index.mdx @@ -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 | 1.0.0-rc.3 | `ExplainArchitecture`, `GraphStatistics`, `FindCycles`, `FindDependencies`, `EvidencePack` | -| [Impact Analysis](./impact-analysis) | change-analysis | LLM Enhancement | 1.0.0-rc.3 | `ImpactAnalysis`, `FindDependents`, `FindDependencies`, `FindNode`, `EvidencePack` | -| [Codebase Onboarding](./codebase-onboarding) | onboarding | LLM Enhancement | 1.0.0-rc.3 | `ExplainArchitecture`, `FindEntrypoints`, `GraphStatistics`, `FindFeatureOwner`, `EvidencePack` | -| [Request Tracing](./request-tracing) | request-flow | LLM Enhancement | 1.0.0-rc.3 | `TraceRequestLifecycle`, `FindResponsibleFunction`, `TraceExecution`, `FindNode`, `EvidencePack` | -| [Dependency Analysis](./dependency-analysis) | dependencies | LLM Enhancement | 1.0.0-rc.3 | `FindDependencies`, `FindDependents`, `FindCycles`, `GraphStatistics`, `EvidencePack` | -| [Security Review](./security-review) | security | LLM Enhancement | 1.0.0-rc.3 | `FindAuthenticationFlow`, `FindResponsibleFunction`, `TraceRequestLifecycle`, `FindConfigurationUsage`, `EvidencePack` | -| [Configuration Analysis](./configuration-analysis) | configuration | LLM Enhancement | 1.0.0-rc.3 | `FindConfiguration`, `FindConfigurationUsage`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | -| [Framework Analysis](./framework-analysis) | frameworks | LLM Enhancement | 1.0.0-rc.3 | `ExplainArchitecture`, `GraphStatistics`, `FindNode`, `FindFeatureOwner`, `EvidencePack` | -| [Documentation](./documentation) | documentation | LLM Enhancement | 1.0.0-rc.3 | `ExplainArchitecture`, `TraceRequestLifecycle`, `InspectModule`, `GraphStatistics`, `EvidencePack` | -| [Refactoring](./refactoring) | refactoring | LLM Enhancement | 1.0.0-rc.3 | `ImpactAnalysis`, `FindDependencies`, `FindDependents`, `FindCycles`, `EvidencePack` | -| [Performance Analysis](./performance-analysis) | performance | LLM Enhancement | 1.0.0-rc.3 | `TraceExecution`, `TraceRequestLifecycle`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | -| [Dead Code Analysis](./dead-code-analysis) | static-analysis | LLM Enhancement | 1.0.0-rc.3 | `FindDeadCode`, `FindUnusedFeature`, `FindEntrypoints`, `FindDependents`, `EvidencePack` | -| [Migration Analysis](./migration-analysis) | migration | LLM Enhancement | 1.0.0-rc.3 | `ExplainArchitecture`, `ImpactAnalysis`, `FindConfigurationUsage`, `FindDependencies`, `EvidencePack` | -| [SDK Generation](./sdk-generation) | sdk-planning | LLM Enhancement | 1.0.0-rc.3 | `ExplainArchitecture`, `TraceRequestLifecycle`, `FindResponsibleFunction`, `GraphStatistics`, `EvidencePack` | +| [Architecture Review](./architecture-review) | architecture | LLM Enhancement | 1.0.0-rc.5 | `ExplainArchitecture`, `GraphStatistics`, `FindCycles`, `FindDependencies`, `EvidencePack` | +| [Impact Analysis](./impact-analysis) | change-analysis | LLM Enhancement | 1.0.0-rc.5 | `ImpactAnalysis`, `FindDependents`, `FindDependencies`, `FindNode`, `EvidencePack` | +| [Codebase Onboarding](./codebase-onboarding) | onboarding | LLM Enhancement | 1.0.0-rc.5 | `ExplainArchitecture`, `FindEntrypoints`, `GraphStatistics`, `FindFeatureOwner`, `EvidencePack` | +| [Request Tracing](./request-tracing) | request-flow | LLM Enhancement | 1.0.0-rc.5 | `TraceRequestLifecycle`, `FindResponsibleFunction`, `TraceExecution`, `FindNode`, `EvidencePack` | +| [Dependency Analysis](./dependency-analysis) | dependencies | LLM Enhancement | 1.0.0-rc.5 | `FindDependencies`, `FindDependents`, `FindCycles`, `GraphStatistics`, `EvidencePack` | +| [Security Review](./security-review) | security | LLM Enhancement | 1.0.0-rc.5 | `FindAuthenticationFlow`, `FindResponsibleFunction`, `TraceRequestLifecycle`, `FindConfigurationUsage`, `EvidencePack` | +| [Configuration Analysis](./configuration-analysis) | configuration | LLM Enhancement | 1.0.0-rc.5 | `FindConfiguration`, `FindConfigurationUsage`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | +| [Framework Analysis](./framework-analysis) | frameworks | LLM Enhancement | 1.0.0-rc.5 | `ExplainArchitecture`, `GraphStatistics`, `FindNode`, `FindFeatureOwner`, `EvidencePack` | +| [Documentation](./documentation) | documentation | LLM Enhancement | 1.0.0-rc.5 | `ExplainArchitecture`, `TraceRequestLifecycle`, `InspectModule`, `GraphStatistics`, `EvidencePack` | +| [Refactoring](./refactoring) | refactoring | LLM Enhancement | 1.0.0-rc.5 | `ImpactAnalysis`, `FindDependencies`, `FindDependents`, `FindCycles`, `EvidencePack` | +| [Performance Analysis](./performance-analysis) | performance | LLM Enhancement | 1.0.0-rc.5 | `TraceExecution`, `TraceRequestLifecycle`, `FindDependencies`, `GraphStatistics`, `EvidencePack` | +| [Dead Code Analysis](./dead-code-analysis) | static-analysis | LLM Enhancement | 1.0.0-rc.5 | `FindDeadCode`, `FindUnusedFeature`, `FindEntrypoints`, `FindDependents`, `EvidencePack` | +| [Migration Analysis](./migration-analysis) | migration | LLM Enhancement | 1.0.0-rc.5 | `ExplainArchitecture`, `ImpactAnalysis`, `FindConfigurationUsage`, `FindDependencies`, `EvidencePack` | +| [SDK Generation](./sdk-generation) | sdk-planning | LLM Enhancement | 1.0.0-rc.5 | `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 4961d66..46b6b9b 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/migration-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/migration-analysis.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill migration-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 8964c67..84727c7 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/performance-analysis.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/performance-analysis.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill performance-analysis ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 7a533d9..1b16f22 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/refactoring.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/refactoring.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill refactoring ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 a1fde6a..dbcd761 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/request-tracing.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/request-tracing.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill request-tracing ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 f2ac668..2aef75b 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/sdk-generation.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/sdk-generation.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill sdk-generation ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - 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 5065612..2e6f55a 100644 --- a/apps/oss/content/projects/ontoly/docs/skills/security-review.mdx +++ b/apps/oss/content/projects/ontoly/docs/skills/security-review.mdx @@ -16,8 +16,8 @@ npx skills add 0xsarwagya/ontoly --skill security-review ## Compatibility -- Skill version: `1.0.0-rc.3` -- Minimum Ontoly version: `1.0.0-rc.3` +- Skill version: `1.0.0-rc.5` +- Minimum Ontoly version: `1.0.0-rc.5` - Category: `security` - Enhancement: `LLM Enhancement` - Deprecated: no diff --git a/apps/oss/content/projects/ontoly/docs/version-matrix.mdx b/apps/oss/content/projects/ontoly/docs/version-matrix.mdx index 43dae88..f5e510e 100644 --- a/apps/oss/content/projects/ontoly/docs/version-matrix.mdx +++ b/apps/oss/content/projects/ontoly/docs/version-matrix.mdx @@ -8,20 +8,20 @@ keywords: ["Ontoly", "Software Graph", "TypeScript", "static analysis", "MCP", " | Component | Version | | --------- | ------- | -| Ontoly core packages | 1.0.0-rc.3 | -| Query Engine | 1.0.0-rc.3 | -| TypeScript analyzer | 1.0.0-rc.3 | -| TypeScript parser frontend | 1.0.0-rc.3 | -| Semantic Index | exported by `@0xsarwagya/ontoly-core` 1.0.0-rc.3 | -| Semantic Capability Engine | 1.0.0-rc.3 | -| Enhancer API | 1.0.0-rc.3 | -| Semantics Enhancer | 1.0.0-rc.3 | -| Intelligence API | 1.0.0-rc.3 | -| MCP runtime | 1.0.0-rc.3 | -| Ontoly CLI | 1.0.0-rc.3 | -| HTML graph plugin | 1.0.0-rc.3 | +| Ontoly core packages | 1.0.0-rc.5 | +| Query Engine | 1.0.0-rc.5 | +| TypeScript analyzer | 1.0.0-rc.5 | +| TypeScript parser frontend | 1.0.0-rc.5 | +| Semantic Index | exported by `@0xsarwagya/ontoly-core` 1.0.0-rc.5 | +| Semantic Capability Engine | 1.0.0-rc.5 | +| Enhancer API | 1.0.0-rc.5 | +| Semantics Enhancer | 1.0.0-rc.5 | +| Intelligence API | 1.0.0-rc.5 | +| MCP runtime | 1.0.0-rc.5 | +| Ontoly CLI | 1.0.0-rc.5 | +| HTML graph plugin | 1.0.0-rc.5 | | Software Graph Spec | 1.0 draft | -| Agent Skills | 1.0.0-rc.3 | +| Agent Skills | 1.0.0-rc.5 | | Node.js engine | 20+ | | pnpm engine | 10+ | | TypeScript | 5.9 | diff --git a/apps/oss/content/projects/ontoly/landing.mdx b/apps/oss/content/projects/ontoly/landing.mdx index eabcc42..a9b4e20 100644 --- a/apps/oss/content/projects/ontoly/landing.mdx +++ b/apps/oss/content/projects/ontoly/landing.mdx @@ -1,57 +1,48 @@ --- -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" -keywords: ["Ontoly", "Software Graph", "TypeScript static analysis", "MCP", "AI coding agents", "Query Engine", "developer tools"] +title: "Ontoly — Now a Software Intelligence Ecosystem" +description: "Ontoly has grown from a single CLI into a full deterministic software-intelligence ecosystem — Software Graph, MCP, and 14 AI Agent Skills. Explore it at ontoly.sarwagya.wtf." +canonical: "https://ontoly.sarwagya.wtf" +keywords: ["Ontoly", "Software Graph", "TypeScript static analysis", "MCP", "AI agent skills", "Claude Code skills", "AI coding agents", "Query Engine", "developer tools"] --- -Turn a TypeScript repository into a deterministic Software Graph that every developer tool can share. +Ontoly has evolved into a full software intelligence ecosystem — with its own home at ontoly.sarwagya.wtf. +Ontoly started here as a deterministic Software Graph for TypeScript. It has +since grown into a complete ecosystem — 19 packages, an MCP server, 14 portable +Agent Skills, repository intelligence, and evidence packs — and now has a +dedicated home. + +> **Ontoly now lives at [ontoly.sarwagya.wtf](https://ontoly.sarwagya.wtf).** +> Explore the Software Graph, the AI Agent Skills, benchmarks, architecture, the +> roadmap, and the changelog on the dedicated site. This page remains part of +> the wider open-source ecosystem by [Sarwagya Singh](https://sarwagya.wtf). + Ontoly is a software intelligence engine. It builds a stable semantic graph of a repository so agents, MCP clients, documentation tools, SDK generators, architecture tools, and static analyzers can query one source of truth instead -of repeatedly searching files. - -Ontoly does not call language models. The graph is deterministic, explainable, -versioned, and portable. +of repeatedly searching files. Ontoly does not call language models — the graph +is deterministic, explainable, versioned, and portable. -Install the Release Candidate from npm or clone the repository and run: - -```sh -git clone https://github.com/0xsarwagya/ontoly.git -cd ontoly -corepack enable -pnpm install --frozen-lockfile -pnpm build -pnpm ontoly build examples/basic -``` +## Explore the ecosystem -## The pipeline +- **Dedicated site — [ontoly.sarwagya.wtf](https://ontoly.sarwagya.wtf)** +- **AI Agent Skills — [ontoly.sarwagya.wtf/skills](https://ontoly.sarwagya.wtf/skills)** (Claude Code, Cursor, Copilot) +- **Roadmap — [ontoly.sarwagya.wtf/roadmap](https://ontoly.sarwagya.wtf/roadmap)** +- **Changelog — [ontoly.sarwagya.wtf/changelog](https://ontoly.sarwagya.wtf/changelog)** -![Ontoly architecture](./assets/architecture-diagram.svg) +## What the ecosystem includes -```text -Repository - -> Compiler Frontends - -> Semantic Model - -> Software Graph - -> Query Engine - -> MCP, Skills, Docs, SDKs, IDEs, Analysis -``` - -## What it gives you - -- deterministic Software Graph JSON -- stable IDs for graph diffing and cache keys -- TypeScript semantic analysis -- graph-native diagnostics +- deterministic Software Graph JSON with stable IDs for diffing and cache keys +- TypeScript semantic analysis and graph-native diagnostics - query APIs for traversal, impact analysis, and dependency lookup -- MCP capabilities for AI coding agents -- portable Agent Skills that teach agents to use Ontoly first +- an MCP server that exposes structured capabilities to AI coding agents +- 14 portable Agent Skills that teach agents to use Ontoly first +- repository intelligence: ownership, history, hotspots, stability, cochanges +- evidence packs so every answer carries graph provenance - validation, semantic evaluation, benchmarks, and release gates ## Built for agents, not by agents @@ -60,15 +51,9 @@ 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](/docs/skills) for install -commands, capability mappings, and source references for every official Skill. - -## Validation-first Release Candidate - -Ontoly includes a validation lab, semantic evaluation harness, skill validator, -package validator, documentation checker, benchmark runner, graph diff tooling, -and release readiness reports. Release Candidate readiness is based on evidence, not graph -size. +Browse the public [Agent Skills Catalog](/docs/skills) for install commands, +capability mappings, and source references for every official Skill — or find +Ontoly on [skills.sh](https://www.skills.sh/?q=0xsarwagya/ontoly).