Redundancy / deprecation / duplication scan

Purpose

Find accidental duplication and stale dual paths across a repo or the whole fleet, without deleting intentional duals (decoupling, test isolation, public facades).

Complements:

Detection classes (this skill)

Not automated here (session follow-ups): unused exports (knip), clone near-matches (jscpd), dual SECURITY_PATHS (GAP-404), package catalog drift (syncpack). Run those tools when the mechanical pass is done; record results into the same run directory.

Config

Default knobs: config/defaults.json (exclude dirs, marker lists, size limits).

Override:

node scripts/run-scan.js --root … --out-dir … --config /path/to/override.json

Do not put private planning-repo paths in config committed to this package.

Artifacts

Prefer the fleet shared archive (not product git):

export REVEALFLEET_ARCHIVE="${REVEALFLEET_ARCHIVE:-$REVEALFLEET_ROOT/archive/cold}"
OUT="$REVEALFLEET_ARCHIVE/audits/$(date -u +%Y-%m-%d)-redundancy-<scope>"

$OUT/
  RUN.json
  raw/*.jsonl          # per-detector outputs
  findings.jsonl       # merged
  report.md            # human summary
  summary.json
  classified/          # optional: agent-edited classifications

Quick start (one repo)

SKILL="$REVEALFLEET_ROOT/revskills/skills/redundancy-scan"
export REVEALFLEET_ARCHIVE="${REVEALFLEET_ARCHIVE:-$REVEALFLEET_ROOT/archive/cold}"
OUT="$REVEALFLEET_ARCHIVE/audits/$(date -u +%Y-%m-%d)-redundancy-revealui"
mkdir -p "$OUT"

node "$SKILL/scripts/run-scan.js" \
  --root "$REVEALFLEET_ROOT/revealui" \
  --out-dir "$OUT"

# read $OUT/report.md then classify findings

Fleet mode

node "$SKILL/scripts/run-scan.js" \
  --root "$REVEALFLEET_ROOT" \
  --fleet \
  --out-dir "$REVEALFLEET_ARCHIVE/audits/$(date -u +%Y-%m-%d)-redundancy-fleet"

Skips hidden directories, archive/, tmp/, docs/, scripts/, worktrees/, and *-wt sibling folders. Nested tmp/worktrees dirs are also in defaults.json excludeDirNames.

Workflow (multi-session)

Session A — detect (mechanical)

1. Run run-scan.js for scope.
2. Workboard note: redundancy-scan:<date>-<scope>.
3. Do not delete code yet.

Session B — classify (judgment)

For each high-signal finding (start with exact-duplicate and deprecation markers on runtime paths):

Append classifications to classified/decisions.jsonl:

{
  "id": "DUP-EXACT-0001",
  "classification": "accidental",
  "action": "gap|pr|leave",
  "gap": null,
  "notes": "two copies of PEM unescape; keep packages/security",
  "agent": "…",
  "ts": "…"
}

Session C — remediate

1. Implement only classified accidental items (or owner-authorized).
2. Prefer consolidate onto @revealui/* native parts.
3. Public PRs: no private planning paths in bodies.
4. Re-run scan on touched packages; delta should shrink.

Optional tools (document in RUN.json)

# near-dupe clones (if available)
pnpm dlx jscpd <root> --ignore "**/node_modules/**,**/dist/**"

# unused (if configured in monorepo)
pnpm exec knip   # only when package supports it

# catalog drift
pnpm exec syncpack lint

Paste summary counts into $OUT/optional-tools.md.

Severity guide

Multi-agent concurrency

• Detect phase is single-writer on $OUT (one agent runs run-scan.js).
• Classify can shard by finding id ranges or by class (exact-duplicate vs deprecation-marker).
• Remediate uses normal worktrees from origin/test; one PR cluster per theme (logger, ValidationError, PEM unescape…).

Anti-patterns

Related references

• references/methodology.md — full taxonomy and intentional-dup examples
• config/defaults.json — markers and excludes
• Fleet lane: operator planning fleet-redundancy + remediation spec (when authorized)
• Hardlines: extend-before-create, audit-first mindfulness, code-over-docs

Scripts