# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a GitHub Action that installs and configures mise, a polyglot runtime manager. The action is written in TypeScript and published to the GitHub Actions marketplace.

## Development Commands

This project uses [aube](https://aube.en.dev) as its package
manager (en.dev's pnpm-compat PM, native Rust). It reads
`package-lock.json` directly — no separate `aube-lock.yaml`.
`mise install` will install the pinned aube version
automatically; you can also use `npm` if you prefer (the
`.npmrc`'s `node-linker=hoisted` pin is aube-specific and
ignored by npm).

```bash
# Install dependencies
aube install

# Build, format, lint, and package
aubr all

# Individual commands
aubr format:write  # Format code with Prettier
aubr lint         # Run ESLint and format check
aubr package      # Bundle with rollup for distribution

# Testing
aubr all          # Run full build pipeline
./scripts/test.sh     # Integration test script
```

## Architecture

The action follows GitHub's standard TypeScript action structure:

1. **Entry Point**: `src/index.ts` - Main action logic that:
   - Downloads and installs mise binary
   - Manages caching through GitHub Actions cache
   - Configures environment variables (MISE_*, GITHUB_TOKEN)
   - Runs mise commands (install, reshim, etc.)
   - Exports mise environment variables to GITHUB_ENV

2. **Distribution**: `dist/index.js` - Compiled and bundled output (must be committed)

3. **Action Definition**: `action.yml` - Defines inputs, outputs, and metadata

## Key Implementation Details

- **Cache Management**: Uses content-addressable caching based on mise config files (.mise.toml, .tool-versions, etc.)
- **Binary Download**: Supports downloading from GitHub releases or mise.jdx.dev
- **Platform Support**: Handles Linux (glibc/musl), macOS, and Windows
- **Environment Setup**: Automatically adds mise bin and shims directories to PATH
- **GitHub API**: Uses GITHUB_TOKEN to avoid rate limits when installing GitHub-hosted tools

## Important Notes

- Always run `aubr all` before committing to ensure dist/ is updated
- The dist/ folder must be committed as GitHub Actions runs the compiled code
- Test changes using the action itself (uses: ./) in test workflows