stackprep-pro 0.2.9__tar.gz → 0.2.10__tar.gz

{stackprep_pro-0.2.9 → stackprep_pro-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.9
+Version: 0.2.10
 Summary: stackprep-pro — interview & certification prep MCP server for any AI client
 Project-URL: Homepage, https://github.com/youngpada1/stackprep-pro
 Project-URL: Repository, https://github.com/youngpada1/stackprep-pro
@@ -161,6 +161,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 
 | Tool | Description | Args |
 |---|---|---|
+| `begin` | Call this at the very start of every conversation. Returns the opening question already formatted |  |
 | `start_session` | Start a new stackprep session. Returns a session ID and the skill rules for the AI to follow. | `mode`, `cert_name`, `cv`, `jd`, `extra_topics` |
 | `submit_answer` | Record the result of an answered question. | `session_id`, `result`, `question` |
 | `flag_for_study` | Manually flag the current question for the study pack. | `session_id`, `question` |

{stackprep_pro-0.2.9 → stackprep_pro-0.2.10}/README.md

@@ -141,6 +141,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 
 | Tool | Description | Args |
 |---|---|---|
+| `begin` | Call this at the very start of every conversation. Returns the opening question already formatted |  |
 | `start_session` | Start a new stackprep session. Returns a session ID and the skill rules for the AI to follow. | `mode`, `cert_name`, `cv`, `jd`, `extra_topics` |
 | `submit_answer` | Record the result of an answered question. | `session_id`, `result`, `question` |
 | `flag_for_study` | Manually flag the current question for the study pack. | `session_id`, `question` |

{stackprep_pro-0.2.9 → stackprep_pro-0.2.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackprep-pro"
-version = "0.2.9"
+version = "0.2.10"
 description = "stackprep-pro — interview & certification prep MCP server for any AI client"
 readme = "README.md"
 license = { text = "MIT" }

{stackprep_pro-0.2.9 → stackprep_pro-0.2.10}/src/stackprep_pro/server.py

@@ -12,18 +12,26 @@ from mcp.server.fastmcp import FastMCP
 SERVER_INSTRUCTIONS = """\
 stackprep-pro — adaptive interview & certification prep.
 
-PRESENTATION (applies to EVERY message from the very first one, before and after a session starts):
-Always respond as elegant, RENDERED markdown blocks — use bold headers, dividers, and clean lists or
-tables so each step renders as a polished UI block. NEVER output flat plain text.
+At the very start of every conversation, call the `begin` tool and show its returned markdown to the
+user VERBATIM (it is already formatted as an elegant block — do not rephrase or reformat it).
 
-STARTUP FLOW (in plain human language — never show tool or field names to the user):
-1. Ask what they want to prep for (interview or certification), as a clean block.
-2. After they choose, silently check for saved sessions of that mode. If any exist, ask whether they
-   want to continue a saved session (list them by the name the user gave them) or start a new one.
-   If none exist, just start a new one.
-3. Collect the inputs the skill requires, then call start_session.
+PRESENTATION (every message): always respond as elegant RENDERED markdown blocks — bold headers,
+dividers, clean tables/lists. NEVER output flat plain text.
 
-Follow the skill rules returned by start_session exactly. The skill is the source of truth for behavior."""
+After the user picks a mode, silently check for saved sessions of that mode; if any exist offer to
+continue one (by the name the user gave it) or start new. Then collect inputs and call start_session.
+Follow the skill rules returned by start_session exactly — the skill is the source of truth."""
+
+# Hardcoded so the very first block is guaranteed, not AI-guessed.
+BEGIN_BLOCK = """\
+**What would you like to prep for?**
+
+| # | Mode |
+|---|------|
+| 1 | 🎯 Technical Interview |
+| 2 | 📜 Certification Exam |
+
+_Reply with 1 or 2._"""
 
 mcp = FastMCP("stackprep-pro", instructions=SERVER_INSTRUCTIONS)
 
@@ -85,6 +93,12 @@ def _load_skill(mode: str) -> str:
 
 # ── Tools ──────────────────────────────────────────────────────────────────────
 
+@mcp.tool()
+def begin() -> str:
+    """Call this at the very start of every conversation. Returns the opening question already formatted
+    as an elegant markdown block. Show the returned text to the user VERBATIM — do not rephrase or reformat it."""
+    return BEGIN_BLOCK
+
 @mcp.tool()
 def start_session(
     mode: str,

{stackprep_pro-0.2.9 → stackprep_pro-0.2.10}/uv.lock

@@ -723,7 +723,7 @@ wheels = [
 
 [[package]]
 name = "stackprep-pro"
-version = "0.2.9"
+version = "0.2.10"
 source = { editable = "." }
 dependencies = [
     { name = "mcp", extra = ["cli"] },