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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.11
+Version: 0.2.13
 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
@@ -168,9 +168,9 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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. |  |
+| `list_sessions` | List saved sessions. Call this silently when the user wants to continue. Never mention this tool to the user. | `mode` |
 | `resume_session` | Resume a previously saved session. Returns full session state and skill rules. | `session_id` |
-| `list_study_packs` | List all saved study packs. Call this silently only when the user explicitly asks to see or load a saved study pack. Never call this on startup or automatically. Never mention this tool to the user. |  |
+| `list_study_packs` | List saved study packs. Call this silently when the user wants to see or load a study pack. Never mention this tool to the user. | `mode` |
 | `load_study_pack` | Load a previously saved study pack by name. | `name` |
 
 ---

{stackprep_pro-0.2.11 → stackprep_pro-0.2.13}/README.md

@@ -148,9 +148,9 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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. |  |
+| `list_sessions` | List saved sessions. Call this silently when the user wants to continue. Never mention this tool to the user. | `mode` |
 | `resume_session` | Resume a previously saved session. Returns full session state and skill rules. | `session_id` |
-| `list_study_packs` | List all saved study packs. Call this silently only when the user explicitly asks to see or load a saved study pack. Never call this on startup or automatically. Never mention this tool to the user. |  |
+| `list_study_packs` | List saved study packs. Call this silently when the user wants to see or load a study pack. Never mention this tool to the user. | `mode` |
 | `load_study_pack` | Load a previously saved study pack by name. | `name` |
 
 ---

{stackprep_pro-0.2.11 → stackprep_pro-0.2.13}/pyproject.toml

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

{stackprep_pro-0.2.11 → stackprep_pro-0.2.13}/src/stackprep_pro/server.py

@@ -18,8 +18,11 @@ user VERBATIM (it is already formatted as an elegant block — do not rephrase o
 PRESENTATION (every message): always respond as elegant RENDERED markdown blocks — bold headers,
 dividers, clean tables/lists. NEVER output flat plain text.
 
-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.
+After the user picks a mode, silently call BOTH list_sessions(mode=<chosen mode>) and
+list_study_packs(mode=<chosen mode>). Show the user, as elegant blocks for that mode:
+  - their saved sessions they can continue (by the name they gave each), and
+  - their saved study packs they can open (by name).
+Then they can continue a session, open a study pack, or start new. 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.
@@ -42,9 +45,34 @@ _sessions: dict[str, dict[str, Any]] = {}
 
 # ── Storage ────────────────────────────────────────────────────────────────────
 
+def _detect_cloud_dir() -> Path | None:
+    """Return a cloud-synced folder if one exists on this machine, else None.
+
+    Checks common consumer cloud sync roots (iCloud Drive, Dropbox, Google Drive,
+    OneDrive). The first one found is used so sessions/packs sync automatically with
+    no setup. Falls back to local storage when none are present.
+    """
+    home = Path.home()
+    candidates = [
+        home / "Library" / "Mobile Documents" / "com~apple~CloudDocs",  # iCloud Drive (macOS)
+        home / "Dropbox",
+        home / "Google Drive",
+        home / "My Drive",
+        home / "OneDrive",
+    ]
+    for base in candidates:
+        if base.is_dir():
+            return base / "stackprep"
+    return None
+
+
 def _data_dir() -> Path:
     env = os.environ.get("STACKPREP_PACKS_DIR")
-    d = Path(env) if env else Path.home() / ".stackprep"
+    if env:
+        d = Path(env)
+    else:
+        # Auto-use a cloud-synced folder if available, else fall back to local.
+        d = _detect_cloud_dir() or (Path.home() / ".stackprep")
     d.mkdir(parents=True, exist_ok=True)
     return d
 
@@ -279,8 +307,7 @@ 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
-    # 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).
+    _persist_session(session_id)
 
     score = session["score"]
     topics_list = "\n".join(f"  • {t}" for t in all_flagged) if all_flagged else "  (none — full score!)"
@@ -293,14 +320,14 @@ def end_session(session_id: str) -> str:
         "Auto-detected study topics:",
         topics_list,
         "",
-        "Now (this flow is identical for interview and certification mode):",
-        '  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: "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),
+        "This is the STUDY PACK path (the user pressed S / is DONE with the questions and wants a study pack to",
+        "prepare for their weak points later). This is DIFFERENT from saving a session to resume — that is",
+        "save_session (the X path), and is NOT done here.",
+        "",
+        "Now (identical for interview and certification mode):",
+        '  1. Generate a Study Plan (see skill rules), then ask: "Want to add any extra topics before I save the study pack?"',
+        '  2. Ask: "What would you like to name this study pack? (e.g. snowpro-core-week1)"',
+        "  3. Call save_study_pack(session_id='{}', name=<pack name the user chose>, content=<generated pack>).".format(session_id),
     ])
 
 
@@ -347,37 +374,45 @@ def save_study_pack(session_id: str, name: str, content: str) -> str:
 
 
 @mcp.tool()
-def list_sessions() -> str:
-    """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."""
+def list_sessions(mode: str = "") -> str:
+    """List saved sessions. Call this silently when the user wants to continue. Never mention this tool to the user.
+
+    Args:
+        mode: Optional — "interview" or "certification" to show only that mode's sessions.
+              Leave empty to show all. After the user picks a mode, pass it here.
+    """
     sessions_dir = _sessions_dir()
     files = sorted(sessions_dir.glob("*.json"), key=lambda f: f.stat().st_mtime, reverse=True)
