feat: prompt-listener 1.0.0 -- Fork-Master-Template (Auskapselung aus dem AI-LAB)

Nutzerentscheid 2026-08-16: eigenes Repo als versioniertes Master-Muster,
dessen Logik schnell forkbar ist. Forks divergieren bewusst und werden nur in
FORKS.md registriert (deklarierte Divergenz statt stiller Kopie); keine
Fork-Synchronisierung. Werkzeug-Kern (5-Stufen-Analyzer, AgentEvent-v2-Schema,
14 Tests); Forschungsdaten bleiben im Lab. Final Gate 10/10 (RELEASE_GATE.md).

Author: Lukas Geiger

.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.env
+*.db
+.idea/
+.vscode/
+data/
+# Forschungsdaten bleiben im Lab, nie im Template-Master
+_results/
+_sources/
+out/
+*.pyc

CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## [1.0.0] - 2026-08-16
+
+Erstveroeffentlichung als **Fork-Master-Template** (Nutzerentscheid 2026-08-16:
+eigenes Repo als versioniertes Master-Muster, dessen Logik schnell forkbar ist;
+Forks divergieren bewusst und werden nur in FORKS.md registriert).
+
+- Werkzeug-Kern ausgekapselt aus `.RESEARCH/.LAB/_AI-LAB/prompt-listener`
+  (Erstanwendung Regress-Melder 04/2026; Methodik: Prompt-Archaeology):
+  prompt_analyzer.py (5 Stufen), stage0_agent_event.py, schema/agent_event_v2
+  (+ JSON Schema), fixture_corpus, 14 Tests.
+- Forschungsdaten (_results/, _sources/) und Reife-Gates bleiben im Lab.
+- FORKS.md-Register mit den zwei bekannten Forks (TOM-lm corpus_extract,
+  AI-LAB-Arbeitskopie).
+- Veralteten llmauto-Pfad im Docstring durch neutrale Nachbar-Formulierung
+  ersetzt (llmauto lebt heute als Paket in MarbleRun).

FORKS.md

@@ -0,0 +1,18 @@
+# Fork-Register — wer stammt von diesem Master ab
+
+> Dieses Repo ist eine **Fork-Quelle** (versioniertes Master-Muster), keine
+> geteilte Abhängigkeit: Wer die Logik anders braucht, **forkt und divergiert
+> bewusst** — einzige Pflicht ist der Eintrag hier (Herkunfts-Deklaration).
+> Der Master wird gepflegt; Forks leben eigenständig weiter und werden vom
+> Master **nicht** nachgezogen.
+
+| # | Fork | Ort | Abgezweigt | Zweck-Divergenz |
+|---|---|---|---|---|
+| 1 | TOM-lm `corpus_extract.py` | `<privat> _control-center/_TOM-lm/_tool/` | vor 2026-06 (aus `prompt_analyzer.py`) | Nutzermodell-Bau statt Session-Klassifikation: Korpus-Modus, Multi-Source, Outcome-Link |
+| 2 | AI-LAB-Forschungsexemplar | `<privat> .RESEARCH/.LAB/_AI-LAB/prompt-listener/` | 2026-08-16 (Ursprungsort; Master wurde von dort ausgekapselt) | Forschungs-Arbeitskopie mit Korpora/Ergebnissen (`_results/`, `_sources/` — bleiben privat) |
+
+## Eintragsregel
+
+Neuer Fork = neue Zeile: Ort, Datum, ein Satz Zweck-Divergenz. Mehr nicht —
+kein Rückführungsversprechen, keine Sync-Pflicht. Ein Audit liest diese Tabelle
+als Legitimation der Doppelstruktur (deklarierte Divergenz statt stiller Kopie).

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lukas Geiger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,55 @@
+# prompt-listener
+
+> **A fork-master template, not a shared dependency.** A versioned master
+> pattern for analysing human–AI interactions: fork it, diverge deliberately,
+> register your fork — the master stays clean, your fork lives its own life.
+
+[Deutsche Fassung](README_de.md)
+
+## What it is
+
+Two building blocks for prompt/session research, stdlib-only at the core:
+
+1. **`prompt_analyzer.py`** — a 5-stage pipeline over agent session logs
+   (JSONL): raw extraction → topic filter → LLM classification
+   (type/topic/purpose/intent/method) → per-unit aggregation → statistics.
+   Stages 0–1 run with no dependencies (`--dry-run`); stages 2–4 use an LLM
+   runner as an **optional neighbour** (detected, never assumed).
+2. **`schema/agent_event_v2.py`** — an 850-line, stdlib-only provenance schema
+   (AgentEvent core + 18 sub-ledgers: source, authority, trust boundary,
+   tool/MCP context, memory influence, planned vs. executed action, gate
+   decision, review status) plus JSON Schema and tests. Useful on its own
+   wherever "who caused what on which authority" must be recorded.
+
+## The template model
+
+This repo answers a real governance question: *what if a consumer needs the
+logic differently?* Then a shared import is the wrong tool — **fork the master
+instead**:
+
+- The **master** is versioned, tested and kept tidy.
+- A **fork** diverges freely and is *not* chased by master updates.
+- The only duty: one line in [`FORKS.md`](FORKS.md) (where, when, why the
+  purpose diverged). An audit reads that as *declared divergence* instead of a
+  silent copy.
+
+Import when the purpose stays the same; fork when it diverges.
+
+## Quick start
+
+```bash
+python prompt_analyzer.py session.jsonl --dry-run          # stages 0–1, no deps
+python prompt_analyzer.py session.jsonl --dry-run --agent-events-output out/events.jsonl
+python -m pytest -q                                        # 14 tests
+```
+
+## Provenance
+
+Extracted 2026-08-16 from the AI-LAB research project (which keeps the corpora
+and results privately and continues as the research working copy — fork #2 in
+the register). First registered fork: TOM-lm's `corpus_extract.py`
+(user-model building). Method paper: "Prompt-Archaeology" (research line).
+
+## License
+
+MIT.

