project

Documentation

Overview

Package project provides utilities for finding and working with epack project roots.

This package is a Layer 0 utility that can be imported by any layer without creating dependency cycles. It provides the core logic for locating epack.yaml in the directory hierarchy.

Security

FindRoot uses os.Lstat to detect symlinks, preventing TOCTOU attacks where an attacker could create a symlink epack.yaml pointing to a malicious config.

Index

• Constants
• func FindRoot(dir string) (string, error)

Constants

const ConfigFileName = "epack.yaml"

ConfigFileName is the name of the epack configuration file.

Functions

func FindRoot

func FindRoot(dir string) (string, error)

FindRoot searches upward from dir for epack.yaml. Returns the directory containing epack.yaml, or error if not found.

Security: Uses os.Lstat to detect symlinks. Symlinked epack.yaml files are rejected to prevent TOCTOU attacks where an attacker could redirect the config file to a malicious location between discovery and load.