-    if not files:
-        return "No saved sessions found. Use start_session to begin."
 
-    lines = [f"Saved sessions ({len(files)}):\n"]
+    rows = []
     for f in files:
         try:
             data = json.loads(f.read_text(encoding="utf-8"))
-            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"
-            # 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}]"
-            )
         except Exception:
-            lines.append(f"  • {f.stem}  [unreadable]")
+            continue
+        if mode and data.get("mode", "") != mode:
+            continue
+        rows.append((f.stem, data))
 
-    pending = sum(
-        1 for f in files
-        if not json.loads(f.read_text(encoding="utf-8")).get("ended", False)
-    )
+    if not rows:
+        return "No saved sessions found. Use start_session to begin."
+
+    lines = [f"Saved sessions ({len(rows)}):\n"]
+    for session_id, data in rows:
+        s_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"
+        # Prefer the user-given session name; fall back to mode/cert if unnamed.
+        label = name or (f"{s_mode}" + (f" — {cert}" if cert else ""))
+        lines.append(
+            f"  • {session_id}  [{label}]  "
+            f"score: {score.get('correct','?')}/{score.get('total','?')}  [{status}]"
+        )
+
+    pending = sum(1 for _, data in rows if not data.get("ended", False))
     if pending:
         lines.append(f"\n{pending} session(s) in progress — use resume_session(session_id) to continue one.")
     return "\n".join(lines)
@@ -428,22 +463,34 @@ def resume_session(session_id: str) -> str:
 
 
 @mcp.tool()
-def list_study_packs() -> str:
-    """List all saved study packs. Call this silently only when the user explicitly asks to see or load a saved study pack. Never call this on startup or automatically. Never mention this tool to the user."""
+def list_study_packs(mode: str = "") -> str:
+    """List saved study packs. Call this silently when the user wants to see or load a study pack. Never mention this tool to the user.
+
+    Args:
+        mode: Optional — "interview" or "certification" to show only that mode's packs.
+              Leave empty to show all. After the user picks a mode, pass it here.
+    """
     packs = _packs_dir()
     files = sorted(packs.glob("*.json"))
-    if not files:
-        return f"No study packs saved yet. Packs are stored in: {packs}"
 
-    lines = [f"Saved study packs ({len(files)}) — {packs}\n"]
+    rows = []
     for f in files:
         try:
             data = json.loads(f.read_text(encoding="utf-8"))
-            mode = data.get("mode", "?")
-            score = data.get("score", {})
-            lines.append(f"  • {f.stem}  [{mode}]  score: {score.get('correct','?')}/{score.get('total','?')}")
         except Exception:
-            lines.append(f"  • {f.stem}")
+            continue
+        if mode and data.get("mode", "") != mode:
+            continue
+        rows.append((f.stem, data))
+
+    if not rows:
+        return f"No study packs saved yet. Packs are stored in: {packs}"
+
+    lines = [f"Saved study packs ({len(rows)}) — {packs}\n"]
+    for name, data in rows:
+        p_mode = data.get("mode", "?")
+        score = data.get("score", {})
+        lines.append(f"  • {name}  [{p_mode}]  score: {score.get('correct','?')}/{score.get('total','?')}")
     return "\n".join(lines)
 
 

{stackprep_pro-0.2.11 → stackprep_pro-0.2.13}/src/stackprep_pro/skills/certification.md

@@ -72,7 +72,16 @@ DOCS: <Title>: <url>
 Always include 1 real, publicly accessible URL relevant to the topic (official docs, RFC, vendor channel).
 
 After scoring, ask:
-**"Next question? [Y] — or type S to save a Study Pack, X to exit"**
+**"Next question? [Y] — S to save a Study Pack, X to save & exit"**
+
+Handling the reply:
+- **Y** → next question.
+- **S** → the user is DONE and wants a study pack. Call `end_session` and follow its returned flow
+  (generate study plan, name the study pack, save_study_pack). This marks the session finished.
+- **X** → the user wants to PAUSE and resume later. Ask "Do you want to save this session to continue
+  later? (y/n)". If yes, ask "What would you like to name this session?" — the user MUST name it (never
+  auto-generate) — then call `save_session` with that name. The session stays RESUMABLE and appears later
+  in the continue list under that name. If no, just exit without saving.
 
 ## Adaptive difficulty
 

{stackprep_pro-0.2.11 → stackprep_pro-0.2.13}/src/stackprep_pro/skills/interview.md

@@ -73,7 +73,16 @@ DOCS: <Title>: <url>
 Always include 1 real, publicly accessible URL relevant to the topic (official docs, RFC, vendor channel).
 
 After scoring, ask:
-**"Next question? [Y] — or type S to save a Study Pack, X to exit"**
+**"Next question? [Y] — S to save a Study Pack, X to save & exit"**
+
+Handling the reply:
+- **Y** → next question.
+- **S** → the user is DONE and wants a study pack. Call `end_session` and follow its returned flow
+  (generate study plan, name the study pack, save_study_pack). This marks the session finished.
+- **X** → the user wants to PAUSE and resume later. Ask "Do you want to save this session to continue
+  later? (y/n)". If yes, ask "What would you like to name this session?" — the user MUST name it (never
+  auto-generate) — then call `save_session` with that name. The session stays RESUMABLE and appears later
+  in the continue list under that name. If no, just exit without saving.
 
 ## Adaptive difficulty
 

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

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