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

stackprep_pro-0.2.5/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Get version from pyproject.toml
+        id: version
+        run: |
+          echo "VERSION=$(grep '^version' pyproject.toml | sed 's/version = "\(.*\)"/\1/')" >> $GITHUB_OUTPUT
+
+      - name: Check if tag already exists
+        id: tag_check
+        run: |
+          if git ls-remote --tags origin "refs/tags/v${{ steps.version.outputs.VERSION }}" | grep -q .; then
+            echo "EXISTS=true" >> $GITHUB_OUTPUT
+          else
+            echo "EXISTS=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Tag version
+        if: steps.tag_check.outputs.EXISTS == 'false'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag "v${{ steps.version.outputs.VERSION }}"
+          git push origin "v${{ steps.version.outputs.VERSION }}"
+
+      - name: Install uv
+        if: steps.tag_check.outputs.EXISTS == 'false'
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: Build
+        if: steps.tag_check.outputs.EXISTS == 'false'
+        run: uv build
+
+      - name: Publish to PyPI
+        if: steps.tag_check.outputs.EXISTS == 'false'
+        uses: pypa/gh-action-pypi-publish@release/v1

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.3 → stackprep_pro-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackprep-pro
-Version: 0.2.3
+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.3 → 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.3 → stackprep_pro-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackprep-pro"
-version = "0.2.3"
+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.3 → 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:

{stackprep_pro-0.2.3 → stackprep_pro-0.2.5}/src/stackprep_pro/skills/certification.md

@@ -69,21 +69,13 @@ When `end_session` is called, the server shows the auto-detected topics and asks
 
 The user can say no or list extras, then call `save_study_pack` with a chosen name to persist it to disk.
 
-**Pack format** — produce a JSON block first, then a markdown summary:
-
-```json
-[
-  {
-    "topic": "",
-    "official_docs": [{"title": "", "url": ""}],
-    "videos": [{"title": "", "url": ""}],
-    "exam_prep": [{"title": "", "url": ""}],
-    "summary": ""
-  }
-]
-```
+**Pack format** — for each topic, produce a markdown section:
+
+- Official docs link (or community source if no official docs exist)
+- Best YouTube / video resource
+- 2–3 sentence summary of what to focus on
 
-Use only real, publicly accessible URLs. Never fabricate documentation links.
+Use only real, publicly accessible URLs. Never fabricate links.
 
 ## Exit / Study Plan
 

{stackprep_pro-0.2.3 → stackprep_pro-0.2.5}/src/stackprep_pro/skills/interview.md

@@ -75,18 +75,11 @@ When `end_session` is called, the server shows the auto-detected topics and asks
 
 The user can say no or list extras, then call `save_study_pack` with a chosen name to persist it to disk.
 
-**Pack format** — produce a JSON block first, then a markdown summary:
-
-```json
-[
-  {
-    "topic": "",
-    "official_docs": [{"title": "", "url": ""}],
-    "videos": [{"title": "", "url": ""}],
-    "exam_prep": [{"title": "", "url": ""}],
-    "summary": ""
-  }
-]
+**Pack format** — for each topic, produce a markdown section:
+
+- Official docs link (or community source if no official docs exist)
+- Best YouTube / video resource
+- 2–3 sentence summary of what to focus on
 ```
 
 Use only real, publicly accessible URLs. Never fabricate documentation links.

{stackprep_pro-0.2.3 → stackprep_pro-0.2.5}/uv.lock

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

stackprep_pro-0.2.3/.github/workflows/publish.yml

@@ -1,46 +0,0 @@
-name: Publish to PyPI
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      id-token: write
-      contents: write
-
-    steps:
-      - uses: actions/checkout@v5
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Bump patch version in pyproject.toml
-        id: version
-        run: |
-          CURRENT=$(grep '^version' pyproject.toml | sed 's/version = "\(.*\)"/\1/')
-          IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
-          NEW="$MAJOR.$MINOR.$((PATCH + 1))"
-          sed -i "s/^version = \"$CURRENT\"/version = \"$NEW\"/" pyproject.toml
-          echo "VERSION=$NEW" >> $GITHUB_OUTPUT
-
-      - name: Commit and tag new version
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add pyproject.toml
-          git commit -m "chore: bump version to ${{ steps.version.outputs.VERSION }}"
-          git tag "v${{ steps.version.outputs.VERSION }}"
-          git push origin main --follow-tags
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v8.2.0
-
-      - name: Build
-        run: uv build
-
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1