feat: replace category with a multi-facet tag vocabulary

A single category could not describe tools that ship as a CLI, an editor
plugin and a desktop app at once, and 7 of the 40 entries were filed
under a surface they only partly match — cline is "an SDK, IDE extension
or CLI assistant" in one `extension` slot, Reasonix ships CLI, desktop
and VS Code under `cli`, warp is a terminal filed as `ide`.

Tags cover five facets: surface (at least one), model access, workflow,
integration, and origin (at most one). tagVocabulary in validate.go is
the single source of truth — the validator, its error messages, and the
dashboard's filter chips all derive from it, the last via a new facets
field in site/data.json.

The dashboard now filters on tags with multi-select chips grouped by
facet: OR within a facet, AND across facets, plus a clear-filters
control, and search matches tags as well as name and description. Only
tags some row actually carries get a chip, so chips and rows cannot
disagree. Tag pills are tinted per facet, replacing the category badge.

All 40 entries are tagged from each repo's own README, topics and docs;
CONTRIBUTING documents every tag and the evidence rule for applying one.
A leftover `category:` key now fails validation with a message naming
its replacement, rather than being silently ignored.

README.md and data/history.jsonl are the regenerated updater output.
This commit is contained in:
tiennm99 committed 2026-09-11 15:40:18 +07:00
1 parent e49c487700
commit eb12bcc2cb
16 files changed
+462 -205

No files matched your search

+19 -15
View File
@@ -7,26 +7,29 @@ import (
// siteRow is one ranked repo in site/data.json, consumed by site/index.html.
type siteRow struct {
Key string `json:"key"` // canonical owner/repo, matches history keys
NameWithOwner string `json:"nameWithOwner"`
URL string `json:"url"`
Stars int `json:"stars"`
Delta7d int `json:"delta7d"`
HasDelta bool `json:"hasDelta"`
Delta30d int `json:"delta30d"`
HasDelta30 bool `json:"hasDelta30"`
Language string `json:"language"`
PushedAt string `json:"pushedAt"`
Description string `json:"description"`
Category string `json:"category"`
Notes string `json:"notes,omitempty"`
Archived bool `json:"archived"`
Key string `json:"key"` // canonical owner/repo, matches history keys
NameWithOwner string `json:"nameWithOwner"`
URL string `json:"url"`
Stars int `json:"stars"`
Delta7d int `json:"delta7d"`
HasDelta bool `json:"hasDelta"`
Delta30d int `json:"delta30d"`
HasDelta30 bool `json:"hasDelta30"`
Language string `json:"language"`
PushedAt string `json:"pushedAt"`
Description string `json:"description"`
Tags []string `json:"tags"`
Notes string `json:"notes,omitempty"`
Archived bool `json:"archived"`
}
type siteData struct {
UpdatedAt string `json:"updatedAt"`
Rows []siteRow `json:"rows"`
History []Snapshot `json:"history"`
// Facets drives the dashboard's filter chips, so the tag vocabulary is
// defined once in Go rather than duplicated in site/index.html.
Facets []tagFacet `json:"facets"`
}
// writeSiteData emits the JSON payload for the GitHub Pages dashboard.
@@ -49,7 +52,7 @@ func writeSiteData(path string, stats []Stat, deltas7, deltas30 map[string]int,
Language: s.Language,
PushedAt: s.PushedAt.Format("2006-01-02"),
Description: s.Description,
Category: s.Category,
Tags: s.Tags,
Notes: s.Notes,
Archived: s.IsArchived,
}
@@ -60,6 +63,7 @@ func writeSiteData(path string, stats []Stat, deltas7, deltas30 map[string]int,
UpdatedAt: timeNow().UTC().Format("2006-01-02 15:04 UTC"),
Rows: rows,
History: history,
Facets: tagVocabulary,
})
})
}