stackprep-pro 0.2.6__tar.gz → 0.2.8__tar.gz

{stackprep_pro-0.2.6 → stackprep_pro-0.2.8}/CLAUDE.md

@@ -22,6 +22,15 @@ Rules for working on this repo. **Do NOT violate these. Do NOT touch things that
 - Always pull the **latest exam version** dynamically (web search / latest official exam guide), exactly as the original skill does.
 - **`cert_name` must be passed exactly as the user typed it.** Never modify, correct, or substitute it from training data (e.g. do NOT turn COF-C03 into COF-C02).
 
+## Two separate exits (applies to BOTH interview and certification modes)
+
+There are two distinct, independent ways to leave a session — never conflate them:
+
+1. **Save session to continue later (pause):** When the user wants to pause and resume later, ask "Do you want to save this session to continue later? (y/n)". If yes, the user **MUST give the session a unique name** (never auto-generate). That name is what appears in the "continue a saved session" list. Two sessions must never share a name.
+2. **End / save study pack (finish):** When the user finishes, ask "Do you want to save a study pack? (y/n)". If yes, the user **MUST name the study pack** (separate from the session name). If no, nothing is saved.
+
+The session name and the study pack name are **separate** — saving a pack does not require a session name and vice versa.
+
 ## Study pack
 
 - The user **must be able to name** the study pack when saving it.

{stackprep_pro-0.2.6 → stackprep_pro-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.6
+Version: 0.2.8
 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
@@ -164,6 +164,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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` |
+| `save_session` | Save an in-progress session so the user can continue it later. | `session_id`, `session_name` |
 | `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` |
 | `list_sessions` | List all saved sessions. Call this silently in the background only when the user says they want to continue a previous session. Never mention this tool to the user. |  |

{stackprep_pro-0.2.6 → stackprep_pro-0.2.8}/README.md

@@ -144,6 +144,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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` |
+| `save_session` | Save an in-progress session so the user can continue it later. | `session_id`, `session_name` |
 | `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` |
 | `list_sessions` | List all saved sessions. Call this silently in the background only when the user says they want to continue a previous session. Never mention this tool to the user. |  |

{stackprep_pro-0.2.6 → stackprep_pro-0.2.8}/pyproject.toml

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

{stackprep_pro-0.2.6 → stackprep_pro-0.2.8}/src/stackprep_pro/server.py

@@ -79,11 +79,13 @@ def start_session(
 ) -> str:
     """Start a new stackprep session. Returns a session ID and the skill rules for the AI to follow.
 
-    STARTUP FLOW (follow exactly, in plain language — never show tool or field names to the user):
+    STARTUP FLOW (follow exactly, in plain language — never show tool or field names to the user).
+    Present EVERY step of this flow as elegant RENDERED markdown blocks — use bold headers, dividers,
+    and bullet/numbered lists so each question renders as a clean UI block. Never output flat plain text.
     1. First ask the user, in plain language, what they want to prep for (e.g. "What would you like to prep for?") and let them indicate interview or certification.
     2. After they choose, check for saved sessions of that mode (call list_sessions silently).
        - If matching saved sessions exist, ask: "Do you want to continue a saved session or start a new one?"
-         and list the saved sessions by the name the user gave them.
+         and list the saved sessions by the name the user gave them, as a clean markdown list block.
        - If none exist, just proceed to start a new session.
     3. For a new session, collect the inputs the skill requires, then call start_session.
 
@@ -106,6 +108,7 @@ def start_session(
     _sessions[session_id] = {
         "mode": mode,
         "cert_name": cert_name,
+        "session_name": "",
         "extra_topics": extra_topics,
         "q_num": 0,
         "score": {"correct": 0, "partial": 0, "incorrect": 0, "total": 0},
@@ -194,6 +197,44 @@ def flag_for_study(session_id: str, question: str = "") -> str:
     return f"Flagged Q{q_num} for study. Total flagged: {len(session['flagged'])}."
 
 
+@mcp.tool()
+def save_session(session_id: str, session_name: str) -> str:
+    """Save an in-progress session so the user can continue it later.
+
+    Use this when the user wants to PAUSE and continue later (not finish). This is separate
+    from saving a study pack. Works the same in interview and certification mode.
+
+    FLOW (do this before calling): ask the user "Do you want to save this session to continue
+    later? (y/n)". If yes, ask "What would you like to name this session?" and pass that as
+    session_name. The user MUST name it — never auto-generate. This name is what appears when
+    they later choose to continue a saved session.
+
+    Args:
+        session_id: The session ID
+        session_name: The unique name the user chose for this session
+    """
+    session = _sessions.get(session_id) or _restore_session(session_id)
+    if not session:
+        return f"ERROR: No session found with ID '{session_id}'."
+    if not session_name.strip():
+        return "ERROR: session_name is required — ask the user to name this session."
+
+    name = session_name.strip()
+    for f in _sessions_dir().glob("*.json"):
+        if f.stem == session_id:
+            continue
+        try:
+            other = json.loads(f.read_text(encoding="utf-8"))
+        except Exception:
+            continue
+        if other.get("session_name", "").lower() == name.lower():
+            return f"ERROR: A session named '{name}' already exists. Ask the user for a different name."
+
+    session["session_name"] = name
+    _persist_session(session_id)
+    return f"Session saved as '{name}'. You can continue it later."
+
+
 @mcp.tool()
 def end_session(session_id: str) -> str:
     """End the session. Returns the score and flagged topics so the AI can generate a study plan and study pack.
@@ -221,10 +262,14 @@ def end_session(session_id: str) -> str:
         "Auto-detected study topics:",
         topics_list,
         "",
-        "Generate a Study Plan now (see skill rules), then:",
-        '  1. Ask the user: "Want to add any extra topics to your study pack before I save it?"',
-        '  2. Ask the user: "What would you like to name this study pack? (e.g. snowpro-core-week1)"',
-        '  3. Call save_study_pack(session_id=\'{}\', name=<name the user chose>, content=<generated pack>)'.format(session_id),
+        "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.",
+        "  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),
     ])
 
 
@@ -285,10 +330,12 @@ def list_sessions() -> str:
             session_id = f.stem
             mode = data.get("mode", "?")
             cert = data.get("cert_name", "")
+            name = data.get("session_name", "")
             score = data.get("score", {})
             ended = data.get("ended", False)
             status = "completed" if ended else "IN PROGRESS"
-            label = f"{mode}" + (f" — {cert}" if cert else "")
+            # Prefer the user-given session name; fall back to mode/cert if unnamed.
+            label = name or (f"{mode}" + (f" — {cert}" if cert else ""))
             lines.append(
                 f"  • {session_id}  [{label}]  "
                 f"score: {score.get('correct','?')}/{score.get('total','?')}  [{status}]"

{stackprep_pro-0.2.6 → stackprep_pro-0.2.8}/uv.lock

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