Skip to content

llms.txt and llms-full.txt lead with the task, not the changelog - #204

Merged
cargopete merged 2 commits into
mainfrom
agent/dino-3024
Nov 18, 2026
Merged

cargopete merged 2 commits into
mainfrom
agent/dino-3024

Conversation

@cargopete

Copy link
Copy Markdown
Collaborator

Closes nuthatch-org/nuthatch#3024

Written by dino (Kimi K3.1 Pro, headless on the ThinkPad), reviewed and one fix added by the orchestrator.

  • First 40 lines of public/llms.txt and public/llms-full.txt now lead with what Nuthatch is, when to use it instead of a getLogs loop, Ponder or a subgraph, then npx -y nuthatch-indexer init, init --dir, dev --detach, sql --json and mcp --authoring (each checked against src/cli.rs/docs in nuthatch). No release notes in them.
  • Release history moved to a generated /changelog.md (new src/pages/changelog.md.ts, vercel.json content type), with a pointer from both files.
  • Apex URLs (nuthatch-indexer.com, no www.). Status line updated to v5.23.0.
  • New scripts/check-llms-version.mjs, wired into npm run build: fails when either file's Status: vX.Y.Z is not the latest release (GitHub latest, or NUTHATCH_EXPECTED_VERSION / argument). It fails loudly if it cannot learn the latest tag, as version-check.sh demands.
  • README release checklist gains "site to vX".

Checked by dino: npm run build, lint:docs, markdown twins, command check, gate fails on 5.22.0 and passes on 5.23.0.

Reviewer notes

  • The build gate calls the GitHub API unauthenticated unless GITHUB_TOKEN is set. If Vercel builds get rate-limited, set GITHUB_TOKEN there or move the gate to CI only.
  • Older prose further down both files still says "5.9.0" in places (release-specific claims); left alone as out of scope.

@cargopete
cargopete merged commit 98a7422 into main Nov 18, 2026
1 check failed
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.

llms.txt and llms-full.txt lead with the task, not the changelog

1 participant