stackprep-pro 0.2.0__tar.gz

stackprep_pro-0.2.0/.claude/settings.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}

stackprep_pro-0.2.0/.githooks/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+set -e
+uv run python scripts/generate_readme.py
+git add README.md

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

@@ -0,0 +1,25 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

stackprep_pro-0.2.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+dist/
+build/
+
+# Cache files (from CLI version)
+.cv_cache.txt
+.jd_cache.txt
+.cert_cache.txt
+
+# Local study packs and sessions (stored in ~/.stackprep by default)
+study_later/
+
+# Env
+.env
+.env.*
+
+# macOS
+.DS_Store

stackprep_pro-0.2.0/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}

stackprep_pro-0.2.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: stackprep-pro
+Version: 0.2.0
+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
+Author-email: Flavia Fauconnet <flavsferr@gmail.com>
+License: MIT
+Keywords: ai,certification,interview,mcp,prep
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: mcp[cli]>=1.0.0
+Description-Content-Type: text/markdown
+
+# stackprep-pro
+
+> stackprep-pro — interview & certification prep MCP server for any AI client
+
+Works with **any MCP-compatible client** — Claude Code, Cursor, Cline, Windsurf, Continue.dev, Codex CLI, and any other client that supports the Model Context Protocol. No API key required — your existing AI subscription does the work.
+
+Available on PyPI: `uvx stackprep-pro`
+
+---
+
+## What it does
+
+stackprep-pro is a pure state-management MCP server. It tracks your session and study packs on disk; your AI client (Claude, Cursor, Codex, etc.) handles all the question generation and scoring logic using the skill rules returned at session start.
+
+- One question at a time — interview or certification mode
+- Instant scoring with doc links after every answer
+- Auto-detects wrong/partial answers and builds a named study pack
+- Sessions and study packs saved to disk — resume anytime, sync via iCloud
+- Resume in-progress sessions across conversations or devices
+
+---
+
+## Install
+
+```bash
+uvx stackprep-pro
+```
+
+> Requires [uv](https://docs.astral.sh/uv/). Install it with `curl -LsSf https://astral.sh/uv/install.sh | sh`.
+
+---
+
+## Configure your MCP client
+
+The config is the same for every client — just point to `uvx stackprep-pro`.
+
+### Claude Code
+
+Create `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Create `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}
+```
+
+Then open Cursor → **Cmd+Shift+J** → MCP tab — stackprep should appear with a green dot.
+
+### Codex CLI
+
+Add to `~/.codex/config.yaml`:
+
+```yaml
+mcpServers:
+  stackprep:
+    command: uvx
+    args:
+      - stackprep-pro
+```
+
+### Any other MCP-compatible client
+
+The pattern is always the same:
+
+```json
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}
+```
+
+Paste this into whatever config format your client uses (Cline, Windsurf, Continue.dev, etc.).
+
+---
+
+## Study pack storage
+
+Study packs and sessions are saved to `~/.stackprep/` by default.
+
+**Sync across devices with iCloud** (recommended on macOS):
+
+```bash
+# Add to ~/.zshrc or ~/.zprofile
+export STACKPREP_PACKS_DIR="$HOME/Documents/stackprep-packs"
+```
+
+`~/Documents` is synced to iCloud by default on macOS (requires iCloud Drive > Desktop & Documents enabled). Your packs will be available on any Mac signed into your Apple ID — and readable via the Files app on iPhone.
+
+**Custom path:**
+
+```bash
+export STACKPREP_PACKS_DIR="/path/to/your/folder"
+```
+
+Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform sync.
+
+---
+
+## Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `STACKPREP_PACKS_DIR` | `~/.stackprep` | Root directory for packs and sessions. |
+
+---
+
+## Skills (modes)
+
+| Mode | Description |
+|---|---|
+| `certification` | description: Certification prep skill for the stackprep-pro MCP server. Activated when mode is "certification". Drives question generation, scoring, adaptive difficulty, and study pack creation. |
+| `interview` | description: Interview prep skill for the stackprep-pro MCP server. Activated when mode is "interview". Drives question generation, scoring, adaptive difficulty, and study pack creation. |
+
+---
+
+## Tools
+
+| Tool | Description | Args |
+|---|---|---|
+| `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` |
+| `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 (pending and completed). |  |
+| `resume_session` | Resume a previously saved session. Returns full session state and skill rules. | `session_id` |
+| `list_study_packs` | List all saved study packs. |  |
+| `load_study_pack` | Load a previously saved study pack by name. | `name` |
+
+---
+
+## Session flow
+
+**Certification:**
+```
+list_sessions()                                          ← always called first
+→ start_session(mode="certification", cert_name="AWS SAA-C03")
+→ [AI generates questions one at a time]
+→ submit_answer(session_id, result="correct"|"partial"|"incorrect", question="...")
+→ ... repeat ...
+→ end_session(session_id)
+→ save_study_pack(session_id, name="aws-saa-week1", content="...")
+```
+
+**Interview:**
+```
+list_sessions()                                          ← always called first
+→ start_session(mode="interview", cv="...", jd="...")
+→ [AI generates questions one at a time]
+→ submit_answer(session_id, result="correct"|"partial"|"incorrect", question="...")
+→ ... repeat ...
+→ end_session(session_id)
+→ save_study_pack(session_id, name="python-interview-june", content="...")
+```
+
+**Resuming a session:**
+```
+list_sessions()                → shows in-progress sessions
+→ resume_session(session_id)  → loads state + skill rules, continues where you left off
+```
+
+**Loading a saved study pack:**
+```
+list_study_packs()
+→ load_study_pack(name="aws-saa-week1")
+```
+
+---
+
+## Session persistence
+
+Every session is saved to disk on every update. At the start of each new conversation the AI automatically calls `list_sessions` and asks whether you want to resume an in-progress session or start a new one. Sessions are stored in `~/.stackprep/sessions/` (or your custom `STACKPREP_PACKS_DIR`).
+
+---
+
+## Also available as a Claude Code plugin
+
+For Claude Projects or direct Claude.ai use, the behaviour rules are also available as a standalone skill file at [plugins/stackprep](https://github.com/youngpada1/stackprep/tree/main/plugins/stackprep) — no install needed.
+
+---
+
+## Contributing / Development
+
+```bash
+git clone https://github.com/youngpada1/stackprep-pro
+cd stackprep-pro
+
+# Install dependencies
+uv sync
+
+# Activate the pre-commit hook (auto-regenerates README on every commit)
+git config core.hooksPath .githooks
+
+# Run the server locally
+uv run stackprep-pro
+```
+
+The README is auto-generated from `server.py` tool definitions and the skills files in `src/stackprep_pro/skills/`.
+To regenerate manually:
+
+```bash
+uv run python scripts/generate_readme.py
+```
+
+---
+
+## License
+
+MIT — [Flavia Fauconnet](https://github.com/flavsferr)

stackprep_pro-0.2.0/README.md

@@ -0,0 +1,233 @@
+# stackprep-pro
+
+> stackprep-pro — interview & certification prep MCP server for any AI client
+
+Works with **any MCP-compatible client** — Claude Code, Cursor, Cline, Windsurf, Continue.dev, Codex CLI, and any other client that supports the Model Context Protocol. No API key required — your existing AI subscription does the work.
+
+Available on PyPI: `uvx stackprep-pro`
+
+---
+
+## What it does
+
+stackprep-pro is a pure state-management MCP server. It tracks your session and study packs on disk; your AI client (Claude, Cursor, Codex, etc.) handles all the question generation and scoring logic using the skill rules returned at session start.
+
+- One question at a time — interview or certification mode
+- Instant scoring with doc links after every answer
+- Auto-detects wrong/partial answers and builds a named study pack
+- Sessions and study packs saved to disk — resume anytime, sync via iCloud
+- Resume in-progress sessions across conversations or devices
+
+---
+
+## Install
+
+```bash
+uvx stackprep-pro
+```
+
+> Requires [uv](https://docs.astral.sh/uv/). Install it with `curl -LsSf https://astral.sh/uv/install.sh | sh`.
+
+---
+
+## Configure your MCP client
+
+The config is the same for every client — just point to `uvx stackprep-pro`.
+
+### Claude Code
+
+Create `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Create `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}
+```
+
+Then open Cursor → **Cmd+Shift+J** → MCP tab — stackprep should appear with a green dot.
+
+### Codex CLI
+
+Add to `~/.codex/config.yaml`:
+
+```yaml
+mcpServers:
+  stackprep:
+    command: uvx
+    args:
+      - stackprep-pro
+```
+
+### Any other MCP-compatible client
+
+The pattern is always the same:
+
+```json
+{
+  "mcpServers": {
+    "stackprep": {
+      "command": "uvx",
+      "args": ["stackprep-pro"]
+    }
+  }
+}
+```
+
+Paste this into whatever config format your client uses (Cline, Windsurf, Continue.dev, etc.).
+
+---
+
+## Study pack storage
+
+Study packs and sessions are saved to `~/.stackprep/` by default.
+
+**Sync across devices with iCloud** (recommended on macOS):
+
+```bash
+# Add to ~/.zshrc or ~/.zprofile
+export STACKPREP_PACKS_DIR="$HOME/Documents/stackprep-packs"
+```
+
+`~/Documents` is synced to iCloud by default on macOS (requires iCloud Drive > Desktop & Documents enabled). Your packs will be available on any Mac signed into your Apple ID — and readable via the Files app on iPhone.
+
+**Custom path:**
+
+```bash
+export STACKPREP_PACKS_DIR="/path/to/your/folder"
+```
+
+Point this at any Dropbox, Google Drive, or OneDrive folder for cross-platform sync.
+
+---
+
+## Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `STACKPREP_PACKS_DIR` | `~/.stackprep` | Root directory for packs and sessions. |
+
+---
+
+## Skills (modes)
+
+| Mode | Description |
+|---|---|
+| `certification` | description: Certification prep skill for the stackprep-pro MCP server. Activated when mode is "certification". Drives question generation, scoring, adaptive difficulty, and study pack creation. |
+| `interview` | description: Interview prep skill for the stackprep-pro MCP server. Activated when mode is "interview". Drives question generation, scoring, adaptive difficulty, and study pack creation. |
+
+---
+
+## Tools
+
+| Tool | Description | Args |
+|---|---|---|
+| `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` |
+| `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 (pending and completed). |  |
+| `resume_session` | Resume a previously saved session. Returns full session state and skill rules. | `session_id` |
+| `list_study_packs` | List all saved study packs. |  |
+| `load_study_pack` | Load a previously saved study pack by name. | `name` |
+
+---
+
+## Session flow
+
+**Certification:**
+```
+list_sessions()                                          ← always called first
+→ start_session(mode="certification", cert_name="AWS SAA-C03")
+→ [AI generates questions one at a time]
+→ submit_answer(session_id, result="correct"|"partial"|"incorrect", question="...")
+→ ... repeat ...
+→ end_session(session_id)
+→ save_study_pack(session_id, name="aws-saa-week1", content="...")
+```
+
+**Interview:**
+```
+list_sessions()                                          ← always called first
+→ start_session(mode="interview", cv="...", jd="...")
+→ [AI generates questions one at a time]
+→ submit_answer(session_id, result="correct"|"partial"|"incorrect", question="...")
+→ ... repeat ...
+→ end_session(session_id)
+→ save_study_pack(session_id, name="python-interview-june", content="...")
+```
+
+**Resuming a session:**
+```
+list_sessions()                → shows in-progress sessions
+→ resume_session(session_id)  → loads state + skill rules, continues where you left off
+```
+
+**Loading a saved study pack:**
+```
+list_study_packs()
+→ load_study_pack(name="aws-saa-week1")
+```
+
+---
+
+## Session persistence
+
+Every session is saved to disk on every update. At the start of each new conversation the AI automatically calls `list_sessions` and asks whether you want to resume an in-progress session or start a new one. Sessions are stored in `~/.stackprep/sessions/` (or your custom `STACKPREP_PACKS_DIR`).
+
+---
+
+## Also available as a Claude Code plugin
+
+For Claude Projects or direct Claude.ai use, the behaviour rules are also available as a standalone skill file at [plugins/stackprep](https://github.com/youngpada1/stackprep/tree/main/plugins/stackprep) — no install needed.
+
+---
+
+## Contributing / Development
+
+```bash
+git clone https://github.com/youngpada1/stackprep-pro
+cd stackprep-pro
+
+# Install dependencies
+uv sync
+
+# Activate the pre-commit hook (auto-regenerates README on every commit)
+git config core.hooksPath .githooks
+
+# Run the server locally
+uv run stackprep-pro
+```
+
+The README is auto-generated from `server.py` tool definitions and the skills files in `src/stackprep_pro/skills/`.
+To regenerate manually:
+
+```bash
+uv run python scripts/generate_readme.py
+```
+
+---
+
+## License
+
+MIT — [Flavia Fauconnet](https://github.com/flavsferr)

stackprep_pro-0.2.0/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "stackprep-pro"
+version = "0.2.0"
+description = "stackprep-pro — interview & certification prep MCP server for any AI client"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [
+    { name = "Flavia Fauconnet", email = "flavsferr@gmail.com" }
+]
+keywords = ["mcp", "interview", "certification", "ai", "prep"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "mcp[cli]>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/youngpada1/stackprep-pro"
+Repository = "https://github.com/youngpada1/stackprep-pro"
+
+[project.scripts]
+stackprep-pro = "stackprep_pro.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/stackprep_pro"]

stackprep_pro-0.2.0/scripts/bump_version.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Usage: ./scripts/bump_version.sh patch|minor|major
+# Bumps the version in pyproject.toml, commits, and tags.
+set -euo pipefail
+
+PART=${1:-patch}
+CURRENT=$(grep '^version' pyproject.toml | head -1 | sed 's/version = "\(.*\)"/\1/')
+
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+case "$PART" in
+  major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
+  minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
+  patch) PATCH=$((PATCH + 1)) ;;
+  *) echo "Usage: $0 patch|minor|major"; exit 1 ;;
+esac
+
+NEW="$MAJOR.$MINOR.$PATCH"
+
+sed -i '' "s/^version = \"$CURRENT\"/version = \"$NEW\"/" pyproject.toml
+
+echo "Bumped $CURRENT → $NEW"
+
+git add pyproject.toml
+git commit -m "chore: bump version to $NEW"
+git tag "v$NEW"
+
+echo ""
+echo "Run this to publish:"
+echo "  git push && git push --tags"