alvin-bot 4.18.1 → 4.18.2

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,21 @@
 
 All notable changes to Alvin Bot are documented here.
 
+## [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,6 +309,30 @@ 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.2 — Silent-empty-stream detection.
+                    //
+                    // If the stream terminated cleanly but produced ZERO text chunks,
+                    // something went wrong that the SDK didn't surface as an error:
+                    // most commonly a stale OAuth token after /extra-usage or /login
+                    // rotated the Keychain entry while our in-memory SDK client was
+                    // still holding the old one. The CLI subprocess silently gets a
+                    // 401, emits no text, and we complete the stream with
+                    // accumulatedText === "". The user sees "(Keine Antwort)".
+                    //
+                    // We flip this from silent failure to explicit error. Clearing
+                    // the availability cache forces the next heartbeat probe to
+                    // re-check `claude auth status` with a fresh subprocess (which
+                    // reads the current Keychain entry).
+                    if (accumulatedText === "" && outputTok === 0) {
+                        this.invalidateAvailabilityCache();
+                        yield {
+                            type: "error",
+                            error: "Claude returned an empty response. " +
+                                "This can happen right after /extra-usage, /login, or a token refresh — " +
+                                "the SDK held a stale auth token. I've invalidated the cache; please resend your message.",
+                        };
+                        return;
+                    }
                     yield {
                         type: "done",
                         text: accumulatedText,

package/package.json

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