README_de.md

@@ -0,0 +1,56 @@
+# prompt-listener
+
+> **Ein Fork-Master-Template, keine geteilte Abhängigkeit.** Ein versioniertes
+> Master-Muster zur Analyse von Mensch-KI-Interaktionen: forke es, divergiere
+> bewusst, registriere deinen Fork — der Master bleibt sauber, dein Fork lebt
+> sein eigenes Leben.
+
+[English version](README.md)
+
+## Was es ist
+
+Zwei Bausteine für Prompt-/Session-Forschung, im Kern stdlib-only:
+
+1. **`prompt_analyzer.py`** — 5-Stufen-Pipeline über Agent-Session-Logs
+   (JSONL): Roh-Extraktion → Themenfilter → LLM-Klassifikation
+   (Typ/Thema/Zweck/Absicht/Methode) → Aggregation je Einheit → Statistik.
+   Stufe 0–1 läuft ohne Abhängigkeiten (`--dry-run`); Stufe 2–4 nutzt einen
+   LLM-Runner als **optionalen Nachbarn** (erkannt, nie vorausgesetzt).
+2. **`schema/agent_event_v2.py`** — 850 Zeilen stdlib-only Provenienz-Schema
+   (AgentEvent-Kern + 18 Sub-Ledger: Quelle, Autorität, Trust-Boundary,
+   Tool-/MCP-Kontext, Memory-Einfluss, geplante vs. ausgeführte Aktion,
+   Gate-Entscheidung, Review-Status) plus JSON-Schema und Tests. Eigenständig
+   nützlich, wo „wer hat was auf welcher Autorität ausgelöst" festzuhalten ist.
+
+## Das Template-Modell
+
+Dieses Repo beantwortet eine echte Governance-Frage: *Was, wenn ein Konsument
+die Logik ganz anders braucht?* Dann ist ein geteilter Import das falsche
+Werkzeug — **stattdessen den Master forken**:
+
+- Der **Master** ist versioniert, getestet und wird gepflegt.
+- Ein **Fork** divergiert frei und wird vom Master *nicht* nachgezogen.
+- Einzige Pflicht: eine Zeile in [`FORKS.md`](FORKS.md) (wo, wann, warum der
+  Zweck divergiert). Ein Audit liest das als *deklarierte Divergenz* statt
+  stiller Kopie.
+
+Importieren, solange der Zweck gleich bleibt; forken, wenn er divergiert.
+
+## Schnellstart
+
+```bash
+python prompt_analyzer.py session.jsonl --dry-run          # Stufe 0–1, ohne Abhängigkeiten
+python prompt_analyzer.py session.jsonl --dry-run --agent-events-output out/events.jsonl
+python -m pytest -q                                        # 14 Tests
+```
+
+## Provenienz
+
+Ausgekapselt 2026-08-16 aus dem AI-LAB-Forschungsprojekt (das Korpora und
+Ergebnisse privat behält und als Forschungs-Arbeitskopie weiterlebt — Fork #2
+im Register). Erster registrierter Fork: TOM-lms `corpus_extract.py`
+(Nutzermodell-Bau). Methoden-Paper: „Prompt-Archaeology" (research line).
+
+## Lizenz
+
+MIT.

