@beyondnet/evolith-core

@evolith/core

Shared business-logic facade for the Evolith platform. It is a thin re-export barrel over @evolith/core-domain, giving the Smart CLI, MCP Server and Core API a single, stable import surface.

Installation

npm install @evolith/core

Requires Node.js 20+. The only runtime dependency is @evolith/core-domain, which is the authoritative source for every re-exported symbol.

Supported import surface

Import everything from the root specifier only — there are no subpath exports:

import {
  EvaluateGateUseCase,
  ProposePhaseAdvanceUseCase,
  RulesetValidatorService,
  TopologyCatalogService,
  readGitLog,
} from '@evolith/core';

Deep imports such as @evolith/core/domain/interfaces are not supported. The package builds to a single dist/index.js; use the root barrel and import the named symbol you need.

What it re-exports

Category	Symbols (selection)
Domain ports (types)	IFileSystem, IConfigParser, ILogger, ICommandExecutor, …
Domain errors	EvolithError, PhaseTransitionError, ValidationError, isEvolithError, …
Gate evidence	createSuccessEnvelope, deriveVerdict, GATE_PHASES, GatePhase, GateEvidence, …
Domain services	WorkflowEngine, ToolSelectionService, PhaseService
Use-cases	EvaluateGateUseCase, ValidateSatelliteUseCase, ProposePhaseAdvanceUseCase, PhaseTransitionUseCase, InitializeProjectUseCase
Validators	RulesetValidatorService, PhaseGateValidatorService, ArchitectureDriftService, DeepArchitectureAnalyzer
Architecture	TopologyCatalogService, TopologyManifest
Metrics	readGitLog, isGitRepo

The authoritative source for each symbol lives in @evolith/core-domain; this package only adjusts the import ergonomics and version surface.

Runtime notes

• The single runtime dependency is @evolith/core-domain.
• Some re-exported services (e.g. TopologyCatalogService, the ruleset validators) read governance assets from a workspace root; consult the @evolith/core-domain README for the WORKSPACE_ROOT requirement.

Development

Build and test locally with npm run build / npm test. Contributions follow the repo-root CONTRIBUTING.md.

License

MIT