xonecas.io
8356
Wx

www-xonecas-io / files

www-xonecas-io / tickets / 1031-tags-need-to-be-much-more-specific-use.md

4.0 KB
1---
2id: 1031
3title: Tags need to be much more specific. use dependencies files and other leads to augment this. Even keywords from readmes or agents/claudes.
4type: feature
5status: done
6priority: p2
7created: 2026-11-08T04:40:26Z
8updated: 2026-11-08T20:16:23Z
9source: devnote
10moves: 2026-11-08T04:42:03Z inbox doing drag; 2026-11-08T04:57:10Z doing review agent; 2026-11-08T20:16:23Z review done drag
11area: site
12---
13
14## Context
15
16Filed from `http://192.168.122.10:8080/projects/`, on `span.inline-flex.items-center.gap-1.5`.
17
18> 80
19> 58
20> Ir
21> irvc
22> A WebRTC-powered private text and voice chat. Self-hosted: Go + SQLite backend, React frontend, LiveKit for voice and screen share.
23> TypeScript
24> 58
25> post-AI
26> big
27> frontend
28> 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.