xonecas.io
8356
Wx

www-xonecas-io / commit 9c3e6e4

specific topics per project from dependency files, paths and README/AGENTS keywords (1031)

Co-Authored-By: Claude Opus 5.5

Sean Caetano Martin2026-11-08 9c3e6e43755d4874cc86b65c17e8450a332f20b1 parent 649d9e6

15 files changed

internal/project/describe.go+4−2
@@ -27,6 +27,7 @@ type Info struct {
2727 Languages []Language `json:"languages"`
2828 Readme string `json:"readme"`
2929 Tags []string `json:"tags"`
30+ Topics []string `json:"topics"` // specific tags, from topics.go
3031 Hidden string `json:"hidden,omitempty"` // why it is not listed: fork, empty or override
3132 }
3233
@@ -41,7 +42,7 @@ func Describe(p *Project, metas map[string]store.Meta, o Overrides) error {
4142 return err
4243 }
4344 in := &p.Info
44- *in = Info{First: h.First, Last: h.Last, Commits: h.Mine, Total: h.Total, Months: h.Months, Files: f.Count, Languages: f.Languages, Readme: f.Readme}
45+ *in = Info{First: h.First, Last: h.Last, Commits: h.Mine, Total: h.Total, Months: h.Months, Files: f.Count, Languages: f.Languages, Readme: f.Readme, Topics: f.Topics}
4546 fork := false
4647 for _, s := range p.Sources {
4748 m := metas[s.URL]
@@ -67,7 +68,8 @@ func Describe(p *Project, metas map[string]store.Meta, o Overrides) error {
6768 if f.Back {
6869 in.Tags = append(in.Tags, "backend")
6970 }
70- in.Tags = o.retag(p.Name, in.Tags)
71+ in.Tags = o.retag(p.Name, in.Tags, known)
72+ in.Topics = o.retag(p.Name, in.Topics, topicNames)
7173
7274 switch {
7375 case o.Show[p.Name]:
internal/project/files.go+5−1
@@ -32,6 +32,7 @@ type Files struct {
3232 Languages []Language // by bytes, largest first, 5% and up
3333 Front bool // has browser files
3434 Back bool // has server files
35+ Topics []string // see topics.go
3536 }
3637
3738 // Language is one language's share of a project's code.
@@ -50,16 +51,18 @@ func ReadFiles(s Source) (Files, error) {
5051 if err != nil || out == "" {
5152 return f, err
5253 }
53- bytes, total := map[string]int{}, 0
54+ bytes, total, all, kept := map[string]int{}, 0, []string{}, []string{}
5455 for _, line := range strings.Split(out, "\n") {
5556 meta, name, _ := strings.Cut(line, "\t")
5657 f.Count++
58+ all = append(all, name)
5759 if !strings.Contains(name, "/") && readme.MatchString(name) && f.Readme == "" {
5860 f.Readme = name
5961 }
6062 if vendored.MatchString(name) {
6163 continue
6264 }
65+ kept = append(kept, name)
6366 f.Front = f.Front || front.MatchString(name)
6467 f.Back = f.Back || back.MatchString(name)
6568 if lang, ok := languages[strings.ToLower(path.Ext(name))]; ok {
@@ -74,6 +77,7 @@ func ReadFiles(s Source) (Files, error) {
7477 f.Languages = append(f.Languages, Language{name, p})
7578 }
7679 }
80+ f.Topics = findTopics(s.Dir, all, kept, f.Readme)
7781 sort.Slice(f.Languages, func(a, b int) bool { return f.Languages[a].Percent > f.Languages[b].Percent })
7882 return f, nil
7983 }
internal/project/overrides.go+17−5
@@ -15,7 +15,7 @@ import (
1515 // merge <remote URL> <remote URL> make two remotes one project
1616 // rename <name> <new name> rename a project
1717 // hide <name> / show <name> hide a project, or list a fork or empty one
18-// tag <name> +frontend -backend add or drop tags; +post-AI also drops pre-AI, and so on
18+// tag <name> +frontend -backend add or drop tags or topics; +post-AI also drops pre-AI, and so on
1919 type Overrides struct {
2020 Merge [][2]string
2121 Rename map[string]string
@@ -28,10 +28,22 @@ var opposite = map[string]string{"pre-AI": "post-AI", "post-AI": "pre-AI", "smal
2828
2929 var known = map[string]bool{"pre-AI": true, "post-AI": true, "small": true, "big": true, "frontend": true, "backend": true}
3030
31-// retag applies the tag rules for name to tags.
32-func (o Overrides) retag(name string, tags []string) []string {
31+// topicNames is the topics' vocabulary, for the tag rules.
32+var topicNames = func() map[string]bool {
33+ m := map[string]bool{}
34+ for _, t := range topics {
35+ m[t.name] = true
36+ }
37+ return m
38+}()
39+
40+// retag applies the tag rules for name to tags, for the tags in vocab.
41+func (o Overrides) retag(name string, tags []string, vocab map[string]bool) []string {
3342 for _, op := range o.Tag[name] {
3443 tag := op[1:]
44+ if !vocab[tag] {
45+ continue
46+ }
3547 tags = slices.DeleteFunc(tags, func(t string) bool { return t == tag || t == opposite[tag] })
3648 if op[0] == '+' {
3749 tags = append(tags, tag)
@@ -73,10 +85,10 @@ func ReadOverrides(path string) (Overrides, error) {
7385 return o, sc.Err()
7486 }
7587
76-// validTags accepts +tag and -tag for known tags, except dropping a tag that must have an opposite.
88+// validTags accepts +tag and -tag for known tags and topics, except dropping a tag that must have an opposite.
7789 func validTags(ops []string) bool {
7890 for _, op := range ops {
79- if len(op) < 2 || !known[op[1:]] || (op[0] != '+' && op[0] != '-') || (op[0] == '-' && opposite[op[1:]] != "") {
91+ if len(op) < 2 || !(known[op[1:]] || topicNames[op[1:]]) || (op[0] != '+' && op[0] != '-') || (op[0] == '-' && opposite[op[1:]] != "") {
8092 return false
8193 }
8294 }
internal/project/project_test.go+16−3
@@ -63,12 +63,25 @@ func TestReadOverrides(t *testing.T) {
6363 }
6464
6565 func TestRetag(t *testing.T) {
66- o := Overrides{Tag: map[string][]string{"p": {"+post-AI", "+big", "-backend", "+frontend"}}}
67- got := o.retag("p", []string{"pre-AI", "small", "backend"})
66+ o := Overrides{Tag: map[string][]string{"p": {"+post-AI", "+big", "-backend", "+frontend", "+react", "-vim"}}}
67+ got := o.retag("p", []string{"pre-AI", "small", "backend"}, known)
6868 if want := []string{"post-AI", "big", "frontend"}; !reflect.DeepEqual(got, want) {
6969 t.Fatalf("retag = %v, want %v", got, want)
7070 }
71- if validTags([]string{"-pre-AI"}) || validTags([]string{"+huge"}) || !validTags([]string{"-frontend", "+small"}) {
71+ if got := o.retag("p", []string{"vim", "cli"}, topicNames); !reflect.DeepEqual(got, []string{"cli", "react"}) {
72+ t.Fatalf("retag topics = %v", got)
73+ }
74+ if validTags([]string{"-pre-AI"}) || validTags([]string{"+huge"}) || !validTags([]string{"-frontend", "+small", "-react"}) {
7275 t.Error("validTags accepts the wrong rules")
7376 }
7477 }
78+
79+// TestMatchTopics finds topics by dependency names and paths ignoring case, and by README words as written.
80+func TestMatchTopics(t *testing.T) {
81+ code := "go.mod\nweb/package.json\nDockerfile\n\nrequire github.com/gorilla/websocket v1\n{\"dependencies\": {\"react\": \"^19\", \"@types/bun\": \"1\"}}"
82+ prose := "A WebRTC chat with a CLI. It does not use react, and nothing here is vim."
83+ want := []string{"cli", "webrtc", "websocket", "react", "bun", "docker"}
84+ if got := matchTopics(code, prose); !reflect.DeepEqual(got, want) {
85+ t.Errorf("matchTopics = %v, want %v", got, want)
86+ }
87+}
internal/project/topics.go+112−0
@@ -0,0 +1,112 @@
1+package project
2+
3+import (
4+ "path/filepath"
5+ "regexp"
6+ "strings"
7+
8+ "xonecas.io/site/internal/repo"
9+)
10+
11+// topic is a specific tag. code matches the dependency files and the paths, ignoring case;
12+// prose matches the README and the agent instructions as written. Either one finds it.
13+type topic struct {
14+ name string
15+ code, prose *regexp.Regexp
16+}
17+
18+// t compiles a topic. An empty pattern never matches.
19+func t(name, code, prose string) topic {
20+ re := func(flags, s string) *regexp.Regexp {
21+ if s == "" {
22+ return nil
23+ }
24+ return regexp.MustCompile(flags + s)
25+ }
26+ return topic{name, re(`(?i)`, code), re(``, prose)}
27+}
28+
29+// topics is the vocabulary, in the order a project lists them: what it is, then what it is built with.
30+var topics = []topic{
31+ t("cli", `"(commander|yargs|meow|cac)"|spf13/cobra|urfave/cli`, `\b(a|the) CLI\b|\bCLI (tool|app)\b|\bcommand[- ]line (tool|app|interface|utility)\b`),
32+ t("tui", `bubbletea|"(ink|blessed)"|cel-tui|tview|ratatui`, `\bTUI\b|\bterminal UI\b`),
33+ t("neovim", `\bnvim\b|(^|\n)(lua|plugin|ftplugin|after)/[^\n]*\.(lua|vim)\n`, `\bNeovim\b|\bnvim\b`),
34+ t("vim", `\.vim\n|(^|[\n/])\.?vimrc\n|(^|\n)vim-`, `\bVim\b`),
35+ t("dotfiles", `dotfiles`, `\bdotfiles\b`),
36+ t("i3", `(^|[\n/-])i3(wm|status|_config)?\b`, `\bi3(wm)?\b`),
37+ t("macos", `macotron`, `\bmenu bar\b`),
38+ t("chrome-extension", `"(content_scripts|manifest_version|browser_action)"`, `\b(Chrome|browser|Firefox) (extension|add-on)\b|\bunpacke?d extension\b|\bextensions? tab\b`),
39+ t("ai-agent", `@modelcontextprotocol|mcp-go|@earendil-works|opencode`, `\bcoding agents?\b|\bagent (loop|harness)\b|\bMCP\b`),
40+ t("skills", `(^|[\n/])SKILL\.md\n`, ``),
41+ t("llm", `"openai"|go-openai|@anthropic-ai|@ai-sdk|"ai"|ollama`, `\bLLMs?\b|\bOpenRouter\b|\bOllama\b`),
42+ t("pytorch", `\btorch\b`, `\bPyTorch\b`),
43+ t("game", `"(phaser|pixi\.js|kaboom|excalibur)"`, `\b[Gg]ames?\b`),
44+ t("canvas", `canvas`, `\b[Cc]anvas\b`),
45+ t("webrtc", `livekit|webrtc|simple-peer|"peerjs"`, `\bWebRTC\b`),
46+ t("websocket", `gorilla/websocket|"(ws|socket\.io|socket\.io-client)"|nhooyr\.io/websocket`, `\bWebSockets?\b`),
47+ t("react", `"(react|react-dom|react-scripts|preact)"`, `\bReact\b`),
48+ t("next.js", `"next"`, `\bNext\.js\b`),
49+ t("vue", `"vue"`, `\bVue(\.js)?\b`),
50+ t("angular", `"(angular|@angular/core)"`, `\bAngular(JS)?\b`),
51+ t("backbone", `"backbone"|(^|/)backbone[^/\n]*\.js\n`, `\bBackbone(\.js)?\b`),
52+ t("jquery", `"jquery"|(^|/)jquery[^/\n]*\.js\n`, `\bjQuery\b`),
53+ t("three.js", `"three"|threejs|(^|/)three(\.min)?\.js\n`, `\b[Tt]hree\.js\b`),
54+ t("tailwind", `tailwindcss`, `\bTailwind\b`),
55+ t("bootstrap", `"bootstrap"`, `\bBootstrap\b`),
56+ t("styled-components", `"styled-components"`, ``),
57+ t("shadcn", `"shadcn"|radix-ui`, `\bshadcn\b`),
58+ t("vite", `"vite"`, `\bVite\b`),
59+ t("node", `(^|\n)node_modules/|(^|\n)(server|app|http|node)\.js\n`, `\bNode(\.js|JS)?\b|\bnode\.js\b`),
60+ t("bun", `@types/bun|(^|\n)bun\.lockb?\n|bunfig\.toml`, ``),
61+ t("express", `"express"`, `\bExpress\.js\b`),
62+ t("koa", `"koa"`, `\bKoa\b`),
63+ t("gin", `gin-gonic/gin`, ``),
64+ t("encore", `encore\.dev`, `\bEncore\b`),
65+ t("flask", `\bflask\b`, `\bFlask\b`),
66+ t("jekyll", `\bjekyll\b|github-pages`, `\bJekyll\b`),
67+ t("electron", `"electron"`, `\bElectron\b`),
68+ t("sqlite", `sqlite`, `\bSQLite\b`),
69+ t("postgres", `"(pg|postgres)"|jackc/pgx|lib/pq`, `\bPostgres(QL)?\b`),
70+ t("mongodb", `"mongo(db|ose)"`, `\bMongoDB\b`),
71+ t("redis", `"(redis|ioredis)"|go-redis`, `\bRedis\b`),
72+ t("prisma", `"prisma"|@prisma/client`, ``),
73+ t("drizzle", `drizzle-orm`, ``),
74+ t("graphql", `"graphql"|apollo`, `\bGraphQL\b`),
75+ t("tree-sitter", `tree-sitter`, `\b[Tt]ree-sitter\b`),
76+ t("docker", `(^|\n|/)(dockerfile|(docker-)?compose\.ya?ml)\n`, `\bDocker\b`),
77+}
78+
79+var (
80+ manifest = regexp.MustCompile(`(?i)(^|/)(package\.json|go\.mod|cargo\.toml|requirements\.txt|pyproject\.toml|gemfile|build\.zig\.zon|composer\.json|bower\.json|manifest\.json)$`)
81+ agents = regexp.MustCompile(`(?i)(^|/)(agents|claude)\.md$`)
82+)
83+
84+// findTopics reads the dependency files, the README and the agent instructions among the kept paths in dir,
85+// and returns the topics they, the repo's name and all its paths mention.
86+func findTopics(dir string, all, kept []string, readme string) []string {
87+ code := []string{strings.TrimSuffix(filepath.Base(dir), ".git"), strings.Join(all, "\n") + "\n"}
88+ prose := []string{}
89+ for _, p := range kept {
90+ into := &code
91+ if p == readme || agents.MatchString(p) {
92+ into = &prose
93+ } else if !manifest.MatchString(p) {
94+ continue
95+ }
96+ if text, err := repo.Git(dir, "show", "HEAD:"+p); err == nil {
97+ *into = append(*into, text)
98+ }
99+ }
100+ return matchTopics(strings.Join(code, "\n"), strings.Join(prose, "\n"))
101+}
102+
103+// matchTopics is the topics that code or prose mention.
104+func matchTopics(code, prose string) []string {
105+ var found []string
106+ for _, tp := range topics {
107+ if (tp.code != nil && tp.code.MatchString(code)) || (tp.prose != nil && tp.prose.MatchString(prose)) {
108+ found = append(found, tp.name)
109+ }
110+ }
111+ return found
112+}
internal/site/rows.go+1−0
@@ -34,6 +34,7 @@ func Rows(projects []project.Project) []ProjectRow {
3434 First: p.First,
3535 Last: p.Last,
3636 Months: strings.Join(slices.Sorted(maps.Keys(p.Months)), " "),
37+ Topics: p.Topics,
3738 }
3839 for _, n := range heat {
3940 if p.Commits >= n {
internal/site/static/projects.js+2−2
@@ -1,5 +1,5 @@
11 // Filters, sorts and searches the /projects list, and keeps the view in the URL.
2-// Tags from different pairs must all match; tags of the same pair match either.
2+// Tags from different pairs must all match; tags of the same pair match either. The search matches a name in part, or a topic whole.
33 // The date range keeps a project with any commit in a month between its two thumbs, over a bar per month of active projects.
44 // The matches show perPage at a time; the pager links reload the page with ?page=N, and any change goes back to page 1.
55 const form = document.getElementById("filters"), list = document.getElementById("rows");
@@ -29,7 +29,7 @@ function apply() {
2929 let shown = 0;
3030 for (const r of rows.sort(sorts[sort])) {
3131 const tags = r.dataset.tags.split(" ");
32- r.hidden = !r.dataset.name.includes(q) || !pairs.every(p => p.some(t => tags.includes(t)))
32+ r.hidden = !(r.dataset.name.includes(q) || r.dataset.topics.split(" ").includes(q)) || !pairs.every(p => p.some(t => tags.includes(t)))
3333 || !r.dataset.months.split(" ").some(m => m >= from && m <= to);
3434 shown += !r.hidden;
3535 list.append(r);
internal/site/style.go+5−5
@@ -14,11 +14,11 @@ func styleData() map[string]any {
1414 "Heat": []int{0, 2, 8, 27, 62, 205, 625},
1515 "Tags": []string{"frontend", "backend", "small", "big", "pre-AI", "post-AI"},
1616 "Rows": []ProjectRow{
17- {mc, "A good idea 👾 A fast, transparent agent for the terminal", "TypeScript", 94.3, 4.7, 6, []string{"post-AI", "big"}, "", "", ""},
18- {zn, "Zoea-Nova is a high-performance command center designed to orchestrate massive swarms of agents", "Go", 95.8, 3.1, 5, []string{"post-AI", "big", "backend"}, "", "", ""},
19- {cl, "Terminal comics from the AI coding build log", "Python", 97.4, 1.6, 2, []string{"post-AI", "small", "frontend", "backend"}, "", "", ""},
20- {xc, "My space online.", "JavaScript", 3.6, 5.7, 3, []string{"pre-AI", "big", "frontend"}, "", "", ""},
21- {fn, "Node.js Module for ffmpeg library.", "JavaScript", 0, 34, 1, []string{"pre-AI", "small"}, "", "", ""},
17+ {mc, "A good idea 👾 A fast, transparent agent for the terminal", "TypeScript", 94.3, 4.7, 6, []string{"post-AI", "big"}, "", "", "", []string{"tui", "ai-agent", "llm", "node", "tree-sitter"}},
18+ {zn, "Zoea-Nova is a high-performance command center designed to orchestrate massive swarms of agents", "Go", 95.8, 3.1, 5, []string{"post-AI", "big", "backend"}, "", "", "", []string{"tui", "ai-agent", "sqlite"}},
19+ {cl, "Terminal comics from the AI coding build log", "Python", 97.4, 1.6, 2, []string{"post-AI", "small", "frontend", "backend"}, "", "", "", []string{"skills", "pytorch", "jekyll"}},
20+ {xc, "My space online.", "JavaScript", 3.6, 5.7, 3, []string{"pre-AI", "big", "frontend"}, "", "", "", []string{"node"}},
21+ {fn, "Node.js Module for ffmpeg library.", "JavaScript", 0, 34, 1, []string{"pre-AI", "small"}, "", "", "", []string{"node"}},
2222 },
2323 "Tree": map[string]any{
2424 "Head": Commit{mc, "a2174ac", "chore: pkg bump", "xonecas", "2026-10-02", ""},
internal/site/templates/components.html+6−1
@@ -26,6 +26,10 @@
2626 </span>
2727 {{end}}
2828
29+{{define "topic"}}{{/* a specific tag, from the project's dependencies and docs */}}
30+<span class="inline-flex items-center rounded-[2px] bg-empty px-1.5 py-px font-mono text-[12px] whitespace-nowrap">{{.}}</span>
31+{{end}}
32+
2933 {{define "project-row"}}
3034 <div class="@container"><a href="/projects/{{.El.Name}}/" class="grid grid-cols-[48px_1fr] @3xl:grid-cols-[48px_minmax(0,2fr)_6rem_minmax(0,2fr)_4rem_minmax(0,1.6fr)] gap-x-4 gap-y-1 items-center py-2 border-b border-line no-underline">
3135 {{template "element" (dict "El" .El "Size" "sm")}}
@@ -33,7 +37,8 @@
3337 <span class="hidden @3xl:block text-sm text-soft">{{.Lang}}</span>
3438 <div class="col-start-2 @3xl:col-start-auto relative h-3.5 bg-empty rounded-[2px]"><div class="absolute inset-y-0 min-w-1.5 rounded-[2px] bg-h{{.Heat}}" style="left:{{.From}}%;width:{{.Width}}%"></div></div>
3539 <b class="hidden @3xl:block text-right">{{.El.Weight}}</b>
36- <div class="col-start-2 @3xl:col-start-auto flex flex-wrap gap-1">{{range .Tags}}{{template "tag" .}}{{end}}</div>
40+ <div class="col-start-2 @3xl:col-start-auto flex flex-wrap gap-1">{{range .Tags}}{{template "tag" .}}{{end}}
41+ {{range $i, $t := .Topics}}{{if lt $i 4}}{{template "topic" $t}}{{end}}{{end}}{{if gt (len .Topics) 4}}<span class="px-1 py-px font-mono text-[12px] text-soft">+{{len (slice .Topics 4)}}</span>{{end}}</div>
3742 </a></div>
3843 {{end}}
3944
internal/site/templates/project.html+2−1
@@ -5,7 +5,8 @@
55 <div class="min-w-0">
66 <h1 class="text-4xl font-bold break-words">{{.P.Name}}</h1>
77 <p class="mt-1 text-lg">{{or .P.Description "No description"}}</p>
8- <div class="flex flex-wrap gap-1 mt-3">{{range .P.Tags}}{{template "tag" .}}{{end}}</div>
8+ <div class="flex flex-wrap gap-1 mt-3">{{range .P.Tags}}{{template "tag" .}}{{end}}
9+ {{range .P.Topics}}<a href="/projects/?q={{.}}" title="Projects about {{.}}" class="no-underline hover:outline outline-ink rounded-[2px]">{{template "topic" .}}</a>{{end}}</div>
910 <p class="mt-3 text-sm text-soft">
1011 <a href="commits/" class="text-ink"><b>{{.P.Commits}}</b> commits{{if ne .P.Commits .P.Total}} of {{.P.Total}}{{end}}</a> ·
1112 {{.P.First}} to {{.P.Last}} · {{.P.Files}} files
internal/site/templates/projects.html+1−1
@@ -15,7 +15,7 @@
1515 </div>
1616 </form>
1717 <ol id="rows">
18- {{range .Rows}}<li data-name="{{lower .El.Name}}" data-tags="{{range .Tags}}{{.}} {{end}}" data-first="{{.First}}" data-last="{{.Last}}" data-months="{{.Months}}" data-commits="{{.El.Weight}}">{{template "project-row" .}}</li>{{end}}
18+ {{range .Rows}}<li data-name="{{lower .El.Name}}" data-tags="{{range .Tags}}{{.}} {{end}}" data-topics="{{range .Topics}}{{.}} {{end}}" data-first="{{.First}}" data-last="{{.Last}}" data-months="{{.Months}}" data-commits="{{.El.Weight}}">{{template "project-row" .}}</li>{{end}}
1919 </ol>
2020 <p id="none" hidden class="py-6 text-soft">No project matches.</p>
2121 <nav class="pager" aria-label="Pages" hidden></nav>
internal/site/view.go+1−0
@@ -19,6 +19,7 @@ type ProjectRow struct {
1919 Tags []string
2020 First, Last string // dates of the first and last commit, for sorting
2121 Months string // every YYYY-MM with my commits, space-separated, for the date filter
22+ Topics []string
2223 }
2324
2425 // TreeEntry is one file or folder in a file tree, with its last commit.
tickets/1031-tags-need-to-be-much-more-specific-use.md+36−5
@@ -1,13 +1,14 @@
11 ---
22 id: 1031
3-title: Tags need to be much more specific. use dependencies files and other leads to augment this. Even keyworrds from readmes or agents/claudes.
4-type: bug
5-status: doing
3+title: Tags need to be much more specific. use dependencies files and other leads to augment this. Even keywords from readmes or agents/claudes.
4+type: feature
5+status: review
66 priority: p2
77 created: 2026-11-08T04:40:26Z
8-updated: 2026-11-08T04:42:03Z
8+updated: 2026-11-08T04:57:10Z
99 source: devnote
10-moves: 2026-11-08T04:42:03Z inbox doing drag
10+moves: 2026-11-08T04:42:03Z inbox doing drag; 2026-11-08T04:57:10Z doing review agent
11+area: site
1112 ---
1213
1314 ## Context
@@ -25,3 +26,33 @@ Filed from `http://192.168.122.10:8080/projects/`, on `span.inline-flex.items-ce
2526 > big
2627 > frontend
2728 > backend
29+
30+## Notes
31+
32+- 2026-11-08 04:50Z (agent): Triage: type feature (it was bug: today's tags are working as designed, this asks for more of them), area site, priority stays p2. Fixed the typo 'keyworrds' -> 'keywords'. Today every project gets the same 6 tags, from describe.go: pre-AI/post-AI, small/big, and frontend/backend from file names.
33+
34+- 2026-11-08 04:57Z (agent): Done: projects now get specific 'topics' alongside the 6 structural tags. 68 of 82 shown projects have at least one, 40 different topics in all. Examples: irvc gets webrtc websocket react tailwind vite gin sqlite docker. mini-coder gets tui ai-agent llm node tree-sitter. Old pre-AI projects get things like jquery, three.js, canvas and node.
35+
36+ How they're found (internal/project/topics.go): a curated vocabulary of 46 topics. Each topic has two patterns:
37+ - A code pattern, matched ignoring case against the dependency files (package.json, go.mod, requirements.txt, pyproject.toml, Gemfile, Cargo.toml, build.zig.zon, composer.json, bower.json, manifest.json), every path in the tree including vendored ones (jquery-1.4.4.js, three.min.js, node_modules/, SKILL.md, bun.lock, Dockerfile), and the repo's name.
38+ - A prose pattern, matched as written against the README, AGENTS.md and CLAUDE.md.
39+
40+ I chose a curated list over raw dependency names because raw names are mostly noise (@types/node, eslint, prettier). Utility libraries (zod, axios, testing) are left out on purpose.
41+
42+ Where they show:
43+ - The project page lists all topics as soft mono chips after the tags. Each chip links to /projects/?q=<topic>.
44+ - /projects rows show the first 4 and then '+N'.
45+ - The /projects search now also matches a whole topic, so 'sqlite' gives 7 projects.
46+ - Overrides accept topics too: 'tag <name> +react -vim'. The structural tags, pairs, element colours and filter chips are unchanged.
47+
48+ I tuned it against the real data. These matched wrongly and were tightened:
49+ - 'No Bun, no Deno' in mini-coder's README → bun now comes only from code.
50+ - 'Guidelines for AI agents working on this codebase' in AGENTS.md boilerplate → ai-agent prose is now 'coding agent', 'agent loop' and MCP.
51+ - 'CLI Flags' → cli needs 'a CLI', 'CLI tool' or 'command-line tool'.
52+ - 'macOS' in install notes → macos needs 'menu bar' or macotron.
53+
54+ Still without topics (14): rotator, NumberConversion, shapesaver, htmlKompressor, xonecas.github.com, js-algos, NameMaker, gen-one, jarvis, sinfo-talk, tictactoe, python-exercices, qr-code-maker, shell-greeting. They have no dependency files and no keywords from the list.
55+
56+ Files: internal/project/topics.go (new), files.go, describe.go (Info.Topics), overrides.go, project_test.go (TestMatchTopics, retag on topics); internal/site/view.go, rows.go, style.go, components.html ('topic'), project.html, projects.html, static/projects.js. data/projects.json is regenerated by 'make index' and isn't tracked.
57+
58+ Checked: go vet and go test pass. In agent-browser: irvc's page, /projects at 1440, bees-nest (14 topics) at 390 dark, no horizontal scroll at 390 on /, /projects/ and bees-nest. ?q=sqlite gives irvc orc-code symb mysis zoea-nova ollama-space-molt-player meal_tracker. Not checked: every one of the 68 lists by hand, only spot checks. Expect a few loose matches from READMEs, like 'game' or 'canvas'. Those can be fixed with tag overrides.
tickets/attachments/1031/-projects rows with topics.png+0−0
Binary file, not shown.
tickets/attachments/1031/irvc with its topics.png+0−0
Binary file, not shown.