stackprep-pro 0.2.22__py3-none-any.whl → 0.2.25__py3-none-any.whl

stackprep_pro/server.py

@@ -19,11 +19,17 @@ PRESENTATION (every message): always respond as elegant RENDERED markdown blocks
 dividers, clean tables/lists. NEVER output flat plain text.
 
 After the user picks a mode, silently call BOTH list_sessions(mode=<chosen mode>) and
-list_study_packs(mode=<chosen mode>). Then show ONE single "What would you like to do?" block — a single
-numbered table — listing, as rows: each saved session to continue (by its name), each saved study pack to
-open (by its name), and a final "Start a brand-new prep" row. Do NOT show separate "saved sessions" and
-"saved study packs" tables on top of the options table — only the one combined options table. The user
-replies with a number. Collect inputs and call start_session.
+list_study_packs(mode=<chosen mode>).
+
+- If there are NO saved sessions AND NO saved study packs for that mode: do NOT ask anything about
+  continuing or opening — go straight to collecting inputs and starting a brand-new session.
+- Only if there IS at least one saved session or study pack: show ONE single "What would you like to do?"
+  block — a single numbered table listing each saved session to continue (by its name), each saved study
+  pack to open (by its name), and a final "Start a brand-new prep" row. Do NOT show separate "saved
+  sessions" / "saved study packs" tables on top of it — only the one combined options table.
+
+Never show empty tables or "none found" messages to the user. The user replies with a number (when a table
+is shown). 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.
@@ -296,6 +302,33 @@ def save_session(session_id: str, session_name: str) -> str:
     return f"Session saved as '{name}'. You can continue it later."
 
 
+@mcp.tool()
+def exit_session(session_id: str) -> str:
+    """ALWAYS call this the moment the user wants to leave a session in progress — any of: "exit", "quit",
+    "stop", "leave", "X", "done for now", "bye", "that's enough". Do NOT end the conversation yourself on an
+    exit intent; call this first and relay its instructions. It returns the exact save prompt to show.
+
+    Args:
+        session_id: The session ID
+    """
+    session = _sessions.get(session_id) or _restore_session(session_id)
+    if not session:
+        return f"ERROR: No session found with ID '{session_id}'."
+
+    score = session.get("score", {})
+    return "\n".join([
+        "=== EXIT REQUESTED — you MUST ask this before ending ===",
+        f"Progress so far: {score.get('correct','?')}/{score.get('total','?')}.",
+        "",
+        'Ask the user, exactly: "Do you want to save this session so you can continue later? (y/n)"',
+        "  - If YES: ask \"What would you like to name this session?\" (the user MUST provide the name — never",
+        "    auto-generate). Then call save_session(session_id='{}', session_name=<name>). It stays resumable.".format(session_id),
+        "  - If NO: call discard_session(session_id='{}'). It is permanently deleted and won't appear later.".format(session_id),
+        "",
+        "Do NOT skip this question. Do NOT end the conversation until the user has answered y or n.",
+    ])
+
+
 @mcp.tool()
 def discard_session(session_id: str) -> str:
     """Permanently delete a session. Call this when the user is exiting and answers NO to saving the

stackprep_pro/skills/certification.md

@@ -10,7 +10,8 @@ Adaptive certification exam prep — one question at a time, with instant feedba
 ## ⛔ EXIT RULE (READ FIRST — NEVER SKIP)
 
 The instant the user says ANYTHING meaning they want to stop — "exit", "quit", "stop", "leave", "X",
-"done for now", "bye", "that's enough" — you MUST NOT just end the conversation. You MUST first ask:
+"done for now", "bye", "that's enough" — you MUST NOT just end the conversation. You MUST FIRST call the
+`exit_session(session_id)` tool and follow the instructions it returns. Those instructions are:
 
 > "Do you want to save this session so you can continue later? (y/n)"
 
@@ -18,7 +19,7 @@ The instant the user says ANYTHING meaning they want to stop — "exit", "quit",
   then call `save_session(session_id, session_name=<that name>)`. It stays resumable under that name.
 - **No** → call `discard_session(session_id)` to permanently delete it, then end. It will NOT appear later.
 
-This is mandatory EVERY time, no matter how few questions were answered.
+This is mandatory EVERY time, no matter how few questions were answered. Never skip calling `exit_session`.
 
 ## Session setup
 

stackprep_pro/skills/interview.md

@@ -10,7 +10,8 @@ Adaptive technical interview prep — one question at a time, with instant feedb
 ## ⛔ EXIT RULE (READ FIRST — NEVER SKIP)
 
 The instant the user says ANYTHING meaning they want to stop — "exit", "quit", "stop", "leave", "X",
-"done for now", "bye", "that's enough" — you MUST NOT just end the conversation. You MUST first ask:
+"done for now", "bye", "that's enough" — you MUST NOT just end the conversation. You MUST FIRST call the
+`exit_session(session_id)` tool and follow the instructions it returns. Those instructions are:
 
 > "Do you want to save this session so you can continue later? (y/n)"
 
@@ -18,7 +19,7 @@ The instant the user says ANYTHING meaning they want to stop — "exit", "quit",
   then call `save_session(session_id, session_name=<that name>)`. It stays resumable under that name.
 - **No** → call `discard_session(session_id)` to permanently delete it, then end. It will NOT appear later.
 
-This is mandatory EVERY time, no matter how few questions were answered.
+This is mandatory EVERY time, no matter how few questions were answered. Never skip calling `exit_session`.
 
 ## Session setup
 

{stackprep_pro-0.2.22.dist-info → stackprep_pro-0.2.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.22
+Version: 0.2.25
 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
@@ -52,11 +52,28 @@ uvx stackprep-pro
 
 ## Configure your MCP client
 
-The config is the same for every client — just point to `uvx stackprep-pro`.
+The config is the same for every client — just point to `uvx stackprep-pro`. No API keys, no
+authentication, no accounts — stackprep stores everything as plain files on your own machine.
+
+> **Prerequisite:** install [uv](https://docs.astral.sh/uv/) (it provides `uvx`):
+> ```bash
+> curl -LsSf https://astral.sh/uv/install.sh | sh
+> ```
 
 ### Claude Code
 
-Create `.mcp.json` in your project root:
+**Recommended — register it globally** so it works from any directory (the normal way you'd use it):
+
+```bash
+claude mcp add stackprep --scope user -- uvx stackprep-pro
+```
+
+Then launch Claude Code from anywhere with `claude` and type `start`.
+
+<details>
+<summary>Alternative: per-project config</summary>
+
+If you'd rather scope it to a single project, create `.mcp.json` in that project's root instead:
 
 ```json
 {
@@ -68,10 +85,11 @@ Create `.mcp.json` in your project root:
   }
 }
 ```
+</details>
 
 ### Cursor
 
-Create `~/.cursor/mcp.json`:
+Create `~/.cursor/mcp.json` (global — works from any directory):
 
 ```json
 {
@@ -166,6 +184,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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` |
 | `save_session` | Save an in-progress session so the user can continue it later. | `session_id`, `session_name` |
+| `exit_session` | ALWAYS call this the moment the user wants to leave a session in progress — any of: "exit", "quit", | `session_id` |
 | `discard_session` | Permanently delete a session. Call this when the user is exiting and answers NO to saving the | `session_id` |
 | `end_session` | End the session. Returns the score and flagged topics so the AI can generate a study plan and study pack. | `session_id` |
 | `save_study_pack` | Save the study pack content to disk. | `session_id`, `name`, `content` |

stackprep_pro-0.2.25.dist-info/RECORD

@@ -0,0 +1,8 @@
+stackprep_pro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stackprep_pro/server.py,sha256=mKbs6e3Zm9x50M6EgY2jkqPNm4C0liZHv-3b7NkQpk0,22549
+stackprep_pro/skills/certification.md,sha256=VjkA7O3RjNoM0_MpSKD_2mORRDnNLxGdSdTioZ9xoI4,6859
+stackprep_pro/skills/interview.md,sha256=pouK-9ZMiPx3JQGiWkOTGT62aN4BsVF0OXzd9AIU6fs,6839
+stackprep_pro-0.2.25.dist-info/METADATA,sha256=J1Y3rJHZ4Rx8yUA1yOCSYP0VkdRKPqTvM5gCGNPQIuQ,8898
+stackprep_pro-0.2.25.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+stackprep_pro-0.2.25.dist-info/entry_points.txt,sha256=DGlPLlB4ZCqcNBs8PVMfOR8iklxbucEeIFvaECa_XuA,60
+stackprep_pro-0.2.25.dist-info/RECORD,,

{stackprep_pro-0.2.22.dist-info → stackprep_pro-0.2.25.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any

stackprep_pro-0.2.22.dist-info/RECORD

@@ -1,8 +0,0 @@
-stackprep_pro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-stackprep_pro/server.py,sha256=h04Z3oiP4Gi-nZEWfZSQ63747bLVwTHWzWXI8vfva88,20822
-stackprep_pro/skills/certification.md,sha256=XeDicaQyRVC5PeV0eawwkb31SIylOVG7DqAWtIOBlNs,6724
-stackprep_pro/skills/interview.md,sha256=G2debQDqIU-UpIfRbjKwalx9_4dZrr1BwjZi5F2VMRo,6704
-stackprep_pro-0.2.22.dist-info/METADATA,sha256=Bu1rGesWhn-9X8ON8bMY4RCuxr-r9F372YFQrH420ME,8085
-stackprep_pro-0.2.22.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-stackprep_pro-0.2.22.dist-info/entry_points.txt,sha256=DGlPLlB4ZCqcNBs8PVMfOR8iklxbucEeIFvaECa_XuA,60
-stackprep_pro-0.2.22.dist-info/RECORD,,