Robolancer updates

.devcontainer/devcontainer.json

@@ -0,0 +1,36 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/debian
+{
+	"name": "python:3:10",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/base:debian",
+	"features": {
+		"ghcr.io/devcontainers-extra/features/mkdocs:2": {},
+		"ghcr.io/devcontainers/features/python:1":{}
+	},
+	"postCreateCommand": [
+		"pip3 install --user -r requirements.txt",
+		"pip3 install --user first-agentic-csa"
+	],
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"main-branch.mkdocs-snippet-lens",
+				"aikebang.mkdocs-syntax-highlight",
+				"ytianle.mkdocs-material-linter"
+			]
+		}
+	},
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Configure tool-specific properties.
+
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.github/copilot-instructions.md

@@ -0,0 +1,107 @@
+# GitHub Copilot / Cursor Instructions for FRC Development
+
+You are assisting with a FIRST Robotics Competition (FRC) project using WPILib. You have access to an MCP server that provides documentation search across WPILib and vendor libraries (REV, CTRE, Redux, etc.).
+
+IMPORTANT: Before answering any question about FRC programming, motor controllers, sensors, WPILib, or vendor APIs, you MUST run the MCP documentation search/fetch tools and base your answer on those results.
+
+## Mandatory Documentation-First Policy
+
+This repository requires that all FRC-related questions be investigated with the MCP documentation tools before producing a final answer. Do not rely solely on memory or training data; always perform the steps below and include the results and citations in your response.
+
+Required workflow for FRC questions:
+
+- **Step 1 — Search (MCP required):** Call `mcp_wpilib_search_frc_docs(query=..., vendors=[...])` (use `vendors=["all"]` if unsure). Capture the top relevant results.
+- **Step 2 — Fetch (MCP required):** For each relevant result, call `mcp_wpilib_fetch_frc_doc_page(url=...)` and review the page content for exact API usage, examples, and notes.
+- **Step 3 — Answer with citations:** Include the documentation URLs (and short quoted excerpts when helpful) in your answer. If the docs conflict, explain the discrepancy and include all sources used.
+
+When to skip MCP: only skip if the question is clearly non-FRC (pure Python, unrelated algorithms, general tooling). When in doubt, run the MCP search.
+
+Examples of required tool usage:
+```
+mcp_wpilib_search_frc_docs(query="SparkMax NEO brushless setup", vendors=["rev"])
+mcp_wpilib_fetch_frc_doc_page(url="https://docs.revrobotics.com/...")
+```
+
+If you cannot call the MCP tools (tool outage or missing permissions), explicitly state that you could not run the required searches and ask whether to proceed with a best-effort answer. Do not produce an authoritative-sounding answer without the MCP citations.
+
+## Tool Usage Patterns
+
+**For general questions (MCP):**
+```
+mcp_wpilib_search_frc_docs(query="how to configure PID", vendors=["all"])
+```
+
+**For vendor-specific questions (MCP):**
+```
+mcp_wpilib_search_frc_docs(query="SparkMax current limits", vendors=["rev"])
+mcp_wpilib_search_frc_docs(query="TalonFX motion magic", vendors=["ctre"])
+```
+
+**For comparisons (MCP):**
+```
+mcp_wpilib_search_frc_docs(query="brushless motor setup", vendors=["rev"], max_results=5)
+mcp_wpilib_search_frc_docs(query="brushless motor setup", vendors=["ctre"], max_results=5)
+```
+
+**After finding relevant pages (MCP):**
+```
+mcp_wpilib_fetch_frc_doc_page(url="https://docs.revrobotics.com/...")
+```
+**For Markdown or readthedocs:**
+https://docs.readthedocs.com/platform/stable/index.html
+https://squidfunk.github.io/mkdocs-material/reference/code-blocks/
+https://squidfunk.github.io/mkdocs-material/reference/
+
+**For YAGSL:**
+https://docs.yagsl.com/
+https://yet-another-software-suite.github.io/YAGSL/javadocs/
+https://github.com/Yet-Another-Software-Suite/YAGSL/tree/main/examples
+
+## Language and Version Awareness
+
+- Ask the student what language they're using (Java, Python, or C++) if not obvious from context
+- Default to the current season (2025) unless specified otherwise
+- Use the `language` and `version` parameters to filter results:
+```
+search_frc_docs(query="command based", language="Python", version="2025")
+```
+
+## Code Style for FRC
+
+When writing code for FRC projects:
+
+- Follow WPILib conventions (Command-based or TimedRobot patterns)
+- Use vendor-specific APIs correctly (REVLib for SparkMax, Phoenix 6 for TalonFX)
+- Include necessary imports
+- Add comments explaining the "why" for students learning
+- Handle units properly (RPM vs rotations, degrees vs radians)
+
+## Common Vendor Mappings
+
+| Hardware | Vendor | Search with |
+|----------|--------|-------------|
+| SparkMax, SparkFlex, NEO, NEO 550 | REV | `vendors=["rev"]` |
+| TalonFX, Falcon 500, Kraken, CANcoder, Pigeon | CTRE | `vendors=["ctre"]` |
+| Canandcoder, Canandmag | Redux | `vendors=["redux"]` |
+| NavX | WPILib/Studica | `vendors=["wpilib"]` |
+| Limelight | WPILib | `vendors=["wpilib"]` |
+| PhotonVision | PhotonVision | `vendors=["photonvision"]` |
+
+## When Docs Don't Have the Answer
+
+If search results are empty or unhelpful:
+1. Try broader search terms
+2. Try `vendors=["all"]` to cast a wider net
+3. Check `list_frc_doc_sections` to see what's available
+4. Be honest with the student that you couldn't find documentation, and offer your best guess with appropriate caveats
+
+## Example Interaction
+
+**Student:** "How do I set up a SparkMax for a NEO brushless motor?"
+
+**You should:**
+1. `mcp_wpilib_search_frc_docs(query="SparkMax NEO brushless setup", vendors=["rev"])`
+2. Review results, pick most relevant URL
+3. `mcp_wpilib_fetch_frc_doc_page(url="...")` to get full content
+4. Write code based on current documentation
+5. Tell the student: "Based on the REV documentation at [url], here's how to set it up..."

.github/workflows/Deploy_site.yml

@@ -0,0 +1,32 @@
+name: Deploy Site
+permissions:
+  contents: write
+on:
+  # pull_request: 
+  #   branches:
+  #     - robolancer_updates
+  push:
+   branches:
+    - robolancer_updates
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: pip install -r requirements.txt
+      - run: mkdocs build
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: 3.x
+      - run: pip install mkdocs
+      - run: pip install -r requirements.txt
+      - run: mkdocs gh-deploy --force

.github/workflows/build.yml

@@ -1,8 +1,8 @@
 name: Build MkDocs
 on:
-  pull_request: 
+  push:
     branches:
-      - main
+      - robolancer_updates 
 jobs:
   build:
     runs-on: ubuntu-latest

.github/workflows/main.yml

@@ -2,7 +2,7 @@ name: Publish docs via GitHub Pages
 on:
   push:
     branches:
-      - main
+      - robolancer_updates
 jobs:
   deploy:
     runs-on: ubuntu-latest

.vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+	"servers": {
+		"frc-docs": {
+			"type": "stdio",
+			"command": "uvx",
+			"args": [
+				"first_agentic_csa==0.3.12"
+			],
+			"env": {}
+		}
+	},
+	"inputs": []
+}