docs: AI pipeline hardening plan + rename giteaService -> githubService #1

Merged
rve merged 1 commits from feat/ai-pipeline-hardening-plan into main 2026-05-20 10:09:40 +00:00
Owner

Summary

  • Adds AI_PIPELINE_HARDENING_PLAN.md -- a phased, self-contained plan an AI agent can execute end-to-end to harden the Anthropic integration. Six phases: central LLM client + robust parsing -> prompt caching & tool-based structured outputs -> extraction quality (overlap chunking, stateful IDs, adaptive throttle, unified relation vocab) -> quiz quality (Fisher-Yates, debiased correctIndex, difficulty field, dedup) -> R42 retrieval & telemetry (TF-IDF, lookup_topic tool, llm_calls collection) -> eval harness.
  • Renames src/lib/giteaService.js -> src/lib/githubService.js. The module actually calls api.github.com / raw.githubusercontent.com; the previous name was misleading. Updates the single import site in src/components/admin/KnowledgeGraph.jsx. No behaviour change.

Test plan

  • npm run lint clean
  • npm run build succeeds
  • Admin > Knowledge Graph > Sync Handbook still pulls files from respellion/employee-handbook on GitHub
  • Plan doc renders correctly on the Gitea repo browser

Generated with Claude Code.

## Summary - Adds `AI_PIPELINE_HARDENING_PLAN.md` -- a phased, self-contained plan an AI agent can execute end-to-end to harden the Anthropic integration. Six phases: central LLM client + robust parsing -> prompt caching & tool-based structured outputs -> extraction quality (overlap chunking, stateful IDs, adaptive throttle, unified relation vocab) -> quiz quality (Fisher-Yates, debiased correctIndex, difficulty field, dedup) -> R42 retrieval & telemetry (TF-IDF, `lookup_topic` tool, `llm_calls` collection) -> eval harness. - Renames `src/lib/giteaService.js` -> `src/lib/githubService.js`. The module actually calls `api.github.com` / `raw.githubusercontent.com`; the previous name was misleading. Updates the single import site in `src/components/admin/KnowledgeGraph.jsx`. No behaviour change. ## Test plan - [ ] `npm run lint` clean - [ ] `npm run build` succeeds - [ ] Admin > Knowledge Graph > Sync Handbook still pulls files from `respellion/employee-handbook` on GitHub - [ ] Plan doc renders correctly on the Gitea repo browser Generated with Claude Code.
rve added 1 commit 2026-05-20 10:07:43 +00:00
docs: add AI pipeline hardening plan; rename giteaService to githubService
All checks were successful
On Pull Request to Main / test (pull_request) Successful in 30s
On Pull Request to Main / publish (pull_request) Successful in 58s
On Pull Request to Main / deploy-dev (pull_request) Successful in 1m35s
db5bb854c3
Adds AI_PIPELINE_HARDENING_PLAN.md — a phased, self-contained plan an AI
agent can execute to harden the Anthropic integration (central LLM
client, tool-based structured outputs, prompt caching, retrieval-based
R42 context, eval harness).

Renames src/lib/giteaService.js to src/lib/githubService.js. The module
calls api.github.com and raw.githubusercontent.com; the previous name
was misleading. No behaviour change. Updates the single import site in
src/components/admin/KnowledgeGraph.jsx.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
rve changed title from docs: AI pipeline hardening plan + rename giteaService ? githubService to docs: AI pipeline hardening plan + rename giteaService -> githubService 2026-05-20 10:08:13 +00:00
rve merged commit d07d15b2a7 into main 2026-05-20 10:09:40 +00:00
rve deleted branch feat/ai-pipeline-hardening-plan 2026-05-20 10:09:41 +00:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rve/learning-platform#1