xonecas.io
8356
Wx

www-xonecas-io / files

www-xonecas-io / tickets / 1005-generate-project-metadata-and-tags-with.md

4.7 KB
1---
2id: 1005
3title: Generate project metadata and tags, with overrides
4type: feature
5status: done
6priority: p1
7area: data
8created: 2026-11-07T19:30:00Z
9updated: 2026-11-08T03:58:12Z
10source: agent
11moves: 2026-11-07T19:30:00Z inbox todo agent; 2026-11-08T01:09:34Z todo doing drag; 2026-11-08T01:28:52Z doing review agent; 2026-11-08T03:58:12Z review done drag
12---
13
14Compute for each project: dates, commit counts, languages, stars at import time, sources, README, and tags. Tags are generated from git, with a small override file for what heuristics get wrong.
15
16Proposed rules, with results in repos.md on 1000:
17- pre-AI / post-AI: post-AI if the repo has an AI instruction file or AI commit trailer, or starts on or after 2025-09-05 (the-champs-timer's AGENTS.md, the earliest found). 51 pre, 31 post.
18- small / big: big is 50+ of your commits. 70 small, 12 big.
19- frontend / backend: file names only, and they misfire (clanker-and-the-dev gets both). Expect overrides.
20
21Needs from xonecas:
221. Are the cutoff and the 50-commit line right?
232. Forks: 20 in total, 11 with none of your commits, 9 with 1 or 2. I recommend hiding all of them, since they hold other people's history.
243. Hide these? githubstopannoyingme (empty), hirenimble-challenge and sesame-labs-coding-assignment (coding tests, public today). I recommend hiding the empty one and keeping the other two unless you object.
254. Commit emails include past work domains. They are already public in git, but I recommend the site shows author names only.
26
27Done when: one data file drives all pages, and every project has exactly one of pre-AI or post-AI and one of small or big.
28
29## Notes
30
31- 2026-11-08 01:11Z (agent): Decision from xonecas (terminal): accept all recommendations. Post-AI cutoff 2025-09-05 (or an AI file or trailer), big is 50+ of your commits, hide all 20 forks, hide only githubstopannoyingme, show author names only.
32
33- 2026-11-08 01:28Z (agent): Done: 'make index' writes data/projects.json, the one data file 'site build' reads. Every project has exactly one of pre-AI/post-AI and one of small/big.
34  
35  RESULT: 103 projects, 81 shown. Hidden: 20 forks, 1 empty (githubstopannoyingme) and irvc (see CHOICE). Before irvc was hidden, the tag counts matched repos.md on 1000 exactly: 82 shown, 51 pre-AI / 31 post-AI, 70 small / 12 big. 14 shown projects have no README.
36  
37  WHAT EACH PROJECT HAS (internal/project): description, the first and last of your commits, your commits and everyone's, your commits per month (for the heat walls), stars, file count, languages by bytes (5% and up), the README path, tags, and why it is hidden.
38  - Your commits are author names xonecas, sacenox, Sean, Sean Martin or Sean Caetano Martin, in any case, with each hash counted once across sources. Five repos are authored as lowercase 'sean'. Emails are never read, so the data holds names only.
39  - post-AI: an AI instruction file anywhere in the history (AGENTS.md, CLAUDE.md, .cursorrules and similar), an AI co-author trailer, or a first commit on or after 2025-09-05. big: 50+ of your commits. frontend and backend come from file names in the default branch, skipping node_modules, vendor and dist.
40  - Stars, the fork flag and descriptions come from the GitHub and GitLab APIs. 'site import' saves them to data/meta.json in 3 requests. With no description, the first line of prose in the README is used, with Markdown links stripped.
41  - overrides.txt gains 'hide', 'show' and 'tag <name> +x -y'. Dropping pre-AI, post-AI, small or big is refused, so the one-of-each rule holds.
42  
43  DIFFERENCES FROM repos.md:
44  - dotfiles has 101 commits, not 96, because 5 were pushed since 1000. The total is now 2,775.
45  - backend: I dropped the misfires that came from package.json-style guesses: startsInvasion, fractal-tree, particle-play, simple-flask-coffee-sass-boilerplate, i3wm-background-desktop-script, cel-tui, diff-scope, tiny-c-agent and mini-coding-agent (TUIs and CLIs). Added: meal_tracker (Django: manage.py, wsgi.py). sacenox.github.io would have read as backend from a docker-compose.yml, so an override drops it.
46  - Language is now by bytes from git rather than the hosts' guess, so 9 projects differ. For example dotfiles is Lua (the nvim config), dotfiles-2014 and dotfiles-2020 are Python, and xonecas.com is HTML. If you want the hosts' language back, that needs your call.
47  
48  CHOICE I MADE (easy to change): 'hide irvc' in overrides.txt, following your note on 1001 ('Dont advertise irvc'). Delete that line to list it.
49  
50  CHECKED: unit tests for tag rules, overrides, grouping and the build, which skips hidden projects. I diffed the data against repos.md row by row, and grepped the data file for email addresses (none).
51  NOT CHECKED: tags by hand for each project. The frontend/backend rules are heuristics, as expected.