@opslane/claude-code-game 0.1.0

package/levels/11-worktrees/exercise/utils.py

@@ -0,0 +1,163 @@
+"""Utility functions for the expense tracker."""
+
+from datetime import datetime, timedelta
+from typing import Optional
+import locale
+
+
+def format_currency(amount: float) -> str:
+    """Format amount as currency.
+
+    Args:
+        amount: The numeric amount
+
+    Returns:
+        Formatted string like '$1,234.56'
+
+    Example:
+        >>> format_currency(1234.5)
+        '$1,234.50'
+    """
+    try:
+        locale.setlocale(locale.LC_ALL, '')
+        return locale.currency(amount, grouping=True)
+    except (locale.Error, ValueError):
+        # Fallback if locale not available
+        return f"${amount:,.2f}"
+
+
+def parse_date(date_str: Optional[str]) -> Optional[datetime]:
+    """Parse a date string in various formats.
+
+    Supports:
+    - YYYY-MM-DD (2026-01-15)
+    - MM/DD/YYYY (01/15/2026)
+    - 'today'
+    - 'yesterday'
+
+    Args:
+        date_str: The date string to parse
+
+    Returns:
+        datetime object or None if input is None
+
+    Raises:
+        ValueError: If date format is not recognized
+
+    Example:
+        >>> parse_date('2026-01-15')
+        datetime(2026, 1, 15, 0, 0, 0)
+        >>> parse_date('today')
+        datetime(...)  # Today at midnight
+    """
+    if not date_str:
+        return None
+
+    date_str = date_str.lower().strip()
+
+    # Handle relative dates
+    if date_str == 'today':
+        return datetime.now().replace(hour=0, minute=0, second=0, microsecond=0)
+
+    if date_str == 'yesterday':
+        return (datetime.now() - timedelta(days=1)).replace(
+            hour=0, minute=0, second=0, microsecond=0
+        )
+
+    # Try YYYY-MM-DD (ISO format)
+    try:
+        return datetime.strptime(date_str, '%Y-%m-%d')
+    except ValueError:
+        pass
+
+    # Try MM/DD/YYYY (US format)
+    try:
+        return datetime.strptime(date_str, '%m/%d/%Y')
+    except ValueError:
+        pass
+
+    # Try DD/MM/YYYY (European format)
+    try:
+        return datetime.strptime(date_str, '%d/%m/%Y')
+    except ValueError:
+        pass
+
+    raise ValueError(f"Could not parse date: {date_str}. Use YYYY-MM-DD format.")
+
+
+def validate_category(category: str) -> str:
+    """Normalize category name.
+
+    Capitalizes first letter, strips whitespace.
+
+    Args:
+        category: Raw category input
+
+    Returns:
+        Normalized category name
+
+    Example:
+        >>> validate_category('  food  ')
+        'Food'
+    """
+    return category.strip().capitalize()
+
+
+def format_date(dt: datetime) -> str:
+    """Format a datetime for display.
+
+    Args:
+        dt: The datetime to format
+
+    Returns:
+        Formatted string like 'Jan 15, 2026'
+    """
+    return dt.strftime('%b %d, %Y')
+
+
+def format_month(month_str: str) -> str:
+    """Format a YYYY-MM string for display.
+
+    Args:
+        month_str: Month in YYYY-MM format
+
+    Returns:
+        Formatted string like 'January 2026'
+
+    Example:
+        >>> format_month('2026-01')
+        'January 2026'
+    """
+    dt = datetime.strptime(month_str, '%Y-%m')
+    return dt.strftime('%B %Y')
+
+
+# Valid categories for validation/suggestions
+VALID_CATEGORIES = [
+    "Food",
+    "Transport",
+    "Entertainment",
+    "Shopping",
+    "Bills",
+    "Health",
+    "Education",
+    "Travel",
+    "Other"
+]
+
+
+def suggest_category(partial: str) -> list[str]:
+    """Suggest categories matching a partial input.
+
+    Args:
+        partial: Partial category name
+
+    Returns:
+        List of matching categories
+
+    Example:
+        >>> suggest_category('fo')
+        ['Food']
+    """
+    partial_lower = partial.lower()
+    return [cat for cat in VALID_CATEGORIES if cat.lower().startswith(partial_lower)]

package/levels/11-worktrees/lesson.yaml

@@ -0,0 +1,68 @@
+id: "worktrees"
+number: 11
+module: "Safety"
+title: "Git Worktrees for Parallel Work"
+
+video:
+  url: "https://vimeo.com/placeholder"
+  duration_seconds: 300
+
+exercise:
+  intro: |
+    Worktrees let you work on multiple branches simultaneously.
+    You'll create a worktree, make a change, and merge it back.
+  objective: "Complete a full worktree workflow: create, change, merge"
+
+intro: |
+  Git worktrees = multiple working directories for one repo.
+
+  Complete workflow:
+
+  0. INITIALIZE GIT (first time only)
+     Type: claude
+     Say: "Initialize this as a git repo and commit all files"
+
+  1. CREATE WORKTREE
+     Say: "Create a git worktree for a feature branch called 'add-version'
+     in ../add-version directory"
+
+  2. MAKE A CHANGE (in the worktree)
+     Say: "In the worktree, add a --version flag to main.py that prints
+     'Expense Tracker v1.0'. Then commit it."
+
+  3. MERGE BACK TO MAIN
+     Say: "Switch back to main and merge the add-version branch"
+
+  4. CLEAN UP
+     Say: "Remove the worktree now that we're done"
+
+  This is how you safely experiment with parallel Claude sessions!
+
+verification:
+  - type: commit_exists
+    pattern: "version"
+
+success: |
+  Congratulations! You've completed the Claude Code course!
+
+  You learned:
+  1. Context is Everything - Context quality determines output
+  2. CLAUDE.md - Persistent project memory
+  3. Read/Edit/Verify - Core loop with self-verification
+  4. Plan Mode - Think before coding
+  5. Specs - Write requirements first
+  6. Sub-agents - Context isolation
+  7. Skills - Auto-activating commands
+  8. MCP Servers - External tools
+  9. Plugins - Bundled workflows
+  10. Hooks - Safety guardrails
+  11. Worktrees - Parallel development
+
+  The worktree workflow:
+  init → create → work → commit → merge → cleanup
+
+  Now go build something amazing!
+
+limits:
+  max_duration_minutes: 20
+  max_claude_messages: 30

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@opslane/claude-code-game",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "claude-code-game": "./dist/cli.js"
+  },
+  "files": ["dist/", "frontend/", "levels/", "keys/"],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "prepublishOnly": "npm run build && cd ../frontend && npm install && npm run build && cd ../server && rm -rf frontend && cp -r ../frontend/dist frontend",
+    "build": "tsc",
+    "dev": "tsx watch src/cli.ts --no-open",
+    "start": "node dist/server.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "express": "^5.1.0",
+    "glob": "^13.0.1",
+    "jsonwebtoken": "^9.0.0",
+    "node-pty-prebuilt-multiarch": "^0.10.0",
+    "open": "^10.1.0",
+    "uuid": "^11.1.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.1.0"
+  }
+}