kimal3 0.6.1 → 0.6.2

package/claude-plugins/kimal3-logo/.claude-plugin/plugin.json

@@ -1,6 +1,7 @@
-{
-  "name": "kimal3-logo",
-  "version": "0.2.0",
-  "description": "KImal3-Logo über dem Eingabefeld · KImal3 logo above the prompt",
-  "author": { "name": "KImal3", "url": "https://kimal3.de" }
-}
+{
+  "name": "kimal3-logo",
+  "version": "0.3.0",
+  "description": "KImal3-Logo über dem Eingabefeld, öffnet beim Start das Projekt in der App · KImal3 logo above the prompt, opens the project in the app on start",
+  "author": { "name": "KImal3", "url": "https://kimal3.de" },
+  "types": "./types/index.d.ts"
+}

package/claude-plugins/kimal3-logo/hooks/app-oeffnen.ts

@@ -0,0 +1,96 @@
+import { atom, read, update, type Engine, type Register } from 'claude-code'
+
+// Beim Start von Claude Code die Projektseite im Browser der Claude-App öffnen (Dennis, 23.10.: „Automatisch bei jedem
+// Start“, und zwar „in dem Browser in der Claude-Code-App“ — nicht im Standardbrowser).
+// Szenario-Tabelle: docs/superpowers/specs/2026-10-23-mod-app-oeffnen.md
+
+const APP = 'https://app.kimal3.de'
+// Positivliste (messen-und-pruefen §23): Nur eine Projektnummer kommt in die Adresse, nie ein anderer Wert aus der Datei (S-4).
+const PROJEKTNUMMER = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+// Der eingebaute Browser der Claude-App, wie ihn das Werkzeug `mcp__Claude_Browser__navigate` nennt.
+const BROWSER = 'Claude_Browser'
+const NAVIGATE = 'mcp__Claude_Browser__navigate'
+const geoeffnet = atom({ plugin: 'kimal3-logo', key: 'appGeoeffnet' } as const, false)
+
+/** Die Adresse für den Inhalt von `plan/stand.json` (`null`: keine Datei). Ohne gültige Nummer der Kurs, wie der Link in der Leiste (S-3, S-4). */
+export function adresseFuer(standJson: string | null): string {
+  if (standJson !== null) {
+    try {
+      // Ein BOM am Anfang (Windows-Editoren) lehnt JSON.parse ab, wie in `cli/src/plan-datei.ts`.
+      const id: unknown = JSON.parse(standJson.replace(/^\uFEFF/, ''))?.projekt_id
+      if (typeof id === 'string' && PROJEKTNUMMER.test(id)) return `${APP}/projekt/${id.toLowerCase()}`
+    } catch {
+      // kaputtes JSON: wie keine Datei
+    }
+  }
+  return `${APP}/kurs`
+}
+
+/** Die eigene Erlaubnis (unten): nur der Aufruf dieses Mods, nur eine Adresse der App. Herausgelöst, damit `check:logo` die Grenze prüft. */
+export function istEigenerAufruf(plugin: string, input: unknown): boolean {
+  const url = (input as { url?: unknown } | null)?.url
+  return plugin === 'kimal3-logo' && typeof url === 'string' && url.startsWith(`${APP}/`)
+}
+
+// Gegen zwei gleichzeitige Versuche in diesem Lauf (`session.start` und `session.attach` kurz hintereinander).
+// Das Neuladen des Mods setzt die Variable zurück; dagegen hält der Merker `geoeffnet`.
+let laeuft = false
+
+/**
+ * Höchstens einmal je Sitzung (S-7, S-8, S-10): Der Merker in `$.state` übersteht das Neuladen des Mods. Er wird erst
+ * nach einem gelungenen Aufruf gesetzt — scheitert der erste Versuch, darf ein späteres `session.attach` es noch einmal.
+ */
+async function einmalOeffnen($: Engine): Promise<void> {
+  if (laeuft || (await read($, geoeffnet))) return
+  laeuft = true
+  try {
+    if (await oeffne($)) await update($, geoeffnet, () => true)
+  } finally {
+    laeuft = false
+  }
+}
+
+async function oeffne($: Engine): Promise<boolean> {
+  const cwd = await $.session.cwd()
+  let stand: string | null = null
+  try {
+    stand = await $.fs.read(`${cwd}/plan/stand.json`)
+  } catch {
+    stand = null
+  }
+  // Scheitern meldet sich als Scheitern, nie im Chat (S-13): eine Zeile nur im Debug-Protokoll (`to: 'debug'` —
+  // ohne steht sie im Chatverlauf, Befund der Durchsicht 23.10.).
+  try {
+    const antwort = await $.mcp.call(BROWSER, 'navigate', { url: adresseFuer(stand) })
+    if (!antwort.isError) return true
+    $.ui.log(`kimal3-logo: Projektseite nicht geöffnet: ${JSON.stringify(antwort.content).slice(0, 300)}`, { to: 'debug' })
+  } catch (fehler) {
+    $.ui.log(`kimal3-logo: Projektseite nicht geöffnet: ${String(fehler).slice(0, 300)}`, { to: 'debug' })
+  }
+  return false
+}
+
+export const appOeffnen: Register = on => {
+  // Die eigene Erlaubnis, eng: nur der Aufruf dieses Mods, nur eine Adresse der App. Ohne sie lehnt der Auto-Modus
+  // ab, weil beim Start niemand um etwas gebeten hat (gemessen 23.10. mit einer Probe). Claudes eigene Aufrufe und
+  // jede andere Adresse entscheidet die Kette darunter wie bisher.
+  on('tool.check', { tool: NAVIGATE }, ($, e, next) =>
+    istEigenerAufruf(next.origin.plugin, e.input)
+      ? { decision: 'allow', reason: 'kimal3: die eigene Projektseite beim Start' }
+      : next(e),
+  )
+  // Den Browser gibt es nur in der Claude-App, nicht im Terminal oder in VS Code. Beim Start meldet die App
+  // `isInteractive: false`, ist aber schon angehängt (gemessen 23.10.: surfaces ["desktop"]). `claude -p`, Skripte,
+  // geplante Aufgaben, das Terminal: kein Aufruf (S-6).
+  on('session.start', async ($, e, next) => {
+    const result = await next(e)
+    if ((await $.session.surfaces()).includes('desktop')) await einmalOeffnen($)
+    return result
+  })
+  // Hängt sich die App erst nach dem Start an, kommt das Signal hier.
+  on('session.attach', async ($, e, next) => {
+    const result = await next(e)
+    if (e.surface === 'desktop') await einmalOeffnen($)
+    return result
+  })
+}

