voidzero-dev / voidzero-dev/vite-task
Proposal: task metadata (description) + aliases/groups for discoverability at scale
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
commandwithout rich metadata fields.
Ref:
Proposed behavior (Unspecified)
- Add optional fields:
description?: stringaliases?: 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
descriptionfirst and show it in listings/output. - Add
aliasesresolution later, thengroupsorting/printing.
Prior art
- just aliases: https://just.systems/man/en/aliases.html
- just groups: https://just.systems/man/en/groups.html
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- 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