stackprep-pro 0.2.4__tar.gz → 0.2.5__tar.gz

stackprep_pro-0.2.5/CLAUDE.md

@@ -0,0 +1,41 @@
+# CLAUDE.md — stackprep-pro
+
+Rules for working on this repo. **Do NOT violate these. Do NOT touch things that already work.**
+
+## Golden rule
+
+- **If something works, do NOT change it.** No "improvements", no refactors, no edits to working code. Only touch what is explicitly broken and being fixed.
+- Always **follow the skill files** in `src/stackprep_pro/skills/`. The skill is the source of truth for behavior. Never invent a flow that contradicts the skill.
+
+## Startup / session flow (MUST follow exactly)
+
+1. When the MCP starts, **ask the user in plain human language**: "Are you prepping for a technical interview or a certification exam?"
+2. **Only after** the user picks interview or certification:
+   - If saved sessions exist for that mode, offer to **continue a saved session** (shown by the **name the user gave it**) or **start a new one**.
+   - If none exist, just start a new session.
+3. **Never expose backend tool names** to the user (no "list_sessions", "start_session", "list_study_packs", etc.). Use natural language only.
+4. **Never auto-call** `list_sessions` or `list_study_packs` on startup. Call them silently in the background **only** when the user explicitly asks to continue/load.
+
+## Certification exam version
+
+- **Never hardcode exam versions** (e.g. do NOT hardcode "SnowPro Core = COF-C03"). It must work for **ANY** certification.
+- 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).
+
+## Study pack
+
+- The user **must be able to name** the study pack when saving it.
+- Study pack format is **markdown, NOT JSON**. For each topic: official docs link (or community source like Reddit/Discord/LinkedIn if no official docs exist — e.g. niche certs like NVIDIA Agentic AI), best video resource, and a 2–3 sentence summary. Include percentages/scores and links as the original skill does.
+- Never fabricate documentation URLs. Only real, publicly accessible links.
+
+## Versioning & publishing
+
+- This package publishes to **PyPI** as `stackprep-pro` via **GitHub Actions** on push to `main` (`.github/workflows/publish.yml`).
+- **The human bumps the version in `pyproject.toml` and commits it.** The workflow does **NOT** auto-commit or auto-bump — it only reads the version, tags it, and publishes.
+- Every code change that ships needs a **version bump** (PyPI rejects re-publishing an existing version).
+- After publishing, to test the new version: `uv cache clean`, then restart the MCP client (uvx caches old versions).
+- `git pull` is set to rebase in this repo. If branches diverge, `git pull --rebase`.
+
+## Commit messages
+
+- When asked for a commit title, give a single concise conventional-commit line. Do not commit/push unless asked.

{stackprep_pro-0.2.4 → stackprep_pro-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.4
+Version: 0.2.5
 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,7 +168,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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. |  |
 | `resume_session` | Resume a previously saved session. Returns full session state and skill rules. | `session_id` |
-| `list_study_packs` | List all saved study packs. |  |
+| `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. |  |
 | `load_study_pack` | Load a previously saved study pack by name. | `name` |
 
 ---

{stackprep_pro-0.2.4 → stackprep_pro-0.2.5}/README.md

@@ -148,7 +148,7 @@ Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform s
 | `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. |  |
 | `resume_session` | Resume a previously saved session. Returns full session state and skill rules. | `session_id` |
-| `list_study_packs` | List all saved study packs. |  |
+| `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. |  |
 | `load_study_pack` | Load a previously saved study pack by name. | `name` |
 
 ---

{stackprep_pro-0.2.4 → stackprep_pro-0.2.5}/pyproject.toml

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

{stackprep_pro-0.2.4 → stackprep_pro-0.2.5}/src/stackprep_pro/server.py

@@ -79,6 +79,14 @@ 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):
+    1. First ask: "Are you prepping for a technical interview or a certification exam?"
+    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.
+       - 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.
+
     Args:
         mode: "interview" or "certification"
         cert_name: For certification mode — the exam name exactly as the user typed it (e.g. "AWS SAA-C03"). NEVER modify, correct, or substitute the cert name — use the user's exact input verbatim.
@@ -343,7 +351,7 @@ def resume_session(session_id: str) -> str:
 
 @mcp.tool()
 def list_study_packs() -> str:
-    """List all saved 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."""
     packs = _packs_dir()
     files = sorted(packs.glob("*.json"))
     if not files: