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.