@moonrepo/core-linux-arm64-musl

const { findMoonExe } = require('@moonrepo/cli/utils');

// Locates the appropriate binary for the current platform
const moonBinaryPath = findMoonExe();
console.log(moonBinaryPath); // /path/to/node_modules/@moonrepo/core-linux-arm64-musl/moon

# After installation, the binary is available at:
# node_modules/@moonrepo/core-linux-arm64-musl/moon
./node_modules/@moonrepo/core-linux-arm64-musl/moon --version

/**
 * Locate the moon binary executable for the current platform
 * Automatically detects platform (linux/macos/windows), architecture (x64/arm64),
 * and C library (musl/gnu) to find the correct binary package
 * @returns {string} Absolute path to the moon executable
 * @throws {Error} If moon executable not found for current platform
 */
function findMoonExe(): string;

# Initialize moon in a repository
moon init

# Run a task in a specific project
moon run app:build
# or using moonx alias
moonx app:build

# Run tests across all projects
moon run :test

# Check the health of a project
moon check app

# Run tasks in CI mode
moon ci app:build app:test

moon init [tool]

# Options:
# --force          Overwrite existing config files
# --minimal        Generate minimal configurations
# --to <path>      Destination directory (default: current)
# --yes            Skip prompts and auto-detect tools

# Tool options: bun, node, rust, typescript

moon run <...targets> [-- <args>]
# Aliases: moon r, moonx

# Target formats:
# project:task     Run specific task in specific project
# :task           Run task in all projects
# #tag:task       Run task in projects with tag
# task            Run task in closest project (based on cwd)

# Options:
# -f, --force             Force run ignoring affected status
# --dependents           Run downstream dependents
# -i, --interactive      Interactive mode
# --query <statement>    Filter projects using query language
# -s, --summary          Display run summary
# -u, --updateCache      Bypass cache
# --no-actions           Skip other pipeline actions
# -n, --no-bail          Continue on failures
# --profile <type>       Generate profile (cpu, heap)
# --affected             Only run if affected by changes
# --remote               Compare against remote for affected
# --status <type>        Filter by change status
# --stdin                Accept touched files from stdin

moon check [...projects]
# Alias: moon c

# Run all build and test tasks for projects
# Arguments: project names (optional)
# Options:
# --all           Check all projects
# -u, --updateCache   Bypass cache
# --summary       Display run summary

moon ci [...targets]

# CI-optimized task execution with:
# - No-bail behavior by default
# - Enhanced logging for build systems
# - Optimized caching strategies

moon setup
# Setup the environment by installing all configured tools
# Downloads and installs tools defined in toolchain.yml

moon teardown  
# Teardown the environment by uninstalling all tools and deleting temp files

moon bin <tool>
# Return absolute path to a tool's binary within the toolchain
# Arguments: <tool> - Tool name (node, npm, etc.)
# Returns non-zero exit code if tool not configured or installed

moon upgrade
# Alias: moon up
# Upgrade moon to the latest available version

moon generate <template> [dest]
# Alias: moon g
# Generate and scaffold files from a pre-defined template
# Arguments:
#   <template>    Name of template to use
#   [dest]        Destination path (optional)
# Options:
#   --dryRun           Show what would be generated without creating files
#   --force            Overwrite existing files if they exist
#   --template <path>  Use template from specific path

moon templates
# List all templates available for code generation

moon query <subcommand>
# Query information about moon, the environment, and pipeline
# Subcommands:
#   projects <statement>     Query projects using filter criteria
#   tasks <statement>        Query tasks across projects  
#   touched-files           Query touched files and their relationships

# Query operators: &&, ||, !, ()
# Project criteria: language=<lang>, projectType=<type>, tag=<tag>, 
#                  project~<pattern>, dependsOn=<project>

moon sync [subcommand]
# Sync the workspace to a healthy state
# Subcommands:
#   projects     Sync all project configurations
#   hooks        Sync git hooks for workspace
#   codeowners   Sync CODEOWNERS file based on project ownership

moon ext [args...]
# Execute an extension plugin
# Arguments: Extension-specific arguments and options

moon toolchain <subcommand>
# Manage toolchain plugins
# Subcommands: Various toolchain management operations

moon migrate <operation>
# Operations for migrating existing projects to moon
# Operations:
#   from-package-json    Convert package.json scripts to moon tasks
#   from-turborepo       Migrate from Turborepo configuration
# Options:
#   --skip-touched-files-check    Disable check for dirty files

moon docker <subcommand>
# Operations for integrating with Docker and Dockerfile(s)
# Subcommands:
#   scaffold    Generate Dockerfile and docker-compose configurations
#   sync        Sync Docker configurations with workspace changes

moon mcp [subcommand]
# Start an MCP (model context protocol) server for AI agent requests
# Subcommands: Various MCP protocol operations

moon debug <subcommand>
# Debug internals (hidden command)
# Subcommands: Various debugging operations

moon completions <shell>
# Generate shell completions for command-line integration
# Arguments: <shell> - Target shell (bash, zsh, fish, powershell)

moon clean
# Clean cached artifacts and outputs
# Options:
#   --cache      Clean cache directory
#   --docker     Clean Docker-related files

# Caching
--cache <mode>          Cache operations mode (off, read, read-write, write)

# Output Control  
--color                 Force colored output
--quiet, -q             Hide non-important output
--theme <theme>         Terminal theme (dark, light)

# Performance
--concurrency <n>, -c   Maximum thread count
--dump                  Generate trace profile

# Logging
--log <level>           Log level (off, error, warn, info, debug, trace, verbose)
--logFile <file>        Write logs to file

# General
--help                  Show help
--version               Show version

# Core Configuration
MOON_CACHE              Cache mode override
MOON_COLOR              Color support level (0-3)
MOON_CONCURRENCY        Thread pool size
MOON_LOG                Log level
MOON_LOG_FILE           Log output file
MOON_THEME              Terminal theme

# Debugging
MOON_DEBUG_PROCESS_ENV      Show process environment variables
MOON_DEBUG_PROCESS_INPUT    Show process input
MOON_DEBUG_PROTO_INSTALL    Debug proto installation
MOON_DEBUG_REMOTE           Debug remote caching
MOON_DEBUG_WASM             Debug WASM plugins

# VCS Integration  
MOON_BASE               Base revision for affected checks
MOON_HEAD               Head revision for affected checks

# Tool Detection
MOON_VERSION            Moon version (set automatically)

// Platform constraints from package.json
interface PlatformConstraints {
  os: ["linux"];
  cpu: ["arm64"];
  libc: ["musl"];
}

// Exit codes
type ExitCode = 0 | number; // 0 = success, non-zero = various failures

// Cache modes
type CacheMode = "off" | "read" | "read-write" | "write";

// Log levels
type LogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace" | "verbose";

// Change status types for affected filtering
type ChangeStatus = "all" | "added" | "deleted" | "modified" | "staged" | "unstaged" | "untracked";