kimal3 0.6.0 → 0.6.1

package/dist/plan-datei.js

@@ -121,7 +121,7 @@ export function specKoepfeAus(json) {
 const rumpfBytes = (text) => Buffer.byteLength(JSON.stringify(text), "utf8");
 /**
  * Liest den Text jeder Spec. Jede Spec bekommt GENAU einen Eintrag: den Text oder den Grund, warum keiner da ist.
- * Passt der fertige Anfrage-Rumpf nicht in 4 MB, werden die groessten Texte zu `zu_gross`, bis er passt (US-16:
+ * Passt der fertige Anfrage-Rumpf nicht in 4 MB, werden die groessten Texte zu `zusammen_zu_gross`, bis er passt (US-16:
  * „am fertigen Anfrage-Rumpf"). `rumpf` baut genau den Rumpf, den `plan hoch` schickt (Stand, Schalter, Texte) --
  * dieselbe Funktion baut ihn dort auch, damit gemessen wird, was hinausgeht (Befund M-3).
  */
@@ -165,7 +165,7 @@ export function leseSpecTexte(ordner, specs, rumpf) {
         });
         if (groesster < 0)
             break;
-        eintraege[groesster] = { schluessel: specs[groesster].schluessel, grund: "zu_gross", pfad: specs[groesster].datei };
+        eintraege[groesster] = { schluessel: specs[groesster].schluessel, grund: "zusammen_zu_gross", pfad: specs[groesster].datei };
     }
     const ohne = eintraege.flatMap((e, i) => "grund" in e ? [{ titel: specs[i].titel, grund: keineTextdatei.has(i) ? "keine_textdatei" : e.grund, pfad: e.pfad }] : []);
     return { eintraege, ohne };

package/dist/texte/plan.js

