config

Documentation

Overview

Package config handles ecosystem config loading and remote resolution.

Remote resolution uses codeload.github.com tarballs (same mechanism as bizshuk/skills svc/plugin/fetch.go), which requires no authentication and has no rate-limiting issues unlike raw.githubusercontent.com.

Index

• func IsRemoteRef(path string) bool
• func ResolveRemote(remoteRef, cacheDir string) (string, error)
• type EcosystemConfig
  • func Load(path string) (*EcosystemConfig, error)

Functions

func IsRemoteRef

func IsRemoteRef(path string) bool

IsRemoteRef returns true if path looks like a remote reference (GitHub owner/repo shorthand or HTTPS URL) rather than a local file.

func ResolveRemote

func ResolveRemote(remoteRef, cacheDir string) (string, error)

ResolveRemote resolves a remote GitHub reference to a local ecosystem config file path. It first checks the cache directory; a cached file is reused as-is. Otherwise it downloads the repo tarball from codeload.

remoteRef is either:

• owner/repo (e.g. "bizshuk/pm2")
• https://github.com/owner/repo[.git]

Types

type EcosystemConfig

type EcosystemConfig struct {
	Apps      []process.AppConfig `json:"apps"`
	Workflows []workflow.Config   `json:"workflows"`
}

EcosystemConfig is the top-level config structure

func Load

func Load(path string) (*EcosystemConfig, error)

Load parses an ecosystem config file (.js or .json)