kimal3 0.6.4 → 0.7.0

package/dist/texte/meldungen.js

@@ -0,0 +1,127 @@
+const de = {
+    // ── projekt verbinden ──
+    connectHelp: `
+  kimal3 projekt verbinden [--neu] [--projekt <nummer>] [--firma "<Name>"]
+
+  Verbindet den Projektordner, in dem du stehst, mit seinem Projekt in der
+  App und schreibt den Ordnerzettel plan/projekt.json. Gibt es noch kein
+  Projekt mit dem Namen des Ordners, legt es eins an.
+
+  Liegt der Zettel schon da und gibt es das Projekt, passiert nichts.
+
+  --neu              Das Projekt zum Zettel wurde gelöscht: ein neues anlegen.
+  --projekt <n>      Es gibt mehrere gleichnamige: Nummer n aus der Liste.
+`,
+    connected: (titel) => `Ich habe diesen Ordner mit dem Projekt ‚${titel}‘ verbunden.`,
+    created: (titel) => `Ich habe das Projekt ‚${titel}‘ in der App angelegt.`,
+    deleted: "Das Projekt zu diesem Ordner gibt es in der App nicht mehr. Soll ich ein neues anlegen?",
+    deletedHow: "  Ein neues legt `kimal3 projekt verbinden --neu` an.",
+    candidate: (nummer, titel, projektId) => `  ${nummer} · ${titel} · ${projektId}`,
+    chooseHow: "  Wähle mit `kimal3 projekt verbinden --projekt <nummer>`.",
+    noSuchCandidate: (nummer, anzahl) => `Eine Nummer ${nummer} gibt es nicht — wähle eine von 1 bis ${anzahl}.`,
+    noProfile: "Für ein Projekt in der App brauchst du ein Erfolgsprofil — das bekommst du nach dem Kurs.",
+    notProjectFolder: "Hier ist kein Projektordner (einer direkt in werkbank-…/projekte/). In diesem Ordner gehört kein Projekt in die App.",
+    noteNotWritten: (titel, projektId) => `⚠ Das Projekt ‚${titel}‘ steht in der App, aber plan/projekt.json ließ sich nicht schreiben. Leg die Datei selbst an: {"format": 1, "projekt_id": "${projektId}", "titel": "${titel}"}`,
+    // ── plan melde / plan senden ──
+    reportHelp: `
+  kimal3 plan melde
+
+  Meldet der Projektseite eine Änderung: liest eine Meldung oder eine Liste
+  von Meldungen als JSON von der Eingabe, zum Beispiel
+    echo '{"art":"story","spec":"testmonat","story":"US-2","stand":"in_arbeit"}' | kimal3 plan melde
+  Arten: spec, story, thema, uebernommen, eingeordnet.
+
+  --ohne-sitzung     Meldet ohne die Nummer der Claude-Sitzung (für das
+                     Prüfen von Specs): Auf dem Board leuchtet kein Punkt.
+
+  Ist die Projektseite nicht erreichbar, merkt es sich die Meldung und
+  schickt sie beim nächsten Befehl mit.
+`,
+    sendHelp: `
+  kimal3 plan senden
+
+  Schickt die gemerkten Meldungen, die offline nicht ankamen. Das passiert
+  sonst von selbst vor jedem Befehl, der die App erreicht.
+`,
+    notConnected: "Dieser Ordner ist noch mit keinem Projekt in der App verbunden. Verbinde ihn zuerst: `kimal3 projekt verbinden`.",
+    noInput: "`kimal3 plan melde` liest die Meldung als JSON von der Eingabe. Hilfe: `kimal3 plan melde --help`.",
+    inputNoJson: "Die Eingabe ist kein JSON. Geschickt wurde nichts.",
+    reportUnreadable: (nummer, feld) => `Meldung Nr. ${nummer} ist nicht lesbar (${feld}). Geschickt wurde nichts.`,
+    stored: "Die Projektseite ist gerade nicht erreichbar — ich habe die Meldung gemerkt und schicke sie beim nächsten Mal.",
+    storedSignIn: "Du bist bei kimal3 nicht mehr angemeldet — `kimal3 login`. Ich habe die Meldung gemerkt und schicke sie danach.",
+    notStored: "Die Projektseite ist gerade nicht erreichbar, und die Meldung ließ sich auch nicht merken. Schick sie gleich noch einmal.",
+    specTextFailed: (datei) => `Die Meldung ist angekommen, der Text von ${datei} aber nicht. Schick die Meldung noch einmal — doppelt schadet nicht.`,
+    sentStored: (anzahl) => (anzahl === 1 ? "1 gemerkte Meldung nachgeschickt." : `${anzahl} gemerkte Meldungen nachgeschickt.`),
+    nothingStored: "Keine gemerkten Meldungen.",
+    refusedStored: (anzahl) => (anzahl === 1 ? "1 gemerkte Meldung hat die App abgesagt:" : `${anzahl} gemerkte Meldungen hat die App abgesagt:`),
+    unreadableStored: (dateien, ordner) => `${dateien.length === 1 ? "1 gemerkte Meldung lässt sich nicht lesen und bleibt" : `${dateien.length} gemerkte Meldungen lassen sich nicht lesen und bleiben`} liegen (${ordner}): ${dateien.join(", ")}`,
+    storedPartly: (gemerkt, gesamt) => `Die Projektseite ist gerade nicht erreichbar — von ${gesamt} Meldungen habe ich nur ${gemerkt} gemerkt; die übrigen ${gesamt - gemerkt} schick noch einmal.`,
+    specTextSignIn: (datei) => `Die Meldung ist angekommen, der Text von ${datei} aber nicht: Du bist bei kimal3 nicht mehr angemeldet — \`kimal3 login\`, dann die Meldung noch einmal.`,
+    specTextTooBig: (datei) => `Die Meldung ist angekommen, der Text von ${datei} aber nicht: Er passt nicht mehr auf die Projektseite (eine Spec höchstens 300 KB, alle zusammen 4 MB). Ein zweiter Versuch hilft nicht.`,
+    stillStored: (anzahl) => `Die Projektseite ist gerade nicht erreichbar — ${anzahl === 1 ? "1 Meldung bleibt" : `${anzahl} Meldungen bleiben`} gemerkt.`,
+};
+const en = {
+    connectHelp: `
+  kimal3 project connect [--new] [--project <number>] [--company "<Name>"]
+
+  Connects the project folder you're in with its project in the app and
+  writes the folder note plan/projekt.json. If there's no project named
+  like the folder yet, it creates one.
+
+  If the note is already there and the project exists, nothing happens.
+
+  --new              The note's project was deleted: create a new one.
+  --project <n>      There are several with that name: number n from the list.
+
+  The German option names (--neu, --projekt, --firma) work too.
+`,
+    connected: (titel) => `I connected this folder to the project ‘${titel}’.`,
+    created: (titel) => `I created the project ‘${titel}’ in the app.`,
+    deleted: "The project for this folder no longer exists in the app. Shall I create a new one?",
+    deletedHow: "  `kimal3 project connect --new` creates a new one.",
+    candidate: (nummer, titel, projektId) => `  ${nummer} · ${titel} · ${projektId}`,
+    chooseHow: "  Choose with `kimal3 project connect --project <number>`.",
+    noSuchCandidate: (nummer, anzahl) => `There's no number ${nummer} — choose one from 1 to ${anzahl}.`,
+    noProfile: "For a project in the app you need a success profile — you get it after the course.",
+    notProjectFolder: "This isn't a project folder (one directly inside workbench-…/projects/). No project in the app belongs to this folder.",
+    noteNotWritten: (titel, projektId) => `⚠ The project ‘${titel}’ is in the app, but plan/projekt.json couldn't be written. Create the file yourself: {"format": 1, "projekt_id": "${projektId}", "titel": "${titel}"}`,
+    reportHelp: `
+  kimal3 plan report
+
+  Reports a change to the project page: reads one report or a list of
+  reports as JSON from the input, for example
+    echo '{"art":"story","spec":"testmonat","story":"US-2","stand":"in_arbeit"}' | kimal3 plan report
+  Kinds (field "art"): spec, story, thema, uebernommen, eingeordnet.
+
+  --no-session       Reports without the Claude session number (for checking
+                     specs): no dot lights up on the board.
+
+  The German option name (--ohne-sitzung) works too.
+
+  If the project page can't be reached, it keeps the report and sends it
+  along with the next command.
+`,
+    sendHelp: `
+  kimal3 plan send
+
+  Sends the kept reports that didn't arrive while offline. Otherwise this
+  happens on its own before every command that reaches the app.
+`,
+    notConnected: "This folder isn't connected to a project in the app yet. Connect it first: `kimal3 project connect`.",
+    noInput: "`kimal3 plan report` reads the report as JSON from the input. Help: `kimal3 plan report --help`.",
+    inputNoJson: "The input isn't JSON. Nothing was sent.",
+    reportUnreadable: (nummer, feld) => `Report no. ${nummer} can't be read (${feld}). Nothing was sent.`,
+    stored: "The project page can't be reached right now — I've kept the report and will send it next time.",
+    storedSignIn: "You're no longer signed in to kimal3 — `kimal3 login`. I've kept the report and will send it afterwards.",
+    notStored: "The project page can't be reached right now, and the report couldn't be kept either. Send it again in a moment.",
+    specTextFailed: (datei) => `The report arrived, but the text of ${datei} didn't. Send the report again — sending twice does no harm.`,
+    sentStored: (anzahl) => (anzahl === 1 ? "Sent 1 kept report." : `Sent ${anzahl} kept reports.`),
+    nothingStored: "No kept reports.",
+    refusedStored: (anzahl) => (anzahl === 1 ? "The app refused 1 kept report:" : `The app refused ${anzahl} kept reports:`),
+    unreadableStored: (dateien, ordner) => `${dateien.length === 1 ? "1 kept report can't be read and stays where it is" : `${dateien.length} kept reports can't be read and stay where they are`} (${ordner}): ${dateien.join(", ")}`,
+    storedPartly: (gemerkt, gesamt) => `The project page can't be reached right now — of ${gesamt} reports I could only keep ${gemerkt}; send the other ${gesamt - gemerkt} again.`,
+    specTextSignIn: (datei) => `The report arrived, but the text of ${datei} didn't: you're no longer signed in to kimal3 — \`kimal3 login\`, then send the report again.`,
+    specTextTooBig: (datei) => `The report arrived, but the text of ${datei} didn't: it no longer fits on the project page (at most 300 KB per spec, 4 MB altogether). Trying again won't help.`,
+    stillStored: (anzahl) => `The project page can't be reached right now — ${anzahl === 1 ? "1 report stays" : `${anzahl} reports stay`} kept.`,
+};
+export const MELDUNGEN_TEXTE = { de, en };

