Prepare a Runestone CodeTailor version optimized for production (initial attempt)

[xinyinghou]

This PR introduces a Runestone-specific CodeTailor version (codetailor-runestone-ver) based on the latest upstream main branch.

Note:

• This is an initial attempt, expect follow-ups and discussions.
• PR 28 in overview book added questions for dev testing.
• Additional packages are added in pyproject.toml

Runestone-specific version:

• Added CodeTailor modules under book_server_api
  • coach.py
    • In dev mode: coach.py will require a DEV_API key for testing.
    • In production: coach.py will use an instructor-provided API key via fetch_api_token (real service).
    • Can link to instructor-provided Parsons example, this testing blocked in dev mode since question DB isn’t available.
  • personalize_parsons
    • Enable LLM to supply an example solution when no predefined one exists.
    • Remove LLM generation time limit to reduce serving with guardrails
    • Add paired distractors for both two personalization levels
    • Use zero-shot prompting so no extra information is needed
• Added CodeTailor modules under activecode component
  • Only keep two additional specs:
    • :parsonspersonalize: moveable or partial (required)
    • :parsonsexample: id of an existing Parsons problem (optional)
• Added CodeTailor modules under parsons component
  • Added new files for block-level personalization
  • Included an automatically-added spec :scaffolding: to separate scaffolding puzzle code

[bnmnetp]

OK, the good news.

1. It does not appear as though your changes break anything about current activecode or parsons problems

However I can't test any further.

1. Please structure your changes to the overview book like a chapter so that it appears in the table of contents.
2. the book server crashes when I finally figured out how to navigate my wat to the samples. It is missing the openai and I'm guessing javlang modules
3. You should be able to fully test this in a working docker environment. When you have done that please submit your updates.

The documentation for build and running and rebuilding containers is all on https://runestone-monorepo.readthedocs.io/en/latest/

[bnmnetp]

It is good to have these here, but they also need to be added to the pyproject.toml file in the book project.

[xinyinghou]

Thanks, are those the two places to add the new packages? Or is there more places I need to include these two new packages?

[bnmnetp]

Any of the servers that need those libraries need to be updated. I think it is just the book server that you are using to interface to openai.

[bnmnetp]

I also noticed that when it crashed the book server the web page spinner just kept spinning and giving me encouraging messages. You should detect a failure and give an appropriate message to the user.

[xinyinghou]

Yes, I only require them in the book server. I am adding it to the pyproject.toml there

[xinyinghou]

Okay, I will change it to an error message to the user. I am setting it as either resolve when the backend responds, or reject and send an error message if it takes longer than 1 minute.

[bnmnetp]

Add a comment to keep @barbarer in the loop.