boplog

A minimal, static build log for Kevin Rajan (kvnloo), backed by a checked-in snapshot of public GitHub repositories he has committed to.

Live (after Pages is enabled): https://kvnloo.github.io/boplog/

What is included

• Compact light-mode UI: featured rows, search, topic/year/format/sort filters, activity heatmap.
• Shareable URL state for active filters.
• Snapshot data under data/, regenerated from the GitHub API.
• Evidence-backed OSS contribution ledger, shareable scopes, and deterministic collectible badges. Locked badges state their public next condition; unlocks come only from merged upstream work or checked verifiedImpact receipts.
• No personal API key in the browser or in secrets — GitHub Actions uses the built-in GITHUB_TOKEN.
• Filter rule: include a repo only if kvnloo authored at least one commit (archive-only forks are dropped).
• Free CLI (boplog), local MCP server, OpenAPI, and agent discovery docs.

Local development

npm run sync    # needs GITHUB_TOKEN or `gh auth login`
npm run sync:oss
npm run check
npm run serve

Open http://localhost:4173.

Automatic sync

.github/workflows/sync-github.yml runs:

• every 15 minutes (cron: '*/15 * * * *')
• on manual workflow_dispatch

Each run:

1. Lists public repos owned by kvnloo
2. Keeps originals + forks only if you authored commits
3. Writes data/projects-YYYY.json, data/manifest.json, feed.xml, llms.txt, sitemap.xml
4. Validates, then commits + pushes if anything changed

Rate limit budget: Actions GITHUB_TOKEN allows 1,000 req/hour for this repo. A full authorship pass over ~360 repos is a few hundred calls — fine at 15‑minute cadence, especially with concurrency and skips for empty/error forks.

Project data shape

{
  "id": "cod",
  "name": "cod",
  "description": "...",
  "date": "2026-07-29",
  "url": "https://github.com/kvnloo/cod",
  "types": ["public"],
  "formats": [],
  "categories": ["dev"],
  "featured": true,
  "featuredRank": 1
}

Featured projects are pinned via data/featured.json, then filled by stars/recency.

OSS contribution data

data/oss-contributions.json is generated server-side and contains explicit canonical_upstream, contributor_fork, and owned relationships. Pull requests distinguish merged, open_ready, open_draft, and closed_unmerged using mergedAt; issues use open or closed. data/oss-scopes.json versions neutral selected-community groups, including zero-count repositories. data/oss-verified-impact.json is the small checked evidence ledger; allowed receipts are merged_pr, accepted_fix, reproduction_used, and substantive_review_used, each with an exact public GitHub URL. Search-cap limitations are recorded rather than hidden.

Parallel surface: interactive portfolio

The same public project information is also presented as a 3D shop (Kevin’s Ramen & Boba):

Surface	URL
This build log (archive UI)	https://kvnloo.github.io/boplog/
Interactive shop	https://kvnloo.github.io/portfolio/demos/room/
Portfolio site	https://kvnloo.github.io/portfolio/

data/manifest.json includes surfaces.interactivePortfolio (and data/surfaces.json) so agents/UIs can discover the shop without hardcoding. The portfolio repo generates demos/room menu props from this data via scripts/sync-shop-from-boplog.mjs (scene map + boplog year files).

Deployment

Enable GitHub Pages for this repo (Settings → Pages → Deploy from branch main / root, or GitHub Actions). Paths are relative so project Pages at /boplog/ work.

License

See LICENSE.