MindScript Google Executor

mindscript-google-executor maps MindScript operations to Google Workspace and Google Cloud APIs.

This repository is execution, not law.

It translates already-defined MindScript ops into concrete Google actions using deterministic C++ logic.

---

Purpose

MindScript expresses intent. This executor performs action against Google systems.

The executor:

• Receives MindScript program envelopes
• Validates Google-specific policy and quotas
• Dispatches ops to Gmail, Docs, Drive, Sheets, Calendar, or GCP
• Emits protocol-compliant results and commits

It does not interpret meaning. It performs authorized operations.

---

What lives here

• Google Workspace op implementations
• Google Cloud API bindings
• OAuth2 / service account handling
• Op-to-API mapping logic
• Deterministic execution adapters

---

What does NOT live here

• Protocol definitions (mindseye-protocol)
• Execution engine (mindscript-runtime)
• UI or Apps Script
• Business logic
• LLM orchestration

If it defines what an op means, it does not belong here.

---

Architectural Position

┌────────────────────────────┐ │ mindseye-protocol (law) │ └────────────┬───────────────┘ │ ┌────────────▼───────────────┐ │ mindscript-runtime │ │ (deterministic engine) │ └────────────┬───────────────┘ │ ┌────────────▼───────────────┐ │ mindscript-google-executor │ ← THIS REPO │ (Google surface adapter) │ └────────────┬───────────────┘ │ ┌────────────▼───────────────┐ │ Google Workspace / GCP │ └────────────────────────────┘

---

Submodules (Mandatory)

external/
├─ mindseye-protocol
└─ mindscript-runtime

https://github.com/PEACEBINFLOW/mindseye-protocol/tree/main
https://github.com/PEACEBINFLOW/mindscript-runtime-c/tree/main