repo-onboard

Repo Onboard

Detect project type, run the appropriate mise preset chain, and migrate from pre-commit to hk if applicable.

Current State

• Working directory: !pwd
• Git repo: !test -d .git && echo "Yes" || echo "No"
• Existing mise.toml: !test -f mise.toml && echo "Yes" || echo "No"
• Existing hk.pkl: !test -f hk.pkl && echo "Yes" || echo "No"
• Pre-commit config: !test -f .pre-commit-config.yaml && echo "Yes (migration candidate)" || echo "No"

Phase 1: Detect Project Type

Scan for project type indicators using Glob:

• pyproject.toml, setup.py, setup.cfg → Python
• Cargo.toml → Rust
• package.json, bun.lock, bun.lockb, tsconfig.json → Bun/TypeScript
• *.tf files in the current or immediate subdirectories → Terraform
• ansible.cfg, playbooks/ directory, roles/ directory → Ansible

A project may match multiple types (e.g., Python + Terraform monorepo). Track all matches. If nothing matches, the project is "base only".

Phase 2: Confirm with User

Confirm the detected configuration.

Build the question dynamically based on what was detected:

If project type(s) detected, present them. If .pre-commit-config.yaml exists, include migration in the confirmation. If hk.pkl already exists, note it will be overwritten.

Question format:

• header: "Onboard"
• question: "Detected: [type(s)]. [Migration note if applicable]. This will run preset:base + preset:[type], creating mise.toml, hk.pkl, .editorconfig, cliff.toml, .gitignore, and renovate.json. Proceed?"
• options:
  • Proceed (Run detected preset chain)
  • Base only (Skip language preset, run preset:base only)
  • Cancel (Abort onboarding)

If multiple types detected, use multiSelect: true to let user choose which language presets to apply.

Phase 3: Execute Presets

Based on user confirmation, run the appropriate preset via Bash.

Available presets and their commands:

• Python: mise preset:uv (depends on preset:base, runs both)
• Rust: mise preset:rust (depends on preset:base, runs both)
• Bun/TypeScript: mise preset:bun (depends on preset:base, runs both)
• Terraform: mise preset:terraform (depends on preset:base, runs both)
• Ansible: mise preset:ansible (depends on preset:base, runs both)
• Base only: mise preset:base