aurora-cli

When to Use

• User asks to "regenerate", "load", or "generate" a module
• User wants to add a package (oauth, auditing, etc.)
• User needs to create a new Aurora project
• After YAML schema changes that require code regeneration
• User mentions "aurora cli" or "aurora load"

Critical Patterns

Command Structure

Hash Protection System

Aurora tracks file modifications via hash. Files with custom changes are protected by default:

• Without -f: Modified files are preserved
• With -f: All files are overwritten (use with caution)

Execution Flow

1. Identify Action

Ask the user what they want to do:

1. Generate/Regenerate module - Regenerate code from existing YAML
2. Add package - Install preconfigured package (auditing, oauth, etc.)
3. Create project - Create new Aurora project (rare)

2. Gather Information

For Generate/Regenerate Module:

1. Ask which bounded context and module to regenerate
2. ONLY if you can't identify them, list available YAMLs in cliter/ using Glob
3. Ask about flags:
   • --force (overwrite existing files)
   • --tests (generate e2e tests)
   • --verbose (detailed output)

For Add Package:

1. Run aurora add back to show available packages
2. Ask which package to install
3. Ask if --force is needed

For Create Project:

1. Ask for project name
2. Confirm before executing

3. Execute Command

# Regenerate module
aurora load back module -n=<bounded-context>/<module> [-f] [-t] [-v]

# Add package
aurora add back <package> [-f]

# Create project
aurora new back <app-name>

4. Report Results

Command executed successfully
aurora load back module -n=tesla/model -ft

Regenerated Files:
  - src/@api/tesla/model/controllers/...
  - src/@app/tesla/model/domain/...

Preserved Files (modified hash):
  - src/@app/tesla/model/application/create/create-model.command-handler.ts
  (These files have custom modifications and were not overwritten)

Summary:
  - X files regenerated
  - Y files preserved

Commands

# Regenerate module from YAML
aurora load back module -n=tesla/model

# Regenerate with force + tests
aurora load back module -n=tesla/model -ft

# Add package
aurora add back oauth

# Show available packages
aurora add back

# Create new project
aurora new back my-project

Flags

Error Handling

Related Skills

This skill works with:

• aurora-project-structure: Understand project structure and locate generated files
• aurora-cqrs: Understand CQRS components that will be regenerated
• conventional-commits: Create commits after successful regeneration

Resources

• YAML Definitions: cliter/[package]/[module].aurora.yaml
• Lock Files: cliter/[package]/[module]-lock.json
• Generated Code: src/@api/ and src/@app/