RELEASE_GATE.md

@@ -0,0 +1,35 @@
+# Release Gate: prompt-listener
+
+## Status
+
+```
++------------------------------------------+
+|                                          |
+|          STATUS: UNLOCKED                |
+|                                          |
++------------------------------------------+
+```
+
+> **LOCKED** = Repository must remain private.
+> **UNLOCKED** = Repository may be set to public.
+
+---
+
+## Gate run 2026-08-16
+
+`final_gate_check.py --repo-path .` → **10 PASS, 0 FAIL, 0 WARN — exit 0**
+(process `MODULES/RELEASE_PROCESS.md` v1.0)
+
+## Notes
+
+- **Cut of the extraction:** tool core only (analyzer, stage0, schema, tests,
+  fixture corpus). Research data (`_results/`, `_sources/`) and the lab's
+  maturity-gate artefacts stay in the AI-LAB project (gitignored here); the
+  lab-specific gate test was removed from this repo's suite.
+- Stale personal path in the analyzer docstring (old llmauto location)
+  replaced by a neutral optional-neighbour note.
+- Role: **fork-master template** — forks diverge freely, sole duty is a
+  FORKS.md entry (declared divergence). No fork synchronisation by design.
+- Test suite: 14 passed (synthetic fixtures only, no network, no API key for
+  stages 0–1).
+- Reviewed by: Claude Code (fable-5), 2026-08-16

TODO.md

@@ -0,0 +1,25 @@
+# TODO — prompt-listener (Fork-Master)
+
+## STATUS
+
+| Category | Status |
+|---|---|
+| Tests | 14 passed (Werkzeug-Kern; Forschungs-Gate-Tests bleiben im Lab) |
+| Sprachstufe (P-006) | Core: README DE+EN; Code/CLI englischsprachige Struktur, deutsche Pipeline-Ausgaben (Forschungssprache — bewusst) |
+| Rolle | Fork-Master-Template: Forks divergieren frei, Pflicht ist nur der FORKS.md-Eintrag |
+| Bewusste Entscheidung | Keine Rückkonsolidierung von Forks (User 2026-08-16); Forschungsdaten bleiben im Lab |
+
+Stand: 2026-08-16 · Version 1.0.0
+
+## Offen
+
+- [ ] compare-race-Export-Adapter (Race-Artefakte → Stufe-0-JSONL) — Eintrag
+      liegt im compare-race-TODO; bei Bau hier als Konsument oder Fork führen.
+- [ ] Stufe-2-Runner-Probe formalisieren (marblerun/llmauto per enabled_probe
+      statt PYTHONPATH-Konvention).
+
+## Bewusst nicht gebaut
+
+- **Fork-Synchronisierung** — Forks leben eigenständig (Template-Modell).
+- **Forschungs-Reife-Gates** (evidence_gate) — Projektsteuerung des Labs,
+  nicht Werkzeug-Substanz.

ellmos-module.v2.json

@@ -0,0 +1,22 @@
+{
+  "schema": "ellmos.module.v2",
+  "id": "prompt-listener",
+  "display_name": "prompt-listener",
+  "category": "quality",
+  "kind": "template",
+  "status": "active",
+  "visibility": "public",
+  "provides": ["quality.prompt-analysis", "quality.agent-event-provenance"],
+  "requires": [],
+  "optional": ["automation.default"],
+  "conflicts": [],
+  "surfaces": ["library", "cli", "template"],
+  "state": { "ownership": "external", "location": "project" },
+  "boundaries": {
+    "network": "none",
+    "data": "user-local",
+    "platforms": ["windows", "macos", "linux"]
+  },
+  "source_of_truth": { "type": "local-directory", "path": "." },
+  "adapters": []
+}