Fix Alexa To Reminders: persistent WebView auth + XHR API calls

.claude/agents/scriptable-reviewer.md

@@ -0,0 +1,35 @@
+---
+name: scriptable-reviewer
+description: Reviews Scriptable widget scripts for size compatibility, API correctness, update-check pattern, and common iOS widget pitfalls
+---
+
+You are a Scriptable iOS widget expert. When invoked, review the provided script (or all recently edited scripts) for the following issues and report findings with line numbers and suggested fixes.
+
+## Review Checklist
+
+### Widget Size Compatibility
+- Missing `config.widgetFamily` guard when layout differs between small/medium/large/accessory sizes
+- Hardcoded pixel dimensions that will break at non-medium sizes
+- Text that will overflow at small size
+
+### Scriptable API Correctness
+- Use of unavailable APIs: no `fetch()`, `require()`, `fs`, `window`, `document`, or other browser/Node APIs
+- `FileManager.iCloud()` vs `FileManager.local()` — iCloud is preferred for synced scripts; flag if using local without clear reason
+- `Request` objects must call `.load()` or `.loadJSON()` — flag if response is accessed without awaiting load
+- `Script.complete()` must be called at the end of every execution path
+
+### Update Check Pattern
+- `updateCheck()` function should be present in scripts intended for public distribution
+- Version constant should be a number, not a string
+
+### Settings Pattern
+- Settings JSON should be read with null-safety (`fm.fileExists(settingsPath)` check before `readString`)
+- Settings directory should be created if it doesn't exist before writing
+
+### Common Pitfalls
+- `await` used outside async context
+- Uncaught promise rejections (missing try/catch on network calls)
+- Hardcoded API keys or tokens in the script body (flag as security issue)
+- Missing `Script.setWidget(widget)` call when `config.runsInWidget` is true
+
+Report all findings grouped by severity: **Error** (will crash), **Warning** (may misbehave), **Info** (style/best practice).

.claude/settings.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node tests/runner.js 2>&1 | tail -20"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"$CLAUDE_TOOL_INPUT\" | grep -q 'scriptable-mocks' && echo 'BLOCK: scriptable-mocks.js is shared by all tests — confirm this change is intentional before proceeding.' || true"
+          }
+        ]
+      }
+    ]
+  }
+}

.claude/skills/gen-test/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: gen-test
+description: Generate a Node.js test file for a Scriptable widget script, following the project's existing test conventions in tests/
+disable-model-invocation: true
+---
+
+Generate a test file for the Scriptable script named by the user (e.g. `/gen-test Twitter Widget.js`).
+
+## Steps
+
+1. Read the target `.js` script from the project root
+2. Read `tests/scriptable-mocks.js` to understand available mock factories
+3. Identify pure/testable functions in the script (logic that doesn't require a live Scriptable runtime)
+4. Create `tests/<kebab-name>.test.js` following the exact pattern used in existing test files:
+
+```javascript
+// Tests for <ScriptName>.js
+'use strict'
+
+const {
+  makeRequest, makeWebView, makeAlert, /* etc. — import only what's needed */
+} = require('./scriptable-mocks')
+
+// ─── Pure logic extracted from the script ────────────────────────────────────
+
+// Copy or re-express pure functions from the script here so they can be tested
+// without requiring the Scriptable runtime.
+
+// ─── Tests ───────────────────────────────────────────────────────────────────
+
+module.exports = async ({ test, describe, assert }) => {
+  describe('<ScriptName>', () => {
+    test('example: <function> returns expected value', () => {
+      // arrange
+      // act
+      // assert
+    })
+  })
+}
+```
+
+5. Add the new test file to the `files` array in `tests/runner.js` so it runs automatically.
+
+## Rules
+- Only test logic that can run in plain Node.js — no Scriptable runtime APIs in test bodies
+- Use injected `assert` from Node's built-in `assert` module (strict mode)
+- Follow the existing naming: `<kebab-case-script-name>.test.js`
+- Aim for at least 3 meaningful tests covering happy path, edge case, and error case

.claude/skills/new-script/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: new-script
+description: Scaffold a new Scriptable widget script with required headers, FileManager setup, settings JSON pattern, and updateCheck boilerplate
+disable-model-invocation: true
+---
+
+Create a new Scriptable widget script based on the name and description provided by the user.
+
+The script MUST start with exactly these 3 lines (no blank line before them):
+```
+// Variables used by Scriptable.
+// These must be at the very top of the file. Do not edit.
+// icon-color: <color>; icon-glyph: <glyph>;
+```
+
+Choose an appropriate `icon-color` from: red, deep-red, orange, yellow, green, teal, blue, deep-blue, indigo, purple, pink, white, gray, light-gray, dark-gray, black.
+Choose an appropriate `icon-glyph` from Font Awesome glyph names (e.g. calendar-alt, cloud-sun, dove, chart-bar, bell, star).
+
+After the header, scaffold the following structure:
+
+```javascript
+// Variables used by Scriptable.
+// These must be at the very top of the file. Do not edit.
+// icon-color: blue; icon-glyph: star;
+
+'use strict'
+
+const SCRIPT_VERSION = 1.0
+
+let fm = FileManager.iCloud()
+let scriptDir = fm.documentsDirectory() + '/<ScriptName>/'
+let settingsPath = scriptDir + 'settings.json'
+
+if (!fm.fileExists(scriptDir)) fm.createDirectory(scriptDir, false)
+
+let needUpdated = await updateCheck(SCRIPT_VERSION)
+
+let settings = {}
+if (fm.fileExists(settingsPath)) {
+  settings = JSON.parse(fm.readString(settingsPath))
+}
+
+// ─── Main widget ────────────────────────────────────────────────────────────
+
+let widget = new ListWidget()
+widget.backgroundColor = Color.dynamic(Color.white(), Color.black())
+
+// TODO: build widget UI here
+
+if (config.runsInWidget) {
+  Script.setWidget(widget)
+} else {
+  await widget.presentMedium()
+}
+Script.complete()
+
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+async function updateCheck(currentVersion) {
+  // Placeholder — replace with actual update URL for published scripts
+  return false
+}
+```
+
+Save the file as `<ScriptName>.js` in the project root. Ask the user for the script name, purpose, icon color, and icon glyph if not provided.