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

{stackprep_pro-0.2.9 → stackprep_pro-0.2.11}/.claude/settings.json

@@ -4,5 +4,12 @@
       "command": "uvx",
       "args": ["stackprep-pro"]
     }
+  },
+  "permissions": {
+    "allow": [
+      "mcp__stackprep",
+      "WebFetch",
+      "WebSearch"
+    ]
   }
 }

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.9
+Version: 0.2.11
 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.11}/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.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackprep-pro"
-version = "0.2.9"
+version = "0.2.11"
 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.11}/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,
@@ -265,7 +279,8 @@ def end_session(session_id: str) -> str:
     all_flagged = list(dict.fromkeys(session["auto_flagged"] + session["flagged"]))
     session["ended"] = True
     session["all_flagged"] = all_flagged
-    _persist_session(session_id)
+    # Do NOT auto-save the session here. It is only saved if the user explicitly
+    # chooses to, via save_session (with a name they provide).
 
     score = session["score"]
     topics_list = "\n".join(f"  • {t}" for t in all_flagged) if all_flagged else "  (none — full score!)"
@@ -279,13 +294,13 @@ def end_session(session_id: str) -> str:
         topics_list,
         "",
         "Now (this flow is identical for interview and certification mode):",
-        '  1. Ask the user: "Do you want to save a study pack from this session? (y/n)"',
-        "  2. If NO: stop here. Nothing is saved.",
+        '  1. Ask the user: "Do you want to save this session? (y/n)"',
+        "  2. If NO: stop here. Do NOT save anything — nothing is persisted.",
         "  3. If YES:",
-        '       a. Ask: "Want to add any extra topics to your study pack before I save it?"',
-        '       b. Ask: "What would you like to name this study pack? (e.g. snowpro-core-week1)"',
-        "       c. Generate the Study Plan and study pack (see skill rules).",
-        "       d. Call save_study_pack(session_id='{}', name=<pack name the user chose>, content=<generated pack>)".format(session_id),
+        '       a. Ask: "What would you like to name this session?" — the user MUST provide a name; never auto-generate one.',
+        "       b. Call save_session(session_id='{}', session_name=<name the user chose>)".format(session_id),
+        '       c. Then ask: "Do you want a study pack from this session too? (y/n)" — if yes, generate it and call'
+        " save_study_pack(session_id='{}', name=<pack name the user chose>, content=<generated pack>).".format(session_id),
     ])
 
 

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

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