publish(ontoly): sync 177eefe

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
 }

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 |

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

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
 

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

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"

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

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

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

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

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

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

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

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

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
 

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

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

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

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

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

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

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 |