2 Commits

Author	SHA1	Message	Date
justin	3b9cb4f874	fix(registry_gc): correct Gitea package API + add Cloudflare-friendly UA ... The script was hitting /api/v1/packages/{owner}/container/{name}/versions which doesn't exist (Gitea returns 404 — interpreting the request as a version named "versions"). Replaced with the actual endpoint /api/v1/packages/{owner}/container/{name} which returns the array of version rows directly. Delete path is now /api/v1/packages/{owner}/container/{name}/{version} (URL-encoded version string, not numeric ID). Refactored the keep-set: always preserve `latest`, top --keep-latest YYYY.MM.DD date tags AND top --keep-latest short-SHA tags (the rollback pins) by created_at desc. Anything within --keep-days is kept; older date/sha tags are deleted. sha256:* blob versions are skipped — Gitea's internal package GC reclaims them when their last tag goes away. Also added an explicit User-Agent header because git.jpaul.io sits behind Cloudflare, whose Bot Fight Mode 403s the default "Python-urllib/X.Y" UA with error code 1010. Affected run 104's GC step (curl was fine; urllib was blocked). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-22 13:44:42 -04:00
justin	9ba615c8ee	initial: docs-mcp-template — build guide + scaffolded server ... Template for building hosted MCP servers over a product's public documentation. Distilled from one production build; everything product-specific has been factored out. Contents: - PLAN.md — comprehensive build guide. 13 phases from project skeleton through weekly_digest. Includes the gotchas ("fetch-depth: 0 always", reranker per-pair token limit, Cloudflare body cap, dash-not-bash on Gitea runners), the decisions worth carrying forward, and a per-product customization checklist. - CLAUDE.md — guidance for Claude Code working in a clone of this template. Phase identification table, conventions (env-gating + operator confirmation for side-effecting tools, defensive fallback for retrieval components), common commands. - README.md — quick-start summary. Scaffolded code (all signature-stable, with NotImplementedError stubs where phase-specific work is required): docs_mcp/server.py FastMCP server, stateless_http=True, with search_docs / get_page / list_versions baseline tools and commented stubs for the rest of the phase set. docs_mcp/usage.py TimedCall telemetry, JSONL, daily rotation, 90-day retention. Reusable as-is. rag/embeddings.py Ollama embedder (nomic-embed-text default), load-balanced across N URLs. Reusable. rag/chunk.py Paragraph-aware chunker with synthetic chunk 0. Per-product tunable. rag/index.py Chroma + BM25 builder. --rebuild and --bm25-only flags. rag/bm25.py SQLite FTS5 lexical index. Reusable. scrape/changelog.py --cached / --ref / --json / --history-out. Reusable. scrape/README.md What you write per-product. eval/queries.jsonl.example Curate ~25 hand-labeled queries here. eval/retrievers.py Retriever protocol + stub classes. eval/run_eval.py MRR / Recall@K / nDCG@K harness skeleton. scripts/usage_report.py Standalone log analyzer; the FOLLOW-UP CHECKS pattern noted in the module docstring. scripts/registry_gc.py Gitea container registry cleanup. Reusable. Deployment + CI: Dockerfile Python 3.12-slim; COPY corpus + chroma + bm25 last for cache efficiency. deploy/docker-compose.yml MCP + reranker sidecar + Watchtower. Templated with <placeholders>. .gitea/workflows/refresh.yml Weekly cron + manual dispatch. fetch-depth: 0, retry-on-race, three-tag image scheme. .gitea/workflows/image-only.yml Code-only ship cycle, ~18min. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-22 09:18:17 -04:00