alvin-bot 4.18.1 → 4.18.3

package/AEC-PLUGINS-SOURCES.md

@@ -0,0 +1,53 @@
+# AEC Plugin Skills — Installed 22.04.2026
+
+54 Skills aus 3 Claude-Code-Plugins, erstellt von **Abhinav Bhardwaj** (GitHub: `Amanbh997`).
+Installiert via direkte Kopie in `~/.claude/skills/` — Claude Code auto-discovered via SKILL.md frontmatter.
+
+Vorher: 89 Skills. Nachher: **143 Skills** (+54).
+
+## Quellen
+
+| Plugin | Repo | Skills | Stars |
+|---|---|---|---|
+| **Urban Design** | [Amanbh997/Urban-Design-Skills-Claude](https://github.com/Amanbh997/Urban-Design-Skills-Claude) | 18 | ⭐ 76 |
+| **Architecture** | [Amanbh997/Skills-Architects](https://github.com/Amanbh997/Skills-Architects) | 18 | ⭐ 118 |
+| **Computational Design** | [Amanbh997/Claude-skills-for-Computational-Designers](https://github.com/Amanbh997/Claude-skills-for-Computational-Designers) | 18 | ⭐ 127 |
+
+Jedes Plugin: 35.000+ Zeilen, 7 Python-Calculators, 50+ Theorists, 30+ Tools, hunderte numerische Benchmarks.
+
+## Skill-Inventar
+
+### Urban Design (18)
+block-and-density · climate-responsive-design · cost-estimation · design-brief · design-evaluation · masterplan-design · mixed-use-programming · mobility-and-transport · precedent-study · public-space-design · site-analysis · street-design · sustainability-scoring · tod-design · urban-calculator · urban-design-foundations · urban-regeneration · zoning-and-codes
+
+### Architecture (18)
+accessibility-design · acoustic-design · architect-calculator · architect-foundations · building-codes · building-envelope · building-programming · building-services · building-sustainability · building-typology · concept-design · construction-documentation · daylighting-design · design-theory · fire-life-safety · material-selection · spatial-planning · structural-systems
+
+### Computational Design (18)
+algorithmic-patterns · bim-scripting · cd-calculator · cd-foundations · computational-geometry · data-driven-design · design-automation · digital-fabrication · environmental-simulation · facade-computation · generative-design · interoperability · mesh-processing · ml-for-aec · optimization-methods · parametric-modeling · scripting-reference · structural-computation
+
+## Update ziehen
+
+```bash
+cd /tmp && rm -rf aec-skills && mkdir aec-skills && cd aec-skills
+git clone --depth 1 https://github.com/Amanbh997/Urban-Design-Skills-Claude.git
+git clone --depth 1 https://github.com/Amanbh997/Skills-Architects.git
+git clone --depth 1 https://github.com/Amanbh997/Claude-skills-for-Computational-Designers.git
+cp -R Urban-Design-Skills-Claude/skills/* ~/.claude/skills/
+cp -R Skills-Architects/skills/* ~/.claude/skills/
+cp -R Claude-skills-for-Computational-Designers/skills/* ~/.claude/skills/
+```
+
+## Wie die Skills ausgelöst werden
+
+Jeder Skill hat im SKILL.md frontmatter eine `description`-Zeile die spezifische User-Anfragen matcht. Beispiele:
+
+- „Design a mixed-use quarter" → Urban Design Plugin (masterplan-design, tod-design, mixed-use-programming, zoning-and-codes, mobility-and-transport …)
+- „Check if this floor plan meets fire code" → Architecture Plugin (fire-life-safety, building-codes, accessibility-design, construction-documentation …)
+- „Generate a parametric facade pattern in Grasshopper" → Computational Design Plugin (parametric-modeling, facade-computation, algorithmic-patterns, digital-fabrication …)
+
+Laut Creator: *"Ask Claude to design a mixed-use quarter and all three plugins kick in working together."*
+
+## Quelle
+Reel vom Creator: https://www.instagram.com/reel/DXXhJS2kqAf/
+Uploader: Abhinav Bhardwaj / "Claude for AEC!"

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to Alvin Bot are documented here.
 
+## [4.18.3] — 2026-04-23
+
+### 🐛 Hotfix: 4.18.2 triggered unwanted failover to Ollama
+
+**Bug in 4.18.2:** The empty-stream detector yielded an `error` chunk, which the registry's `queryWithFallback()` interprets as "primary provider failed" and immediately switches to the fallback (Ollama/Gemma 4). User saw `⚡ Claude (Agent SDK) unavailable — switching to Gemma 4 E4B` after every token rotation — the opposite of the intended behavior.
+
+**Fix:** yield a `text` chunk instead of `error`. Same user-visible message, same cache-invalidation, but no failover cascade. The next CLI subprocess spawns with the fresh Keychain token automatically, and claude-sdk stays selected.
+
+## [4.18.2] — 2026-04-23
+
+### 🐛 Fix: silent empty-stream after OAuth-token rotation
+
+**Problem:** After running `/extra-usage`, `/login`, or any other flow that rotates the Claude OAuth token in the macOS Keychain, the Alvin-Bot silently broke for long-lived sessions. The in-memory Claude SDK client held the old token, the CLI subprocess emitted no text chunks (the 401 was swallowed upstream), the stream terminated normally with zero output tokens, and the user saw the fallback `"(Keine Antwort)"` — with no indication that a token refresh was needed.
+
+**Fix** (`src/providers/claude-sdk-provider.ts`): In the `result` branch of the SDK stream loop, detect the empty-stream signature (`accumulatedText === ""` and `outputTokens === 0`). When that fires:
+
+1. Invalidate the `isAvailable()` cache so the next heartbeat probe spawns a fresh CLI subprocess that reads the current Keychain entry.
+2. Yield an explicit `error` chunk with actionable text so the user sees *"…token rotation — please resend your message"* instead of a silent `"(Keine Antwort)"`.
+
+**Applies to:** every token-rotation flow — extra-usage activation, extra-usage expiry, weekly-reset (no rotation → unaffected), manual `claude login`.
+
+**Net effect:** Bot self-heals after token changes. A single resend on the user side is enough; no manual restart required.
+
 ## [4.18.1] — 2026-04-20
 
 ### 🔒 Privacy-Guard: pre-publish check blocks PII leaks in shipped files

package/DESIGN-SKILLS-SOURCES.md

@@ -0,0 +1,81 @@
+# Design Skills — Installed 22.04.2026
+
+19 neue Skills aus 2 Repos + Bestätigung dass Frontend Design bereits via Anthropic Plugin installiert ist.
+
+## Quellen
+
+| Skill | Repo | Stars | Status |
+|---|---|---|---|
+| **Impeccable** (18 commands) | [pbakaus/impeccable](https://github.com/pbakaus/impeccable) | ⭐ 21.419 | ✅ Neu installiert |
+| **Design Motion Principles** | [kylezantos/design-motion-principles](https://github.com/kylezantos/design-motion-principles) | ⭐ 293 | ✅ Neu installiert |
+| **Frontend Design** | [anthropics/skills/frontend-design](https://github.com/anthropics/skills) | — | ℹ️ War bereits aktiv (Plugin `frontend-design:frontend-design`) |
+
+## Reel-Quelle
+Marc Cleroux auf Instagram — https://www.instagram.com/reel/DXdVUiOjKUv/ (22.04.2026)
+
+## Impeccable-Commands (18)
+
+Vokabular um Claude bei frontend-design zu steuern wenn dir die richtigen Worte fehlen.
+
+| Command | Funktion |
+|---|---|
+| `/impeccable` | Core skill mit 18 commands + 7 Referenz-Domänen |
+| `/adapt` | Responsive / Breakpoints / Touch-Targets |
+| `/animate` | Purposeful motion + micro-interactions |
+| `/audit` | Technische Quality Checks (a11y, perf, responsive) + scored report |
+| `/bolder` | Bland → visuell interessanter |
+| `/clarify` | Unklare UX-Copy verbessern |
+| `/colorize` | Strategische Farbe einführen |
+| `/critique` | UX Design Review (Hierarchie, Klarheit, Resonanz) |
+| `/delight` | Joy-Momente, Personality, Memorable Touches |
+| `/distill` | Auf Essenz reduzieren, Complexity weg |
+| `/harden` | Error Handling, Empty States, Onboarding, i18n, Edge Cases |
+| `/layout` | Layout / Spacing / Visual Rhythm fixen |
+| `/optimize` | Performance (Bundle, Rendering, Images) |
+| `/overdrive` | Technisch ambitioniert — Shaders, Spring Physics, 60fps |
+| `/polish` | Final Quality Pass pre-shipping |
+| `/quieter` | Overstimulating Design beruhigen |
+| `/shape` | UX/UI-Plan vor Code |
+| `/typeset` | Typografie fixen |
+
+### 7 Referenz-Domänen in `impeccable`
+typography · color-and-contrast · spatial-design · motion-design · interaction-design · responsive-design · ux-writing
+
+## Design Motion Principles
+
+Motion-Audit-Skill basierend auf den Philosophien von:
+- **Emil Kowalski** — iOS-native UI polish
+- **Jakub Krehel** — smooth interaction design
+- **Jhey Tompkins** — creative web animation
+
+Use case: *"Audit the hover states and transitions on my landing page"* → strukturierter Motion-Report.
+
+## Installation
+
+Geklont + direkt in `~/.claude/skills/` einzeln kopiert (Impeccable folgt dem Pattern aus ihrer README: `cp -r dist/claude-code/.claude/* ~/.claude/`).
+
+## Update ziehen
+
+```bash
+cd /tmp && rm -rf design-skills && mkdir design-skills && cd design-skills
+git clone --depth 1 https://github.com/pbakaus/impeccable.git
+git clone --depth 1 https://github.com/kylezantos/design-motion-principles.git
+cp -R impeccable/.claude/skills/. ~/.claude/skills/
+cp -R design-motion-principles/skills/design-motion-principles ~/.claude/skills/
+```
+
+## Stand Skills-Inventar (22.04.2026)
+- Vorher: 143 (nach AEC-Installation)
+- Nachher: **162** (+19)
+
+## Nebenbaustelle
+Impeccable bringt zusätzlich eine `.claude/agents/anti-patterns.md` mit — nicht installiert (würde Permission für `~/.claude/agents/` brauchen). Das ist optional: Die 18 Skills funktionieren unabhängig vom Anti-Patterns-Agent. Falls später gewünscht: `cp -R /tmp/design-skills/impeccable/.claude/agents/. ~/.claude/agents/`
+
+## Empfohlene Workflow-Kombination
+
+Laut Marc Cleroux im Reel ist das Power-Trio:
+1. **shape** (plan before code) — Teil von Impeccable
+2. **frontend-design** (implement mit Geschmack) — schon installiert
+3. **audit** + **critique** + **polish** (iterieren) — Impeccable
+
+Bei jedem neuen Frontend-Build: `/shape` → `/impeccable craft` → `/audit` → `/critique` → `/polish` → shippen.

package/dist/providers/claude-sdk-provider.js

@@ -309,9 +309,40 @@ export class ClaudeSDKProvider {
                         ? (usage.input_tokens || 0) + (usage.cache_creation_input_tokens || 0) + (usage.cache_read_input_tokens || 0)
                         : 0;
                     const outputTok = usage?.output_tokens || 0;
+                    // v4.18.3 — Silent-empty-stream detection (replaces 4.18.2 approach).
+                    //
+                    // If the stream terminated cleanly but produced ZERO text chunks,
+                    // something went wrong that the SDK didn't surface as an error.
+                    // Most common cause: the OAuth token in the Keychain was rotated
+                    // (e.g. right after /extra-usage or /login) while our in-memory
+                    // SDK client still held the old one — the CLI subprocess silently
+                    // gets a 401, emits no text, and we complete with
+                    // accumulatedText === "".
+                    //
+                    // CRITICAL: we must NOT yield an "error" chunk here — the registry's
+                    // queryWithFallback() treats that as "primary failed" and kicks off
+                    // a full failover to the next provider (Ollama). That's exactly
+                    // wrong: the next CLI subprocess would have picked up the fresh
+                    // token by itself. Instead we:
+                    //   1. Invalidate the availability cache so the next heartbeat
+                    //      re-probes `claude auth status` with a fresh subprocess.
+                    //   2. Return a friendly "text" chunk explaining what happened,
+                    //      so the user sees a clear message (not "(Keine Antwort)")
+                    //      and knows to resend — without tripping the failover.
+                    if (accumulatedText === "" && outputTok === 0) {
+                        this.invalidateAvailabilityCache();
+                        const hint = "⚠️ Claude antwortete mit leerem Stream (meist nach /extra-usage, /login oder Token-Refresh). " +
+                            "Der SDK-Token-Cache wurde geleert — bitte schick die Nachricht einfach nochmal.";
+                        yield {
+                            type: "text",
+                            text: hint,
+                            delta: hint,
+                            sessionId: resultMsg.session_id || capturedSessionId,
+                        };
+                    }
                     yield {
                         type: "done",
-                        text: accumulatedText,
+                        text: accumulatedText || "",
                         sessionId: resultMsg.session_id || capturedSessionId,
                         costUsd: "total_cost_usd" in resultMsg ? resultMsg.total_cost_usd : 0,
                         inputTokens: inputTok,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alvin-bot",
-  "version": "4.18.1",
+  "version": "4.18.3",
   "description": "Alvin Bot \u2014 Your personal AI agent on Telegram, WhatsApp, Discord, Signal, and Web.",
   "type": "module",
   "main": "dist/index.js",