package/dist/texte/plan.js

@@ -3,13 +3,14 @@ const de = {
     listHelp: `
   kimal3 plan
 
-  Holt die offenen Rückmeldungen zu deiner Planung aus der App: jedes
-  „passt nicht“ und jedes notierte Thema mit seiner Nummer, dazu die
-  bestätigten Stories der aktuellen Runden.
+  Holt den Stand deiner Planung aus der App: jede Spec mit ihren Stories
+  (Stand und Runde), danach die offenen Rückmeldungen -- jedes „passt
+  nicht“ und jedes notierte Thema mit seiner Nummer -- und die bestätigten
+  Stories der aktuellen Runden.
 
-  Liest plan/stand.json im Ordner, um das Projekt zu finden. Ändert nichts.
+  Das Projekt steht im Ordnerzettel plan/projekt.json. Ändert nichts.
 `,
-    fileMissing: "Im Ordner liegt keine plan/stand.json. `/k3plan` legt sie an.",
+    fileMissing: "Im Ordner liegt keine plan/stand.json. Seit 0.7.0 meldet Claude jede Änderung einzeln; den Stand zeigt `kimal3 plan`.",
     noJson: "Der Plan ist nicht lesbar: plan/stand.json enthält kein gültiges JSON-Objekt.",
     openVerdict: (nummer, spec, story, runde, notiz) => `#${nummer} · passt nicht · ${spec} / ${story} (Runde ${runde}): ${notiz}`,
     openTopic: (nummer, notiz) => `#${nummer} · Thema: ${notiz}`,
@@ -17,18 +18,28 @@ const de = {
     confirmed: (liste) => `Bestätigt: ${liste}`,
     confirmedItem: (spec, story, runde) => `${spec} / ${story} (Runde ${runde})`,
     view: (adresse) => `Ansehen: ${adresse}`,
+    // Board in Echtzeit (US-1): der ganze Stand aus der App, eine Zeile je Spec und je Story.
+    specLine: (schluessel, titel, datei) => `Spec ${schluessel} · ${titel}${datei === null ? "" : ` (${datei})`}`,
+    storyLine: (schluessel, stand, runde, titel) => `  ${schluessel} · ${stand} · Runde ${runde} · ${titel}`,
+    storyStand: (stand) => (stand === "in_arbeit" ? "in Arbeit" : stand === "gebaut" ? "gebaut" : stand === "weggelassen" ? "weggelassen" : "offen"),
+    topicLine: (schluessel, text) => `Notiertes Thema ${schluessel}: ${text}`,
+    noPlanning: "Noch keine Planung in der App.",
     // ── plan-hoch.ts ──
     uploadHelp: `
-  kimal3 plan hoch [--ueberschreiben] [--probe]
+  kimal3 plan hoch --ueberschreiben [--probe]
 
-  Schickt plan/stand.json an dein Projekt in der App. Danach trägt es
-  projekt_id und basis in die Datei ein und leert uebernommen.
+  Seit 0.7.0 nicht mehr nötig: Claude meldet jede Änderung einzeln
+  (kimal3 plan melde), den Stand zeigt kimal3 plan.
 
-  --probe            Prüft alles wie beim Hochladen und speichert nichts.
+  Nur noch mit --ueberschreiben: Schickt plan/stand.json als Ganzes an
+  dein Projekt in der App und ersetzt den Stand dort -- für eine Planung,
+  die sich anders nicht mehr lesen lässt. Danach trägt es projekt_id und
+  basis in die Datei ein und leert uebernommen.
 
-  --ueberschreiben   Speichert auch dann, wenn in der App inzwischen ein
-                     neuerer Plan liegt (zwei Arbeitskopien).
+  --probe            Prüft alles wie beim Hochladen und speichert nichts.
 `,
+    // Ruling Task 7: `plan hoch` ohne --ueberschreiben (0.7.0).
+    uploadNotNeeded: "Nicht mehr nötig: Seit 0.7.0 meldet Claude jede Änderung einzeln. Den Stand zeigt `kimal3 plan`.",
     uploaded: (titel, stories, deinTest) => `✓ Planung für „${titel}“ hochgeladen: ${stories === 1 ? "1 Story" : `${stories} Stories`}, ` +
         `${deinTest === 1 ? "1 wartet" : `${deinTest} warten`} auf deinen Test.`,
     dryRun: (stories, uebernommen) => `Probelauf: würde ${stories === 1 ? "1 Story" : `${stories} Stories`} hochladen, ` +
@@ -50,13 +61,14 @@ const en = {
     listHelp: `
   kimal3 plan
 
-  Fetches the open responses to your planning from the app: every
-  “doesn't work” and every noted topic with its number, plus the
-  confirmed stories of the current rounds.
+  Fetches the state of your planning from the app: every spec with its
+  stories (state and round), then the open responses -- every “doesn't
+  work” and every noted topic with its number -- and the confirmed
+  stories of the current rounds.
 
-  Reads plan/stand.json in this folder to find the project. Changes nothing.
+  The project is named in the folder note plan/projekt.json. Changes nothing.
 `,
-    fileMissing: "There's no plan/stand.json in this folder. `/k3plan` creates it.",
+    fileMissing: "There's no plan/stand.json in this folder. Since 0.7.0 Claude reports every change on its own; `kimal3 plan` shows the state.",
     noJson: "The plan can't be read: plan/stand.json doesn't contain a valid JSON object.",
     openVerdict: (nummer, spec, story, runde, notiz) => `#${nummer} · doesn't work · ${spec} / ${story} (round ${runde}): ${notiz}`,
     openTopic: (nummer, notiz) => `#${nummer} · Topic: ${notiz}`,
@@ -64,19 +76,27 @@ const en = {
     confirmed: (liste) => `Confirmed: ${liste}`,
     confirmedItem: (spec, story, runde) => `${spec} / ${story} (round ${runde})`,
     view: (adresse) => `View: ${adresse}`,
+    specLine: (schluessel, titel, datei) => `Spec ${schluessel} · ${titel}${datei === null ? "" : ` (${datei})`}`,
+    storyLine: (schluessel, stand, runde, titel) => `  ${schluessel} · ${stand} · round ${runde} · ${titel}`,
+    storyStand: (stand) => (stand === "in_arbeit" ? "in progress" : stand === "gebaut" ? "built" : stand === "weggelassen" ? "left out" : "open"),
+    topicLine: (schluessel, text) => `Noted topic ${schluessel}: ${text}`,
+    noPlanning: "No planning in the app yet.",
     uploadHelp: `
-  kimal3 plan upload [--overwrite] [--dry-run]
+  kimal3 plan upload --overwrite [--dry-run]
 
-  Sends plan/stand.json to your project in the app. After that it enters
-  projekt_id and basis in the file and empties uebernommen.
+  No longer needed since 0.7.0: Claude reports every change on its own
+  (kimal3 plan report), kimal3 plan shows the state.
 
-  --dry-run          Checks everything like an upload and saves nothing.
+  Only with --overwrite: Sends plan/stand.json as a whole to your project
+  in the app and replaces the state there -- for a planning that can't be
+  read any other way. After that it enters projekt_id and basis in the
+  file and empties uebernommen.
 
-  --overwrite        Saves even if the app already holds a newer plan
-                     (two working copies).
+  --dry-run          Checks everything like an upload and saves nothing.
 
   The German option names (--ueberschreiben, --probe) work too.
 `,
+    uploadNotNeeded: "No longer needed: since 0.7.0 Claude reports every change on its own. `kimal3 plan` shows the state.",
     uploaded: (titel, stories, deinTest) => `✓ Planning for "${titel}" uploaded: ${stories === 1 ? "1 story" : `${stories} stories`}, ${deinTest} waiting for your test.`,
     dryRun: (stories, uebernommen) => `Dry run: would upload ${stories === 1 ? "1 story" : `${stories} stories`} and mark ` +
         `${uebernommen === 1 ? "1 response" : `${uebernommen} responses`} as handled. Nothing was saved.`,

package/dist/texte/wache.js

@@ -2,8 +2,8 @@ const de = {
     accessExpired: (login) => "🔴🔴🔴 kimal3: Dein Zugang ist abgelaufen — zum Beispiel nach einem neuen Passwort " +
         `oder einer längeren Pause. Melde dich neu an mit:  ${login}  🔴🔴🔴`,
     messageFromKimal3: (text) => `Nachricht von kimal3: „${text}“`,
-    newVersion: (neu, eigene) => `🟡🟡🟡 kimal3: Es gibt eine neuere Version: ${neu} (du hast ${eigene}). ` +
-        `Holen mit:  ! npm install -g kimal3@${neu}  🟡🟡🟡`,
+    newVersion: (neu, eigene, skill) => `🟡🟡🟡 kimal3: Es gibt eine neuere Version: ${neu} (du hast ${eigene}). ` +
+        `Holen mit:  ! npm install -g kimal3@${neu}  — danach:  ${skill}  🟡🟡🟡`,
     skillsOld: (befehl) => "🟡🟡🟡 kimal3: Deine /k3-Befehle in Claude sind veraltet oder in einer anderen Sprache als dein Konto. " +
         `Auffrischen:  ${befehl}  🟡🟡🟡`,
     instructionToClaude: "Anweisung an Claude: Gib die Zeilen oben dem Menschen als ERSTE Zeilen deiner nächsten " +
@@ -20,8 +20,8 @@ const en = {
     accessExpired: (login) => "🔴🔴🔴 kimal3: Your sign-in has expired, for example after a new password " +
         `or a long break. Sign in again with:  ${login}  🔴🔴🔴`,
     messageFromKimal3: (text) => `Message from kimal3: “${text}”`,
-    newVersion: (neu, eigene) => `🟡🟡🟡 kimal3: A newer version is available: ${neu} (you have ${eigene}). ` +
-        `Install it with:  ! npm install -g kimal3@${neu}  🟡🟡🟡`,
+    newVersion: (neu, eigene, skill) => `🟡🟡🟡 kimal3: A newer version is available: ${neu} (you have ${eigene}). ` +
+        `Install it with:  ! npm install -g kimal3@${neu}  — then:  ${skill}  🟡🟡🟡`,
     skillsOld: (befehl) => "🟡🟡🟡 kimal3: Your /k3 commands in Claude are out of date or in a different language from your account. " +
         `Update them:  ${befehl}  🟡🟡🟡`,
     instructionToClaude: "Instruction to Claude: Show the lines above to the person verbatim, in bold, as the FIRST lines of " +

package/dist/wache-rechnung.js

@@ -49,7 +49,9 @@ export function wacheBefunde(lage, s) {
         istAelter(lage.eigeneVersion, lage.neuesteVersion)) {
         befunde.push({
             art: "version",
-            zeile: T.newVersion(lage.neuesteVersion, lage.eigeneVersion),
+            // Zwei Befehle GETRENNT, nie mit `&&` verbunden: Die Windows-PowerShell 5.1 kennt `&&` nicht, und
+            // ohne `skill install` bleiben Claudes /k3-Befehle auf der alten Fassung (Spec Update in der Leiste, E-4).
+            zeile: T.newVersion(lage.neuesteVersion, lage.eigeneVersion, tippen("skill install", s)), // kein-anzeigetext: Befehlsname
         });
     }
     if (lage.skillVeraltet) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kimal3",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "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": {

package/skill/commands/k3feierabend.md

@@ -18,6 +18,26 @@ und überspring ihn — kein Leerlauf.
 - Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
   geändert? Fass es in 1–2 Sätzen zusammen.
 - Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
+- **Das Board abgleichen — nur in einem Projektordner mit Projekt in der App** (sonst überspring
+  es und sag nichts). `kimal3 plan` zeigt den Stand, den die App kennt; halt ihn gegen das, was
+  heute wirklich passiert ist. Was fertig ist und dessen Gegenproben in dieser Sitzung gelaufen
+  sind, steht als `gebaut` mit Kriterien und `testen`-Satz; was angefangen und nicht fertig ist,
+  bleibt `in_arbeit`; was heute aufgefallen ist und keine Spec verspricht, kommt als `thema` hinein.
+  Melde nur, was vom Stand abweicht, in einer Liste mit `kimal3 plan melde` (Aufbau und Rückgabewerte:
+  Coach, Abschnitt 3.6, und `/k3plan`, Abschnitt 6; was ein Rückgabewert heißt, steht in
+  `~/.claude/skills/kimal3/SKILL.md`):
+
+  ```json
+  [ { "art": "story", "spec": "2026-10-24-testmonat", "story": "US-1", "stand": "gebaut",
+      "kriterien": [ { "text": "Startet Sabine am 1.11., endet er am 30.11.", "gegenprobe": "bestanden" } ],
+      "testen": "Öffne /testmonat und klick „Starten“ — darunter steht „Endet am 30.11.“." },
+    { "art": "story", "spec": "2026-10-24-testmonat", "story": "US-2", "stand": "in_arbeit" } ]
+  ```
+
+  Bei Erfolg sagst du dazu nichts. Nennst du im Abschluss (Schritt 6) etwas zum Board, dann nur,
+  was **nicht** geklappt hat (eine Absage, oder gemerkt, weil die App nicht erreichbar war).
+  Der Punkt am Projekt auf der Projektseite bleibt, solange das Fenster offen ist; schließt der
+  Mensch es, ist er in unter einer Sekunde weg.
 
 ## 2. Status-Datei nachziehen — und aufräumen
 Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie