stackprep-pro 0.2.22__tar.gz → 0.2.25__tar.gz

{stackprep_pro-0.2.22 → stackprep_pro-0.2.25}/.github/workflows/publish.yml

@@ -49,3 +49,5 @@ jobs:
       - name: Publish to PyPI
         if: steps.tag_check.outputs.EXISTS == 'false'
         uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: false

{stackprep_pro-0.2.22 → stackprep_pro-0.2.25}/PKG-INFO

@@ -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.22 → stackprep_pro-0.2.25}/README.md

@@ -32,11 +32,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
 {
@@ -48,10 +65,11 @@ Create `.mcp.json` in your project root:
   }
 }
 ```
+</details>
 
 ### Cursor
 
-Create `~/.cursor/mcp.json`:
+Create `~/.cursor/mcp.json` (global — works from any directory):
 
 ```json
 {
@@ -146,6 +164,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.22 → stackprep_pro-0.2.25}/pyproject.toml

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

{stackprep_pro-0.2.22 → stackprep_pro-0.2.25}/scripts/generate_readme.py

@@ -98,11 +98,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
 {{
@@ -114,10 +131,11 @@ Create `.mcp.json` in your project root:
   }}
 }}
 ```
+</details>
 
 ### Cursor
 
-Create `~/.cursor/mcp.json`:
+Create `~/.cursor/mcp.json` (global — works from any directory):
 
 ```json
 {{

{stackprep_pro-0.2.22 → stackprep_pro-0.2.25}/src/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-0.2.22 → stackprep_pro-0.2.25}/src/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-0.2.22 → stackprep_pro-0.2.25}/src/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 → stackprep_pro-0.2.25}/uv.lock

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