voidzero-dev / voidzero-dev/vite-task

Proposal: task metadata (description) + aliases/groups for discoverability at scale

Aperta
#277 2 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Lingua principale
Rust
Stelle
466
Fork
42
Merge medio
1g 15h
PR unite (30g)
19

Descrizione

Problem

As task count grows, discoverability becomes a major UX issue.
just provides aliases and groups; it also has strong listing/help UX. Vite Tasks appears command-centric and does not expose first-class description/alias/group metadata in the task schema (based on the public schema file).

Evidence (primary)

  • Task schema appears centered around command without rich metadata fields.

Ref:

Proposed behavior (Unspecified)

  • Add optional fields:
    • description?: string
    • aliases?: string[]
    • group?: string
  • Display description/group in task listing and error messages.
  • Allow running a task via any alias, with clear conflict handling (unspecified).

Use cases

  • Provide “human intent” descriptions for tasks (deploy, release, verify, etc.)
  • Create short entry points via aliases
  • Organize tasks into groups (lint/test/build/release) for large monorepos

Backward compatibility

  • Purely additive; tasks without metadata behave exactly the same.

Minimal implementation suggestion (MVP)

  • Implement description first and show it in listings/output.
  • Add aliases resolution later, then group sorting/printing.

Prior art

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia dallo schema delle attività in crates/vite_task_graph/run-config.ts e confronta la struttura esistente basata solo sui comandi con i metadati proposti. Chiarisci il comportamento per l’elenco, l’output, la risoluzione degli alias, i conflitti e l’ordinamento dei gruppi prima di scegliere l’ambito dell’implementazione. Il lavoro è completato quando i metadati concordati sono supportati senza modificare il comportamento delle attività che li omettono, con una copertura per l’MVP selezionato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
rust, typescript
Ambito
cli, developer-experience
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Da chiarire
Idoneità per principianti
38/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.