@0xsarwagya/ontoly-compiler

@0xsarwagya/ontoly-compiler

Responsibility

@0xsarwagya/ontoly-compiler owns repository discovery, compiler context, pipeline execution, graph construction, build-time validation hooks, and watch coordination. Language-specific frontends emit into compiler contracts; the compiler does not own CLI UX, MCP transport, or high-level capability workflows.

See the repository architecture map for package boundaries.

Installation

pnpm add @0xsarwagya/ontoly-compiler

API

• buildSoftwareGraph(options) compiles a repository to a Software Graph.
• Compiler context, passes, pipeline stages, graph builder, and validation hooks.
• Incremental graph and frontend-product snapshots with exact source invalidation.
• Per-stage progress, timing, and bounded deterministic task execution.
• JavaScript/TypeScript incremental-builder reuse for watch mode and resident runners.
• defaultCompilerPasses() for the standard deterministic pipeline.

Example

import { buildSoftwareGraphWithArtifacts } from "@0xsarwagya/ontoly-compiler";

const result = await buildSoftwareGraphWithArtifacts({
  root: process.cwd(),
  mode: "incremental",
  cache: true,
  workers: 8,
  onProgress: ({ stage, phase }) => console.log(stage, phase),
});

console.log(result.cache.hit, result.profile.durationMs);

Status

Stable v1.0.0 package. Public contracts are governed by the Software Graph specification and RFC process.

Links

• Repository
• Documentation
• Issues