stackprep-pro 0.2.5__py3-none-any.whl → 0.2.7__py3-none-any.whl

stackprep_pro/server.py

@@ -80,7 +80,7 @@ def start_session(
     """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):
-    1. First ask: "Are you prepping for a technical interview or a certification exam?"
+    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.
@@ -106,6 +106,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 +195,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 +260,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 +328,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/skills/certification.md

@@ -9,11 +9,33 @@ Adaptive certification exam prep — one question at a time, with instant feedba
 
 ## Session setup
 
-Inputs arrive via MCP (certification name, extra topics). Give a short 2–3 line summary:
-- Exam structure overview
-- Key domains and weightings from the latest official exam guide
+Inputs arrive via MCP (certification name, extra topics). After looking up the latest official exam guide, present a clean, structured overview in this exact layout:
 
-Then wait — questions are requested one at a time via `next_question`.
+```
+[Cert name + code] — confirmed active as of [date] (replaces [prev version] if applicable).
+
+**Exam structure:**
+— [N] questions | [time] min | Passing: [score] | [price] via [provider]
+
+**Domains & weightings:**
+
+| Domain                                   | Weight |
+|------------------------------------------|--------|
+| [Domain 1]                               | [X]%   |
+| [Domain 2]                               | [X]%   |
+| ...                                      | ...    |
+
+**Notable [version] additions:** [short note on what's new, if applicable].
+
+**Sources:**
+— [Title] ([url])
+— [Title] ([url])
+
+---
+Ready when you are — first question?
+```
+
+Then wait — questions are requested one at a time.
 
 ## Question format
 

stackprep_pro/skills/interview.md

@@ -9,12 +9,29 @@ Adaptive technical interview prep — one question at a time, with instant feedb
 
 ## Session setup
 
-Inputs arrive via MCP (CV, job description, extra topics). Give a short 2–3 line summary:
-- Seniority level inferred from CV
-- Key domains
-- Top skill gaps vs. the job description
+Inputs arrive via MCP (CV, job description, extra topics). After analysing the CV and JD, present a clean, structured overview in this exact layout:
 
-Then wait — questions are requested one at a time via `next_question`.
+```
+[Role / target position] — [seniority level inferred from CV].
+
+**Interview focus:**
+— Based on your CV vs. the job description
+
+**Domains & focus:**
+
+| Domain                                   | Focus  |
+|------------------------------------------|--------|
+| [Domain 1]                               | [High/Med/Low] |
+| [Domain 2]                               | [High/Med/Low] |
+| ...                                      | ...    |
+
+**Top skill gaps vs. the JD:** [short note on the biggest gaps to drill].
+
+---
+Ready when you are — first question?
+```
+
+Then wait — questions are requested one at a time.
 
 ## Question format
 

{stackprep_pro-0.2.5.dist-info → stackprep_pro-0.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.5
+Version: 0.2.7
 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.7.dist-info/RECORD

@@ -0,0 +1,8 @@
+stackprep_pro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stackprep_pro/server.py,sha256=0CHpvKyU6Utgr4MfL1r0j7OtCQ8m2fI3PkdxBuAvJpA,16362
+stackprep_pro/skills/certification.md,sha256=m7TdVHPwjAxbgqem0VPnOPjwmACMZoGWZakoNpBcX5M,4966
+stackprep_pro/skills/interview.md,sha256=T-neB4K_9hXlnCfBb0MNxk21V-HBSdUP37Pr7drm3HE,4172
+stackprep_pro-0.2.7.dist-info/METADATA,sha256=jj95dAx1AuG8Z2Zl33eZFAzOvkA84zKES-8Oh8shD6Q,7949
+stackprep_pro-0.2.7.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+stackprep_pro-0.2.7.dist-info/entry_points.txt,sha256=DGlPLlB4ZCqcNBs8PVMfOR8iklxbucEeIFvaECa_XuA,60
+stackprep_pro-0.2.7.dist-info/RECORD,,

stackprep_pro-0.2.5.dist-info/RECORD

@@ -1,8 +0,0 @@
-stackprep_pro/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-stackprep_pro/server.py,sha256=lg2URZPDBxXKTGe9vLTTYUvNV0akrpccQLltKdxqk3U,14234
-stackprep_pro/skills/certification.md,sha256=QGHBMsTiu4h4U9GyQ2vWLTuUYtvoXIwTPeVwj0xNyUY,4330
-stackprep_pro/skills/interview.md,sha256=Hryp2x6oOvopviN_ZvC_EIi50-kJ8eAgEY5jgRm8gc4,3656
-stackprep_pro-0.2.5.dist-info/METADATA,sha256=QsdZu05_jXRzvOAPKebQ8_eF1c7FK7fy3b6vDueonC8,7834
-stackprep_pro-0.2.5.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-stackprep_pro-0.2.5.dist-info/entry_points.txt,sha256=DGlPLlB4ZCqcNBs8PVMfOR8iklxbucEeIFvaECa_XuA,60
-stackprep_pro-0.2.5.dist-info/RECORD,,