package/claude-plugins/kimal3-logo/hooks/register.tsx

@@ -1,80 +1,84 @@
-import type { Register } from 'claude-code'
-
-// Die Sprache des Kontos. `kimal3 einrichten` setzt diese Zeile beim Ablegen in `~/.kimal3/claude-plugins` und prüft
-// danach, dass sie gesetzt ist (`cli/src/logo-ablegen.ts`) — der Mod selbst kann keine Datei lesen.
-const SPRACHE: 'de' | 'en' = 'de'
-
-// Icon: docs/design/kimal3-icon-animated.svg, unverändert bis auf die viewBox:
-// Sie schneidet den leeren Rand um die drei Dreiecke weg (Original: 0 0 80 80).
-const ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="20 19 40 36" width="24" height="22">
-  <style>
-    /* color-scheme: sonst malt der Browser hinter die Grafik eine eigene Fläche, wenn hell/dunkel nicht zur App passt */
-    :root { background: transparent; color-scheme: light dark; }
-    .icon { opacity: 0.8; }
-    .tri  { fill: none; stroke: hsl(194 100% 51%); stroke-width: 2.8; stroke-linejoin: round; opacity: 0.7; }
-    .t1 { animation: trianglePulse 3s ease-in-out infinite; }
-    .t2 { animation: trianglePulse 3.5s ease-in-out infinite; animation-delay: .4s; }
-    .t3 { animation: trianglePulse 4s ease-in-out infinite; animation-delay: .8s; }
-    @keyframes trianglePulse { 0%,100% { opacity: .5; } 50% { opacity: 1; } }
-  </style>
-  <g class="icon">
-    <polygon class="tri t1" points="33.28,21.6 22.08,41.0 44.48,41.0" />
-    <polygon class="tri t2" points="46.72,21.6 35.52,41.0 57.92,41.0" />
-    <polygon class="tri t3" points="40.00,33.36 28.80,52.76 51.20,52.76" />
-  </g>
-</svg>`
-
-// Das Cyan der Marke (kimal3.de, --brand in der App)
-const MARKEN_CYAN = '#00C3FF'
-// Der Kurs, für alle (Dennis, 15.10.: „mach alle auf den Kurs“). Abgemeldete schickt die App von dort zum Login.
-// Fest auf `/firma` zeigte der Link Kostenlosen ohne Firma eine leere Seite (Spec L-51). Im Terminal: Strg+Klick; Claude Code hängt dort die Adresse
-// grau dahinter, wenn es dem Terminal keine Links zutraut — FORCE_HYPERLINK hilft nicht.
-const APP = 'https://app.kimal3.de/kurs'
-
-// Vor und nach der Wortmarke. Englisch: „AI Workplace“, nie „workspace“ (Spec, Global Constraints).
-const TEXT = {
-  de: { vor: 'Dein ', nach: '-Arbeitsplatz', alt: 'KImal3-Logo' },
-  en: { vor: 'Your ', nach: ' AI Workplace', alt: 'KImal3 logo' },
-}[SPRACHE]
-
-export const register: Register = on => {
-  on('ui.render', { component: 'AbovePrompt' }, ($, e, next) => {
-    if (e.props.hasSurvey) {
-      return next(e)
-    }
-
-    // Im Terminal gibt es kein Svg: drei Dreiecke als Zeichen, die Wortmarke wie auf kimal3.de
-    // („KI" in Schriftfarbe, „mal3" im Marken-Cyan). Das Cyan steht als Farbwert, nicht als „cyan" —
-    // das Terminal-Cyan ist je nach Farbschema ein anderes, oft ein blasses Türkis.
-    if (e.surface === 'terminal') {
-      const { Box, Link, Text } = $.ui.resolve(e)
-      return (
-        <Box flexDirection="row" gap={1}>
-          <Text color={MARKEN_CYAN} bold>{'▲▲▲'}</Text>
-          <Text bold>
-            {TEXT.vor}
-            <Link href={APP}>
-              {'KI'}
-              <Text color={MARKEN_CYAN}>{'mal3'}</Text>
-              {TEXT.nach}
-            </Link>
-            {'.'}
-          </Text>
-        </Box>
-      )
-    }
-
-    // isInteractive: erst damit spielt die Leiste die CSS-Animation ab, sonst steht das Icon still.
-    const { Box, Link, Svg, Text } = $.ui.resolve(e)
-    return (
-      <Box flexDirection="row" alignItems="center" gap={1}>
-        <Svg source={ICON} alt={TEXT.alt} width={24} height={22} isInteractive />
-        <Text bold>
-          {TEXT.vor}
-          <Link href={APP}>{`KImal3${TEXT.nach}`}</Link>
-          {'.'}
-        </Text>
-      </Box>
-    )
-  })
-}
+import type { Register } from 'claude-code'
+import { appOeffnen } from './app-oeffnen'
+
+// Die Sprache des Kontos. `kimal3 einrichten` setzt diese Zeile beim Ablegen in `~/.kimal3/claude-plugins` und prüft
+// danach, dass sie gesetzt ist (`cli/src/logo-ablegen.ts`).
+const SPRACHE: 'de' | 'en' = 'de'
+
+// Icon: docs/design/kimal3-icon-animated.svg, unverändert bis auf die viewBox:
+// Sie schneidet den leeren Rand um die drei Dreiecke weg (Original: 0 0 80 80).
+const ICON = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="20 19 40 36" width="24" height="22">
+  <style>
+    /* color-scheme: sonst malt der Browser hinter die Grafik eine eigene Fläche, wenn hell/dunkel nicht zur App passt */
+    :root { background: transparent; color-scheme: light dark; }
+    .icon { opacity: 0.8; }
+    .tri  { fill: none; stroke: hsl(194 100% 51%); stroke-width: 2.8; stroke-linejoin: round; opacity: 0.7; }
+    .t1 { animation: trianglePulse 3s ease-in-out infinite; }
+    .t2 { animation: trianglePulse 3.5s ease-in-out infinite; animation-delay: .4s; }
+    .t3 { animation: trianglePulse 4s ease-in-out infinite; animation-delay: .8s; }
+    @keyframes trianglePulse { 0%,100% { opacity: .5; } 50% { opacity: 1; } }
+  </style>
+  <g class="icon">
+    <polygon class="tri t1" points="33.28,21.6 22.08,41.0 44.48,41.0" />
+    <polygon class="tri t2" points="46.72,21.6 35.52,41.0 57.92,41.0" />
+    <polygon class="tri t3" points="40.00,33.36 28.80,52.76 51.20,52.76" />
+  </g>
+</svg>`
+
+// Das Cyan der Marke (kimal3.de, --brand in der App)
+const MARKEN_CYAN = '#00C3FF'
+// Der Kurs, für alle (Dennis, 15.10.: „mach alle auf den Kurs“). Abgemeldete schickt die App von dort zum Login.
+// Fest auf `/firma` zeigte der Link Kostenlosen ohne Firma eine leere Seite (Spec L-51). Im Terminal: Strg+Klick; Claude Code hängt dort die Adresse
+// grau dahinter, wenn es dem Terminal keine Links zutraut — FORCE_HYPERLINK hilft nicht.
+const APP = 'https://app.kimal3.de/kurs'
+
+// Vor und nach der Wortmarke. Englisch: „AI Workplace“, nie „workspace“ (Spec, Global Constraints).
+const TEXT = {
+  de: { vor: 'Dein ', nach: '-Arbeitsplatz', alt: 'KImal3-Logo' },
+  en: { vor: 'Your ', nach: ' AI Workplace', alt: 'KImal3 logo' },
+}[SPRACHE]
+
+export const register: Register = (on, options) => {
+  // Beim Start die Projektseite in der App öffnen (hooks/app-oeffnen.ts).
+  appOeffnen(on, options)
+
+  on('ui.render', { component: 'AbovePrompt' }, ($, e, next) => {
+    if (e.props.hasSurvey) {
+      return next(e)
+    }
+
+    // Im Terminal gibt es kein Svg: drei Dreiecke als Zeichen, die Wortmarke wie auf kimal3.de
+    // („KI" in Schriftfarbe, „mal3" im Marken-Cyan). Das Cyan steht als Farbwert, nicht als „cyan" —
+    // das Terminal-Cyan ist je nach Farbschema ein anderes, oft ein blasses Türkis.
+    if (e.surface === 'terminal') {
+      const { Box, Link, Text } = $.ui.resolve(e)
+      return (
+        <Box flexDirection="row" gap={1}>
+          <Text color={MARKEN_CYAN} bold>{'▲▲▲'}</Text>
+          <Text bold>
+            {TEXT.vor}
+            <Link href={APP}>
+              {'KI'}
+              <Text color={MARKEN_CYAN}>{'mal3'}</Text>
+              {TEXT.nach}
+            </Link>
+            {'.'}
+          </Text>
+        </Box>
+      )
+    }
+
+    // isInteractive: erst damit spielt die Leiste die CSS-Animation ab, sonst steht das Icon still.
+    const { Box, Link, Svg, Text } = $.ui.resolve(e)
+    return (
+      <Box flexDirection="row" alignItems="center" gap={1}>
+        <Svg source={ICON} alt={TEXT.alt} width={24} height={22} isInteractive />
+        <Text bold>
+          {TEXT.vor}
+          <Link href={APP}>{`KImal3${TEXT.nach}`}</Link>
+          {'.'}
+        </Text>
+      </Box>
+    )
+  })
+}

package/claude-plugins/kimal3-logo/types/index.d.ts

@@ -0,0 +1,8 @@
+declare module 'claude-code' {
+  interface PluginState {
+    'kimal3-logo': {
+      // Die Projektseite wurde in dieser Sitzung schon geöffnet (hooks/app-oeffnen.ts) — übersteht das Neuladen des Mods.
+      appGeoeffnet: boolean
+    }
+  }
+}

package/package.json

@@ -1,30 +1,30 @@
-{
-  "name": "kimal3",
-  "version": "0.6.1",
-  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal. · Log your AI projects where they happen: in the terminal.",
-  "type": "module",
-  "bin": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "claude-plugins",
-    "coach",
-    "zeigen",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "kimal3",
-    "cli"
-  ],
-  "homepage": "https://app.kimal3.de/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.6.2",
+  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal. · Log your AI projects where they happen: in the terminal.",
+  "type": "module",
+  "bin": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "claude-plugins",
+    "coach",
+    "zeigen",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kimal3",
+    "cli"
+  ],
+  "homepage": "https://app.kimal3.de/pro",
+  "license": "SEE LICENSE IN README.md"
+}