SuperAPI AI Directory

indexion-plan-unwrap

Coding & development

View repository

Updated 10-16 06:43

About this skill

indexion plan unwrap

Detect unnecessary wrapper functions and optionally auto-fix them by replacing callers with direct calls to the delegate.

When to Use

  • User asks to remove unnecessary wrappers or forwarding functions
  • After plan refactor finds duplicates caused by trivial delegation
  • User wants to reduce indirection in the codebase
  • User asks "which functions just delegate to another?"
  • After writing new code — dogfood to catch accidental proxy accumulation

Relationship to Other Commands

Command Detects proxies? Auto-fix? When to use
grep --semantic=proxy Yes No Quick check during development
plan unwrap (default) Yes No Detailed report with line numbers
plan unwrap --dry-run Yes Preview Review before applying changes
plan unwrap --fix Yes Yes Apply fixes to source files

Use grep --semantic=proxy for quick discovery, plan unwrap for action.

Modes

Mode Flag Description
Report (default) List wrappers found (md/json/text)
Preview --dry-run Show all edits: call site replacements + definition deletions
Fix --fix Apply edits to files

Usage

# Report wrappers
indexion plan unwrap --include='*.mbt' <path>

# Preview changes (safe — no files modified)
indexion plan unwrap --dry-run --include='*.mbt' <path>

# Auto-fix: replace call sites and delete wrappers
indexion plan unwrap --fix --include='*.mbt' <path>

# Include self-delegation (self.field.method) and bare constructors
indexion plan unwrap --all --include='*.mbt' <path>

# JSON output
indexion plan unwrap --format=json --include='*.mbt' <path>

# Output to file
indexion plan unwrap -o=unwrap.md --include='*.mbt' <path>

Options

Option Default Description
--dry-run — Preview edits without applying
--fix — Apply edits (replace call sites, delete wrappers)
--all — Include self-delegation and bare constructor wrappers
--include-self — Include self.field.method delegation patterns
--include-bare — Include bare constructor wrappers (no qualifier)
--include=PATTERN — Include pattern (repeatable)
--exclude=PATTERN — Exclude pattern (repeatable)
--format=FORMAT md Output format: md, json, text
-o, --output=FILE stdout Output file path
--specs-dir=DIR kgfs KGF specs directory

What Gets Detected

A function is flagged as an unwrappable wrapper if:

  • Its body is a single function call
  • Arguments are simple identifiers (no expressions)
  • No control flow (if, match, let, etc.)

Detected (default)

fn matches_pattern(text : String, pat : String) -> Bool {
  @glob.glob_match(text, pat)       // trivial delegation
}

fn is_absolute_path(path : String) -> Bool {
  @path_utils.is_absolute(path)     // just a rename
}

Excluded by default (use --all to include)

fn length(self : MyList) -> Int {
  self.items.length()               // self-delegation (encapsulation)
}

fn emit(value : String) -> Action {
  Emit(value)                       // bare constructor
}

Dogfooding Workflow

# Step 1: Quick check with grep
indexion grep --semantic=proxy src/

# Step 2: Detailed preview
indexion plan unwrap --dry-run \
  --include='*.mbt' --exclude='*_wbtest.mbt' \
  --exclude='*moon.pkg*' --exclude='*pkg.generated*' \
  src/

# Step 3: Review — check each wrapper is truly unnecessary

# Step 4: Apply fixes
indexion plan unwrap --fix \
  --include='*.mbt' --exclude='*_wbtest.mbt' \
  --exclude='*moon.pkg*' --exclude='*pkg.generated*' \
  src/

# Step 5: Run tests to verify
moon test --target native

# Step 6: Re-run plan refactor to see cleaner results
indexion plan refactor --threshold=0.9 \
  --include='*.mbt' --exclude='*_wbtest.mbt' \
  src/

Dogfooding Lessons

  • Always --dry-run first: Review what will change before applying --fix.
  • Platform wrappers are intentional: FFI wrappers (e.g. encode_bytes → @utf8.encode) or @osenv_path wrappers in config/paths.mbt are abstraction layers, not accidental indirection. Review before removing.
  • Public API wrappers: If a wrapper is pub and used by external packages, removing it is a breaking change. Check visibility before fixing.
  • grep first: indexion grep --semantic=proxy src/ gives a quick count. If there are only a few, manual review may be faster than --fix.