# Museum Exhibit Studio - learner entrypoint.
#
# HOW TO EDIT THIS FILE
#
# Every place you write code is a named region between two marker lines:
#
#     >>> BEGIN <region> | Step 4: INSERT | Step 6: REPLACE
#     <<< END <region>
#
# The BEGIN line lists every step that touches the region. Each lesson block names its region
# and one of two actions:
#
#     INSERT   The region is empty. Paste the block between the two marker lines.
#     REPLACE  The region already has code. Delete everything between the marker lines,
#              then paste the block.
#
# A block is always the complete contents of its region. Never edit, move, or delete a marker
# line, and leave the code outside the regions as it is.
#
# The pre-built curator helpers live in curator.py, and the system messages in
# system_messages.py. Do not edit those files: they are the application-owned half of the
# workshop, and they must stay identical to the finished app's copy.

# >>> BEGIN imports | Steps 1-7: REPLACE
from __future__ import annotations

import asyncio
import sys

from curator import describe_failure
# <<< END imports


# >>> BEGIN exhibit-prompt | Step 4: INSERT | Step 6: REPLACE
# <<< END exhibit-prompt


# >>> BEGIN html-prompt | Step 7: INSERT
# <<< END html-prompt


# >>> BEGIN generation-config | Step 4: INSERT | Step 6: REPLACE
# <<< END generation-config


# >>> BEGIN research-config | Step 6: INSERT
# <<< END research-config


# >>> BEGIN html-config | Step 7: INSERT
# <<< END html-config


# >>> BEGIN session-runner | Step 4: INSERT
# <<< END session-runner


async def main() -> int:
    try:
        # >>> BEGIN banner | Step 1: REPLACE
        print("=== Museum Exhibit Studio starter ===")
        print("Pre-built curator helpers are ready in curator.py.")
        print("Continue with museum step 1 to write your first curator session.")
        # <<< END banner

        # >>> BEGIN choose-facts | Step 4: INSERT
        # <<< END choose-facts

        # >>> BEGIN research | Step 6: INSERT
        # <<< END research

        # >>> BEGIN generate | Step 1: INSERT | Steps 2-6: REPLACE
        # <<< END generate

        # >>> BEGIN validate | Step 5: INSERT
        # <<< END validate

        # >>> BEGIN sources | Step 6: INSERT
        # <<< END sources

        # >>> BEGIN exhibit-page | Step 7: INSERT
        # <<< END exhibit-page

        return 0
    except Exception as error:
        print(describe_failure(error), file=sys.stderr)
        return 1


if __name__ == "__main__":
    raise SystemExit(asyncio.run(main()))