vectorclaw-mcp 1.0.0__tar.gz

vectorclaw_mcp-1.0.0/.devcontainer/Dockerfile

@@ -0,0 +1,7 @@
+FROM mcr.microsoft.com/devcontainers/python:3.14-bookworm
+
+# Keep image lean but include common build tooling for Python packages.
+RUN rm -f /etc/apt/sources.list.d/yarn.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends build-essential \
+    && rm -rf /var/lib/apt/lists/*

vectorclaw_mcp-1.0.0/.devcontainer/devcontainer.json

@@ -0,0 +1,17 @@
+{
+  "name": "VectorClaw Dev",
+  "build": {
+    "dockerfile": "Dockerfile"
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "ms-python.debugpy"
+      ]
+    }
+  },
+  "postCreateCommand": "python -m pip install --upgrade pip && pip install -e .[dev]",
+  "remoteUser": "vscode"
+}

vectorclaw_mcp-1.0.0/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

vectorclaw_mcp-1.0.0/.gitattributes

@@ -0,0 +1,7 @@
+# Normalize text files to LF in the repository across all platforms.
+* text=auto eol=lf
+
+# Windows-native scripts keep CRLF for compatibility.
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf

vectorclaw_mcp-1.0.0/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Require review requests from both code owners on all changes
+* @danmartinez78 @section9-tachi

vectorclaw_mcp-1.0.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,57 @@
+name: Bug report
+description: Report a reproducible problem in VectorClaw
+title: "bug: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for filing a bug report.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened?
+      placeholder: Clear and concise description of the issue.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Include exact commands and config when possible.
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and traces
+      description: Paste relevant logs, traceback, or MCP tool output.
+      render: shell
+  - type: input
+    id: version
+    attributes:
+      label: VectorClaw version
+      placeholder: 0.1.0
+  - type: dropdown
+    id: environment
+    attributes:
+      label: Environment
+      options:
+        - Devcontainer
+        - Local Linux
+        - Local macOS
+        - Local Windows
+        - GitHub Actions
+        - Other

vectorclaw_mcp-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/danmartinez78/VectorClaw/security/policy
+    about: Report vulnerabilities privately according to SECURITY.md.

vectorclaw_mcp-1.0.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature request
+description: Suggest an improvement to VectorClaw
+title: "feat: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What user problem are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe behavior and API impact.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: textarea
+    id: risks
+    attributes:
+      label: Risks and safety considerations
+      description: Mention robot movement, hardware assumptions, or runtime safety concerns.

vectorclaw_mcp-1.0.0/.github/copilot-instructions.md

@@ -0,0 +1,55 @@
+# Copilot Instructions for VectorClaw
+
+## Project Context
+
+- This repository provides an MCP server that controls Anki Vector robots.
+- Python package source lives under `src/vectorclaw_mcp`.
+- Tests live under `tests/`.
+
+## ⚠️ CRITICAL: SDK Surface Documentation
+
+**Before implementing or modifying ANY tool that interacts with the SDK, you MUST:**
+
+1. **Read the authoritative SDK surface reference:** `docs/WIREPOD_SDK_SURFACE_REFERENCE.md`
+2. **Verify all property names, method signatures, and behavior against this doc**
+3. **Do NOT assume field names or behavior** — check the reference
+
+**During code review, verify:**
+- All SDK property names match the reference doc exactly
+- All method calls use correct signatures from the reference doc
+- All behavior expectations align with SDK documentation
+
+**Common mistakes to avoid:**
+- `is_carrying_object` → wrong (use `is_carrying_block`)
+- `is_on_charger_platform` → wrong (use `is_on_charger`)
+- Assuming perception tools work without enabling vision modes
+- Assuming `found_object` in proximity sensor means "distance changed"
+
+**When in doubt, search the SDK surface doc first.**
+
+## Contribution Defaults
+
+- Keep changes minimal and task-focused.
+- Preserve existing public tool names and API behavior unless explicitly requested.
+- Prefer small pure functions where possible.
+- Add or update tests for changed behavior.
+
+## Safety and Runtime Constraints
+
+- Do not execute robot movement by default in tests.
+- Keep hardware-dependent logic isolated behind interfaces that can be mocked.
+- Avoid adding blocking operations to MCP tool handlers.
+
+## Development Workflow
+
+- Use the devcontainer setup for consistency.
+- Run `pytest -q` before finalizing.
+- If packaging or dependency metadata changes, validate with `python -m build`.
+
+## Documentation
+
+When behavior changes, update docs in:
+
+- `README.md` for user-facing usage
+- `docs/SETUP.md` for setup/runtime details
+- `ROADMAP.md` only for planning-level updates

vectorclaw_mcp-1.0.0/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "docker"
+    directory: "/.devcontainer"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10

vectorclaw_mcp-1.0.0/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## Summary
+
+Describe what changed and why.
+
+## Changes
+
+- 
+
+## Testing
+
+- [ ] `pytest -q`
+- [ ] `python -m build` (if packaging/metadata changed)
+- [ ] Manual verification (if robot-dependent behavior changed)
+
+## Notes
+
+Include any setup, migration, or follow-up information reviewers should know.

vectorclaw_mcp-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }}${{ matrix.experimental && ' – experimental' || '' }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Primary supported runtime for VectorClaw v1.0 — must pass.
+          - python-version: "3.11"
+            experimental: false
+          # Experimental — failures are informational only and do not block merges.
+          - python-version: "3.12"
+            experimental: true
+    continue-on-error: ${{ matrix.experimental }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and test dependencies
+        run: pip install -e . pytest Pillow
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+  package:
+    name: Build package
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build distribution
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+          python -m build
+          twine check dist/*

vectorclaw_mcp-1.0.0/.github/workflows/codeql.yml

@@ -0,0 +1,41 @@
+name: CodeQL
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  schedule:
+    - cron: "20 4 * * 1"
+
+jobs:
+  analyze:
+    name: Analyze (Python)
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language:
+          - python
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: ${{ matrix.language }}
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v4
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v4

vectorclaw_mcp-1.0.0/.github/workflows/devcontainer-ci.yml

@@ -0,0 +1,30 @@
+name: Dev Container CI
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - ".devcontainer/**"
+      - ".github/workflows/devcontainer-ci.yml"
+  pull_request:
+    paths:
+      - ".devcontainer/**"
+      - ".github/workflows/devcontainer-ci.yml"
+  workflow_dispatch:
+
+jobs:
+  build-devcontainer:
+    name: Build Dev Container
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Build dev container
+        uses: devcontainers/ci@v0.3
+        with:
+          imageName: ghcr.io/danmartinez78/vectorclaw/devcontainer
+          cacheFrom: ghcr.io/danmartinez78/vectorclaw/devcontainer
+          push: never

vectorclaw_mcp-1.0.0/.github/workflows/release-testpypi.yml

@@ -0,0 +1,33 @@
+name: Release TestPyPI
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish-testpypi:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build distribution
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+          python -m build
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+          verbose: true

vectorclaw_mcp-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,30 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build distribution
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

vectorclaw_mcp-1.0.0/.gitignore

@@ -0,0 +1,21 @@
+# Python byte-compiled / optimised / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# pytest cache
+.pytest_cache/
+
+# mypy
+.mypy_cache/

vectorclaw_mcp-1.0.0/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+	"files.eol": "\n"
+}

vectorclaw_mcp-1.0.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog,
+and this project follows Semantic Versioning.
+
+## [Unreleased]
+
+### Added
+
+- No notable changes yet.
+
+## [0.1.0] - 2026-02-26
+
+### Added
+
+- Initial MCP server implementation for Anki Vector control.
+- Core robot tools including speech, animation, drive, camera capture, face display, pose, cube actions, and status.
+- TestPyPI publishing workflow (`.github/workflows/release-testpypi.yml`) for safe release validation.
+- Contributor and governance docs (`CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`, PR/issue templates).
+- GitHub automation for CI, devcontainer validation, release publishing, Dependabot, and CodeQL.
+
+### Changed
+
+- Repository line-ending policy now enforces LF via `.gitattributes` and `.editorconfig`.
+- Contribution guidance now includes devcontainer-first setup and release process.
+
+### Fixed
+
+- Normalized line-ending noise in the repository workflow.

vectorclaw_mcp-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,55 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+- Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers at: **conduct@vectorclaw.dev**
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.1:
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

vectorclaw_mcp-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to VectorClaw
+
+Thanks for helping improve VectorClaw.
+
+## Development Environment
+
+Use the devcontainer as the default contributor environment:
+
+1. Open the repository in VS Code.
+2. Run `Dev Containers: Reopen in Container`.
+3. Wait for setup to complete (`pip install -e .[dev]`).
+
+## Local Checks
+
+Run these before opening a pull request:
+
+```bash
+pytest -q
+python -m build
+```
+
+## Branch and PR Workflow
+
+1. Create a feature branch from `dev`.
+2. Keep commits focused and small.
+3. Open a pull request targeting `dev` with a clear summary and testing notes.
+4. Ensure GitHub Actions checks pass.
+5. If behavior changes for users, add an entry under `## [Unreleased]` in `CHANGELOG.md`.
+
+## Testing Guidance
+
+- Add or update tests for behavior changes.
+- Prefer deterministic unit tests.
+- If a change cannot be fully tested in CI (for example, physical robot behavior), include manual test steps in the PR.
+
+## Commit Style
+
+Prefer concise Conventional Commit style prefixes:
+
+- `feat:` new functionality
+- `fix:` bug fixes
+- `docs:` documentation changes
+- `test:` test-only changes
+- `chore:` maintenance and tooling
+
+## Releases
+
+Always validate publishing on TestPyPI before publishing to production PyPI.
+
+1. Run `.github/workflows/release-testpypi.yml` from GitHub Actions (`workflow_dispatch`).
+2. Verify the package can be installed from TestPyPI.
+3. Publish a GitHub Release to trigger `.github/workflows/release.yml` for real PyPI.
+
+Both workflows use Trusted Publishing (OIDC), so configure pending publishers in both PyPI and TestPyPI.
+
+Before publishing a release, move relevant `## [Unreleased]` items from `CHANGELOG.md`
+into a new version section and include that summary in GitHub Release notes.
+
+## Community and Security
+
+- Follow the project Code of Conduct in `CODE_OF_CONDUCT.md`.
+- Report vulnerabilities via `SECURITY.md` instead of public issues.

vectorclaw_mcp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 danmartinez78
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.