revanced-ponytail-debt

name	revanced-ponytail-debt
description	Harvest every revanced-ponytail or ponytail debt marker into a ledger so deliberate shortcuts do not rot. Use when the user says "ponytail debt", "revanced-ponytail-debt", "/revanced-ponytail-debt", "what did we defer", or "list the shortcuts". One-shot report. Changes nothing unless asked to write a file.
license	MIT
metadata	{"author":"chloevpin","version":"1.0.0","upstream":"DietrichGebert/ponytail","repository":"https://github.com/ChloeVPin/revanced-ponytail"}

revanced-ponytail-debt

Collect deliberate shortcuts into one ledger.

Scan

Search the repo for comment markers. Skip node_modules, .git, and build output.

# Prefer ripgrep if available:
rg -n --glob '!node_modules' --glob '!.git' --glob '!dist' --glob '!build' \
  '(#|//)\s*(revanced-)?ponytail:' .

# Or:
grep -rnE --exclude-dir=node_modules --exclude-dir=.git \
  '(#|//)[[:space:]]*(revanced-)?ponytail:' .

Also accept:

revanced-ponytail: ceiling=...; upgrade=...
ponytail: ceiling=...; upgrade=...

Valid marker

Both parts required:

• ceiling= the known limit
• upgrade= the trigger to revisit

Output

One row per marker, grouped by file:

<file>:<line> | <summary> | ceiling: <limit> | upgrade: <trigger>

Tags:

• no-trigger if upgrade is missing
• no-ceiling if ceiling is missing
• ok if both present

End with: <N> markers, <M> invalid.

Nothing found: No debt markers. Clean ledger.

Boundaries

• Read and report only by default.
• To persist, user must ask. Then write REVANCED-PONYTAIL-DEBT.md or a path they name.
• One-shot.
• "stop ponytail" or "normal mode": revert.