Skip to content

feat(audit): restore css-deep as audit --check css (orphaned engine since #195) #251

Description

@Wolfvin

Mengapa

Ditemukan saat gap-analysis "tool eksplorasi repo sempurna untuk css/html/react". cssdeep_engine.py (analisis CSS dalam: unused CSS vars, orphan keyframes, specificity wars, duplicate props, unused media queries, z-index abuse) MASIH berfungsi penuh — verified 154 temuan nyata di workspace Coretax smart-tax-assistance — tapi YATIM: commands/css_deep.py dihapus total di konsolidasi #195, tidak ada entry point CLI/MCP manapun yang memanggil analyze_css_deep(). Sama persis kondisi export-snapshot (issue #218, sudah di-restore): engine hidup, entry point mati.

CSS termasuk scope bahasa yang di-target CodeLens (react/css/html). Kehilangan analisis CSS dalam = grep manual lagi untuk hal seperti "CSS var ini dipakai gak?".

Konteks

analyze_css_deep(workspace, severity, category, config) di scripts/cssdeep_engine.py sudah lengkap dan teruji. Tinggal wire ulang. JANGAN tambah top-level command baru (langgar konsolidasi 12-umbrella #195) — masuk sebagai --check css di umbrella audit (satu keluarga dengan dead-code/smell/complexity yang semua analisis code-quality).

Tujuan

codelens audit <workspace> --check css menjalankan analyze_css_deep() dan mengembalikan findings dalam shape umbrella ({s, st, r}) yang konsisten. Mendukung --severity dan --category yang sudah diterima engine.

Constraint

  • TIDAK menambah top-level command — hanya --check css di audit umbrella. Command count tetap 12.
  • Buat scripts/commands/css_deep.py thin wrapper (mirip export_snapshot.py). JANGAN duplikasi logic engine.
  • Design doc WAJIB (feature-class: command module baru) di docs/design/.
  • Update docs/agent-usage-guide.md — css-deep kembali tersedia.

Definition of Done

  • audit --check css jalan, kembalikan 154-ish findings di workspace nyata (unused_vars/orphan_keyframes/specificity/dll)
  • --severity dan --category passthrough berfungsi
  • Command count tetap 12 (bukan 13) — verifikasi sync_command_count.py
  • Design doc + regression test
  • Registry-gate test (test_command_registry.py) tetap lolos (css_deep.py masuk allowlist implementation-module kalau perlu)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions