Skip to content

grekt-labs/engine

Repository files navigation

@grekt/engine

OpenSSF Scorecard Snyk Socket

Deterministic core logic for the grekt CLI. No I/O. No side effects. Fully injectable.

npm install @grekt/engine

What this is

The engine behind grekt extracted into a standalone package. Every operation that doesn't touch the filesystem or network lives here.

  • Schemas Zod validators for grekt.yaml, grekt.lock, artifact manifests, and every config format grekt uses
  • Artifact operations frontmatter parsing, integrity verification, lockfile management, directory scanning
  • Registry operations artifact resolution, download, publish, OCI distribution support
  • Sync operations plugin system, content generation, target templates
  • Security local scanning via AgentVerus
  • Utilities semver parsing/comparison, byte/token/number formatters, workspace support

Full API reference at developer.grekt.com.

Why it exists

grekt's CLI does I/O. This package does not. All file and network operations are injected through interfaces (FileSystem, HttpClient, EngineContext), which means:

  • Runs on Node, Bun, Deno, or edge runtimes
  • Test with mocks instead of real filesystems
  • Same inputs, same outputs, every time

Requirements

Node >= 18.0.0

Usage

import { parseProjectConfig, resolveArtifact, createLockfile } from "@grekt/engine"

Contributing

See CONTRIBUTING.md. Bug reports and feature requests welcome.

License

BSL 1.1 free for personal and commercial use. The only restriction: don't use this code to build a competing AI artifact manager. Each version converts to MIT after two years. Details in LICENSING.md.

About

Core engine powering grekt CLI and integrations.

Topics

Resources

License

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors