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

Watchers

Forks

Packages

 
 
 

Contributors