@@ -38,7 +38,8 @@ const de = {
         : grund === "keine_datei" ? "keine Datei angegeben"
             : grund === "ausserhalb" ? "Pfad außerhalb des Projekts"
                 : grund === "keine_textdatei" ? "keine Textdatei"
-                    : "größer als 300 KB",
+                    : grund === "zusammen_zu_gross" ? "alle Spec-Texte zusammen größer als 4 MB"
+                        : "größer als 300 KB",
     specTexte: (angekommen, gesamt, ohne) => `Spec-Texte hochgeladen: ${angekommen} von ${gesamt}.${ohne.length === 0 ? "" : ` Ohne Text: ${ohne.join(", ")}.`}`,
     specTextOhneEintrag: (titel, grundText) => `„${titel}“ (${grundText})`,
     idNowInFile: "projekt_id und basis stehen jetzt in plan/stand.json.",
@@ -83,7 +84,8 @@ const en = {
         : grund === "keine_datei" ? "no file given"
             : grund === "ausserhalb" ? "path outside the project"
                 : grund === "keine_textdatei" ? "not a text file"
-                    : "larger than 300 KB",
+                    : grund === "zusammen_zu_gross" ? "all spec texts together larger than 4 MB"
+                        : "larger than 300 KB",
     specTexte: (angekommen, gesamt, ohne) => `Spec texts uploaded: ${angekommen} of ${gesamt}.${ohne.length === 0 ? "" : ` Without text: ${ohne.join(", ")}.`}`,
     specTextOhneEintrag: (titel, grundText) => `"${titel}" (${grundText})`,
     idNowInFile: "projekt_id and basis are now in plan/stand.json.",

package/package.json

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

package/skill/commands/k3kurs.md

@@ -1,41 +1,41 @@
----
-description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# Kurs
-
-> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
-> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
-> https://app.kimal3.de/kurs sieht.
-
-Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
-nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
-
-## 1. Den Stand holen
-- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
-- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
-  und nenn **keinen** Kursstand.
-- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
-  Gedächtnis**.
-- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
-
-## 2. Stand in einem Satz sagen
-- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
-
-## 3. Als Nächstes führen
-- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
-  verstehen. Nie die ganze Liste auf einmal.
-- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
-  beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
-  den Schritt unter https://app.kimal3.de/kurs abzuhaken.
-- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
-  `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
-  `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
-  keinen dritten Lauf vor.
-
-## 4. Abgeschlossen
-- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
-  möchte. Kein Kurs-Gerede mehr.
+---
+description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Kurs
+
+> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
+> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
+> https://app.kimal3.de/kurs sieht.
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
+nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
+
+## 1. Den Stand holen
+- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
+- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
+  und nenn **keinen** Kursstand.
+- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
+  Gedächtnis**.
+- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
+
+## 2. Stand in einem Satz sagen
+- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
+
+## 3. Als Nächstes führen
+- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
+  verstehen. Nie die ganze Liste auf einmal.
+- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
+  beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
+  den Schritt unter https://app.kimal3.de/kurs abzuhaken.
+- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
+  `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
+  `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
+  keinen dritten Lauf vor.
+
+## 4. Abgeschlossen
+- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
+  möchte. Kein Kurs-Gerede mehr.

package/skill/commands/k3plan.md

@@ -183,7 +183,8 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
 - **Regel 2 — Neues:** Was dir beim Prüfen auffällt oder der Mensch im Gespräch sagt und was
   **keine** Spec verspricht, kommt nach `themen`:
   `{ "schluessel": "T-1", "text": "…", "quelle": "claude" | "mensch", "seit": "<heute>" }`.
-  Die fünf Plätze teilen sich `themen` und die offenen Notizen aus der App.
+  Nimm die nächste freie Nummer, auch über `eingeordnet` hinweg (dort bleibt ein Schlüssel
+  14 Tage belegt). Die fünf Plätze teilen sich `themen` und die offenen Notizen aus der App.
 - **Regel 3 — einordnen:** Jedes `Thema` aus `kimal3 plan` **und** jedes Thema, das schon von
   früher in `themen` steht, ordnest du **jetzt** ein — eins von dreien:
   - **neue Story:** schreib sie in die Spec, zu der sie gehört (User Story, Akzeptanzkriterium mit
@@ -195,8 +196,11 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
 
   Für eine Notiz aus der App gehört die Antwort als **ein Satz** in `uebernommen` (die App zeigt
   sie unter „Zuletzt eingeordnet" als `<Notiz> → <Antwort>`); schreib sie darum **ohne** Pfeil
-  am Anfang. Ein Thema aus der Datei nimmst du aus `themen` heraus und nennst seine Einordnung im
-  Bericht.
+  am Anfang. Ein Thema aus der Datei nimmst du aus `themen` heraus und schreibst es mit seiner
+  Antwort nach `eingeordnet`: `{ "schluessel": "T-4", "text": "<Text wie in themen>", "antwort":
+  "<ein Satz>", "am": "<heute>" }` — die App zeigt es 14 Tage lang unter „Zuletzt eingeordnet".
+  Einträge, deren `am` mehr als 14 Tage zurückliegt, nimmst du dabei heraus. Nenn die Einordnung
+  auch im Bericht.
 - **Regel 4:** Weil du bei jedem `/k3plan` alles einordnest, liegt nichts lange. Ein Thema mit
   `seit` vor mehr als 14 Tagen ordnest du **auf jeden Fall** jetzt ein.
 - **Regel 5 und 6 — keine neue Spec beginnen**, solange eine andere Spec in Arbeit ist (eine ihrer
@@ -248,12 +252,15 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
   ],
   "uebernommen": [
     { "rueckmeldung": 12, "antwort": "Befund an US-2" }
+  ],
+  "eingeordnet": [
+    { "schluessel": "T-2", "text": "Export als PDF", "antwort": "gestrichen: Der Drucken-Knopf kann das schon.", "am": "2026-10-21" }
   ]
 }
 ```
 
-**Die Felder** — jedes muss da sein, auch wenn es `null` oder leer ist; ein unbekanntes Feld
-(ein Tippfehler wie `"befund"`) lehnt der Server ab:
+**Die Felder** — jedes muss da sein, auch wenn es `null` oder leer ist (nur `eingeordnet` darf
+fehlen); ein unbekanntes Feld (ein Tippfehler wie `"befund"`) lehnt der Server ab:
 
 - `format`: genau `1`.
 - `projekt`: der Name wie in der App, 1–200 Zeichen.
@@ -276,6 +283,9 @@ Die App zeigt sie dem Menschen in genau diesem Wortlaut („So bleibt die Planun
   Plätze, Regel 2).
 - `uebernommen[]`: `{ "rueckmeldung": <Nummer aus kimal3 plan>, "antwort": "<ein Satz>" }`. Leert
   `kimal3 plan hoch` nach dem Hochladen selbst.
+- `eingeordnet[]`: `{ "schluessel", "text", "antwort": "<ein Satz>", "am": "JJJJ-MM-TT" }`, höchstens
+  50 — Themen aus `themen`, die du eingeordnet hast (Regel 3). Ein Schlüssel steht nie zugleich in
+  `themen` und `eingeordnet`.
 - Die ganze Datei: höchstens 300 KB.
 
 ## 7. Hochladen
@@ -305,7 +315,8 @@ Sag dem Menschen, dass `plan/stand.json` geändert ist und in den nächsten Comm
 Danach steht eine Zeile `Spec-Texte hochgeladen: 1 von 3. Ohne Text: …` — der Text der Specs geht mit hoch.
 Eine Spec ohne Text ist ein **Hinweis, kein Fehlschlag** (Rückgabewert `0`): Nenn dem Menschen die
 Specs, die in der Klammer stehen, und was zu tun ist (Pfad in `datei` berichtigen; über 300 KB
-lässt sich nicht hochladen).
+lässt sich nicht hochladen; bei „alle Spec-Texte zusammen größer als 4 MB" ist keine Datei allein
+zu groß — die größten bleiben draußen, bis der Rest passt).
 
 **Absagen — die Meldung lesen, beheben, Probelauf, noch einmal:**
 

package/skill/en/commands/k3course.md

@@ -1,41 +1,41 @@
----
-description: Back into the Mini course — pick up where you left off
----
-
-<!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
-     overwritten on every update. Your own changes will be lost; if you want
-     to keep them, copy the file under a different name. -->
-# Course
-
-> Back into the Mini course: “Where was I again?” — picks up where you left off.
-> `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
-> https://app.kimal3.de/kurs.
-
-Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
-time, the why before the how, no prior knowledge assumed.
-
-## 1. Fetch the status
-- Run `kimal3 course` (on Windows the way `SKILL.md` describes).
-- Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
-  and name **no** course status.
-- Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
-  memory**.
-- If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
-
-## 2. Say where you stand in one sentence
-- Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
-
-## 3. Lead on with what comes next
-- The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
-  Never the whole list at once.
-- If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
-  Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
-  ask them to tick it off at https://app.kimal3.de/kurs.
-- If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
-  `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
-  `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
-  a third run.
-
-## 4. Finished
-- If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
-  work on here. No more course talk.
+---
+description: Back into the Mini course — pick up where you left off
+---
+
+<!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
+     overwritten on every update. Your own changes will be lost; if you want
+     to keep them, copy the file under a different name. -->
+# Course
+
+> Back into the Mini course: “Where was I again?” — picks up where you left off.
+> `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
+> https://app.kimal3.de/kurs.
+
+Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
+time, the why before the how, no prior knowledge assumed.
+
+## 1. Fetch the status
+- Run `kimal3 course` (on Windows the way `SKILL.md` describes).
+- Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
+  and name **no** course status.
+- Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
+  memory**.
+- If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
+
+## 2. Say where you stand in one sentence
+- Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
+
+## 3. Lead on with what comes next
+- The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
+  Never the whole list at once.
+- If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
+  Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
+  ask them to tick it off at https://app.kimal3.de/kurs.
+- If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
+  `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
+  `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
+  a third run.
+
+## 4. Finished
+- If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
+  work on here. No more course talk.

package/skill/en/commands/k3plan.md

@@ -181,6 +181,7 @@ The app shows them to the person in exactly this wording ("How planning stays sh
 - **Rule 2 — something new:** what you notice while checking, or what the person says in the
   conversation, and what **no** spec promises goes into `themen`:
   `{ "schluessel": "T-1", "text": "…", "quelle": "claude" | "mensch", "seit": "<today>" }`.
+  Take the next free number, counting `eingeordnet` too (a key stays taken there for 14 days).
   The five places are shared by `themen` and the open notes from the app.
 - **Rule 3 — sort:** every `Topic` from `kimal3 plan` **and** every topic already in `themen` from
   earlier is sorted **now** — one of three:
@@ -193,8 +194,11 @@ The app shows them to the person in exactly this wording ("How planning stays sh
 
   For a note from the app, the answer goes into `uebernommen` as **one sentence** (the app shows
   it under "Recently sorted" as `<note> → <answer>`); so write it **without** an arrow at the
-  start. A topic from the file you take out of `themen` and name how it was sorted in the
-  report.
+  start. A topic from the file you take out of `themen` and write it with its answer into
+  `eingeordnet`: `{ "schluessel": "T-4", "text": "<text as in themen>", "antwort": "<one
+  sentence>", "am": "<today>" }` — the app shows it under "Recently sorted" for 14 days. Entries
+  whose `am` is more than 14 days ago you take out at the same time. Name how it was sorted in the
+  report too.
 - **Rule 4:** because you sort everything at every `/k3plan`, nothing stays long. A topic with
   `seit` more than 14 days ago is sorted now **in any case**.
 - **Rules 5 and 6 — don't start a new spec** while another spec is in progress (one of its
@@ -245,12 +249,15 @@ The app shows them to the person in exactly this wording ("How planning stays sh
   ],
   "uebernommen": [
     { "rueckmeldung": 12, "antwort": "Finding on US-2" }
+  ],
+  "eingeordnet": [
+    { "schluessel": "T-2", "text": "Export as PDF", "antwort": "dropped: the print button already does that.", "am": "2026-10-21" }
   ]
 }
 ```
 
-**The fields** — every one must be there, even if it is `null` or empty; the server refuses an
-unknown field (a typo like `"befund"`):
+**The fields** — every one must be there, even if it is `null` or empty (only `eingeordnet` may
+be missing); the server refuses an unknown field (a typo like `"befund"`):
 
 - `format`: exactly `1`.
 - `projekt`: the name as in the app, 1–200 characters.
@@ -273,6 +280,9 @@ unknown field (a typo like `"befund"`):
   rule 2).
 - `uebernommen[]`: `{ "rueckmeldung": <number from kimal3 plan>, "antwort": "<one sentence>" }`.
   `kimal3 plan upload` empties it itself after uploading.
+- `eingeordnet[]`: `{ "schluessel", "text", "antwort": "<one sentence>", "am": "YYYY-MM-DD" }`, at
+  most 50 — topics from `themen` that you have sorted (rule 3). A key is never in `themen` and
+  `eingeordnet` at the same time.
 - The whole file: at most 300 KB.
 
 ## 7. Upload
@@ -300,7 +310,9 @@ person that `plan/stand.json` has changed and belongs in the next commit.
 
 After that comes a line `Spec texts uploaded: 1 of 3. Without text: …` — the text of the specs goes up too.
 A spec without text is a **hint, not a failure** (exit code `0`): tell the person which specs are in
-the brackets and what to do (correct the path in `datei`; over 300 KB cannot be uploaded).
+the brackets and what to do (correct the path in `datei`; over 300 KB cannot be uploaded; with
+"all spec texts together larger than 4 MB" no single file is too large — the largest stay out
+until the rest fits).
 
 **Refusals — read the message, fix it, dry run, again:**