Semantic Platform Migration
The migration path from frontend-owned framework extraction to Ontoly's TypeScript Semantic Model and Semantic Generator.
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 Release Candidate builds use the frontend as an adapter around the TypeScript Semantic Model and the Semantic Generator.
New Packages
@0xsarwagya/ontoly-typescript: pure TypeScript Semantic Model.@0xsarwagya/ontoly-semantic: framework analyzers, registry, and Semantic Generator.
What Changed
The compiler flow changed from:
TypeScript frontend
|
v
Compiler symbols and framework relationshipsto:
TypeScript analyzer
|
v
TypeScript Semantic Model
|
v
Framework analyzers
|
v
Semantic Generator
|
v
Compiler symbols and relationshipsCompatibility
The generated Software Graph is intended to remain deterministic and functionally equivalent. Existing compiler and query consumers should continue to depend on the Software Graph, not parser internals.
Migrating Internal Consumers
Consumers that need TypeScript facts should import from:
import { analyze } from "@0xsarwagya/ontoly-typescript";Consumers that need framework facts should use:
import {
createDefaultFrameworkRegistry,
generateCompilerArtifacts,
} from "@0xsarwagya/ontoly-semantic";Consumers that need repository truth should still use the Software Graph.
Adding A Framework Analyzer
- Implement
FrameworkAnalyzer. - Consume only
TypeScriptProject. - Emit semantic facts.
- Register the analyzer.
- Add model, registry, generator, and graph snapshot tests.
- Document capabilities and compatibility.
No TypeScript analyzer or compiler core changes should be required for a new framework analyzer.