@wcnegentropy/shared

Shared types, constants, and utilities for the Retro Vibecoder UPG ecosystem.

Installation

npm install @wcnegentropy/shared

Usage

// Import types
import type { UpgManifest, ValidationError } from '@wcnegentropy/shared';

// Import utilities
import { parseYaml, parseSeed } from '@wcnegentropy/shared';

// Import enrichment types
import type { ManifestEnrichment } from '@wcnegentropy/shared';

// Import constants
import { BINARY_EXTENSIONS, DEFAULT_OUTPUT_DIR } from '@wcnegentropy/shared';

Subpath Exports

This package provides granular subpath exports:

| Export Path | Description | | ------------------------------ | ---------------------------------------------- | | @wcnegentropy/shared | All types, constants, and utilities re-exported | | @wcnegentropy/shared/types | TypeScript types (manifest, registry, answers, sidecar) | | @wcnegentropy/shared/constants | Defaults, paths, and error codes | | @wcnegentropy/shared/utils | YAML parser, schema validator, path helpers, seed parser |

Types

import type { UpgManifest, ManifestEnrichment, RegistryEntry, SidecarConfig } from '@wcnegentropy/shared/types';

Constants

import { DEFAULT_OUTPUT_DIR, BINARY_EXTENSIONS } from '@wcnegentropy/shared/constants';

Utilities

import { parseYaml, validateSchema, parseSeed, resolveTemplatePath } from '@wcnegentropy/shared/utils';

Peer Usage

This package is primarily consumed as an internal dependency by other packages in the UPG ecosystem:

• @wcnegentropy/core
• @wcnegentropy/procedural
• @wcnegentropy/cli

Enrichment Types

The ManifestEnrichment type defines enrichment preferences for procedural generation manifests:

interface ManifestEnrichment {
  enabled?: boolean;
  depth?: 'minimal' | 'standard' | 'full';
  cicd?: boolean;
  release?: boolean;
  fillLogic?: boolean;
  tests?: boolean;
  dockerProd?: boolean;
  linting?: boolean;
  envFiles?: boolean;
  docs?: boolean;
}

This type is used in the UpgManifest.enrichment field to declare enrichment preferences for template-based generation.

Part of the Retro Vibecoder UPG Monorepo

This package is part of the Retro Vibecoder UPG monorepo — a Universal Procedural Generator that turns integers into software.

License

MIT — Copyright (c) 2026 WCNEGENTROPY HOLDINGS LLC. See LICENSE for details.