Skip to content

refactor(sitemaps): promote global seed to top-level sitemaps/#1826

Merged
jackwener merged 1 commit into
mainfrom
refactor/sitemaps-top-level
Jun 2, 2026
Merged

refactor(sitemaps): promote global seed to top-level sitemaps/#1826
jackwener merged 1 commit into
mainfrom
refactor/sitemaps-top-level

Conversation

@jackwener
Copy link
Copy Markdown
Owner

Summary

Per @WAWQAQ's discoverability question — the global seed was buried 5 levels deep at skills/opencli-sitemap-author/references/site-memory/<site>/sitemap/. Move to top-level sitemaps/<site>/ to make Site Maps Hub a first-class repo citizen, parallel to clis/, skills/, docs/.

Why now

Only 2 seeds (twitter, hackernews) exist today. Migration cost is minimal. Doing this after dozens of Phase 2 seeds land would be far worse.

Changes

  • git mv twitter + hackernews seeds to sitemaps/<site>/
  • Flatten the inner sitemap/ subdirectory (now redundant — top-level sitemaps/ already disambiguates)
  • sitemapPathsForSite in src/cli.ts: globalBase changed to <packageRoot>/sitemaps/<site>/
  • src/cli.test.ts: test path updated, 3 unit tests pass
  • opencli-sitemap-author/SKILL.md: Storage Model section
  • opencli-browser-sitemap/SKILL.md: Lookup Order section

Local overlay path (~/.opencli/sites/<site>/sitemap/) is unchanged.

After this lands

@opencli-user starts Phase 2 seed expansion at the new path. @opencli-user and I drafted a 21-site Tier 1 list + claim protocol in the design thread (#OpenCLI:3e19f061), pending @WAWQAQ pace/breadth/parallelism call.

Test plan

  • npm run docs:build clean
  • vitest run src/cli.test.ts -t "resolveSitemapAvailabilityForUrl" — 3 tests pass
  • CI green

Per @WAWQAQ discoverability question — `skills/opencli-sitemap-author/references/site-memory/<site>/sitemap/` is buried 5 levels deep. Move to top-level `sitemaps/<site>/` to make Site Maps Hub a first-class repo citizen, parallel to `clis/`, `skills/`, `docs/`.

Why now: only 2 seeds (twitter, hackernews) so migration cost is minimal. Doing this after dozens of seeds land would be far worse.

Changes:
- `git mv` twitter + hackernews seeds to `sitemaps/<site>/`
- Flatten the inner `sitemap/` subdirectory (now redundant — top-level
  `sitemaps/` already disambiguates)
- `sitemapPathsForSite` in src/cli.ts: globalBase changed to
  `<packageRoot>/sitemaps/<site>/`
- src/cli.test.ts: test path updated
- opencli-sitemap-author SKILL.md: Storage Model section
- opencli-browser-sitemap SKILL.md: Lookup Order section

Local overlay path (`~/.opencli/sites/<site>/sitemap/`) is unchanged.
@jackwener jackwener merged commit 53d62b0 into main Jun 2, 2026
11 checks passed
@jackwener jackwener deleted the refactor/sitemaps-top-level branch June 2, 2026 09:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant