Add GitHub Actions CI for syntax checks and optional remote Apps Script tests; add clasp/Apps Script CI infra (WiP)

.clasp.json.example

@@ -0,0 +1,4 @@
+{
+  "scriptId": "YOUR_SCRIPT_ID_HERE",
+  "rootDir": "."
+}

.claspignore

@@ -0,0 +1,35 @@
+# Ignore everything by default so Apps Script receives only the manifest and src/.
+**
+
+# Required Apps Script manifest.
+!appsscript.json
+
+# Application source files.
+!src/
+!src/**
+
+# Documentation files — intentionally ignored; do not deploy to Apps Script
+README.md
+LICENSE
+
+# CI and clasp template files.
+.github/
+.github/**
+.clasp.json.example
+
+# Future Node.js tooling and dependency files.
+package.json
+package-lock.json
+npm-shrinkwrap.json
+yarn.lock
+pnpm-lock.yaml
+pnpm-workspace.yaml
+node_modules/
+node_modules/**
+.npmrc
+.yarnrc
+.yarnrc.yml
+.pnpm-store/
+.pnpm-store/**
+.yarn/
+.yarn/**

.github/scripts/prepare-tests.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TEST_FILE="src/testFunctions.gs"
+ENABLE_API_KEY_TESTS="${ENABLE_API_KEY_TESTS:-false}"
+ENABLE_VERTEX_AI_TESTS="${ENABLE_VERTEX_AI_TESTS:-false}"
+OPEN_AI_API_KEY="${OPEN_AI_API_KEY:-}"
+GEMINI_API_KEY="${GEMINI_API_KEY:-}"
+VERTEX_AI_PROJECT_ID="${VERTEX_AI_PROJECT_ID:-}"
+VERTEX_AI_LOCATION="${VERTEX_AI_LOCATION:-global}"
+
+if [ ! -f "$TEST_FILE" ]; then
+  echo "::error::${TEST_FILE} not found; cannot prepare remote Apps Script tests."
+  exit 1
+fi
+
+if [ "$ENABLE_API_KEY_TESTS" = "true" ]; then
+  missing=()
+  if [ -z "$OPEN_AI_API_KEY" ]; then
+    missing+=("OPEN_AI_API_KEY")
+  fi
+  if [ -z "$GEMINI_API_KEY" ]; then
+    missing+=("GEMINI_API_KEY")
+  fi
+
+  if [ "${#missing[@]}" -gt 0 ]; then
+    printf '::error::Cannot prepare API key tests because required environment variable(s) are missing: %s\n' "${missing[*]}"
+    exit 1
+  fi
+else
+  echo "Skipping API key validation: API key tests are disabled."
+fi
+
+if [ "$ENABLE_VERTEX_AI_TESTS" = "true" ]; then
+  if [ -z "$VERTEX_AI_PROJECT_ID" ]; then
+    echo "::error::Cannot prepare Vertex AI tests because VERTEX_AI_PROJECT_ID is missing."
+    exit 1
+  fi
+else
+  echo "Skipping Vertex AI configuration validation: Vertex AI tests are disabled."
+fi
+
+echo "Validated remote Apps Script test configuration without modifying ${TEST_FILE}."