Clean up project and fix various issues

mafulafunk · claude · mafulafunk · commit 3d5eeceee5b4 · 2026-01-11T13:47:18.000+01:00
- Replace template README with project-specific German version
- Fix package.json author (Yuki Hattori -&gt; Martin Funk)
- Fix typo in CheatSheet.md (Selection -&gt; Selektion)
- Add shell example to Umbenennung slide
- Use portable shebang (#!/usr/bin/env bash) in shell scripts
- Add error handling (set -euo pipefail) to shell scripts

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.beads/.gitignore b/.beads/.gitignore
@@ -0,0 +1,44 @@
+# SQLite databases
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Daemon runtime files
+daemon.lock
+daemon.log
+daemon.pid
+bd.sock
+sync-state.json
+last-touched
+
+# Local version tracking (prevents upgrade notification spam after git ops)
+.local_version
+
+# Legacy database files
+db.sqlite
+bd.db
+
+# Worktree redirect file (contains relative path to main repo's .beads/)
+# Must not be committed as paths would be wrong in other clones
+redirect
+
+# Merge artifacts (temporary files from 3-way merge)
+beads.base.jsonl
+beads.base.meta.json
+beads.left.jsonl
+beads.left.meta.json
+beads.right.jsonl
+beads.right.meta.json
+
+# Sync state (local-only, per-machine)
+# These files are machine-specific and should not be shared across clones
+.sync.lock
+sync_base.jsonl
+
+# NOTE: Do NOT add negation patterns (e.g., !issues.jsonl) here.
+# They would override fork protection in .git/info/exclude, allowing
+# contributors to accidentally commit upstream issue databases.
+# The JSONL files (issues.jsonl, interactions.jsonl) and config files
+# are tracked by git by default since no pattern above ignores them.
diff --git a/.beads/README.md b/.beads/README.md
@@ -0,0 +1,81 @@
+# Beads - AI-Native Issue Tracking
+
+Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
+
+## What is Beads?
+
+Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
+
+**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+
+## Quick Start
+
+### Essential Commands
+
+```bash
+# Create new issues
+bd create "Add user authentication"
+
+# View all issues
+bd list
+
+# View issue details
+bd show <issue-id>
+
+# Update issue status
+bd update <issue-id> --status in_progress
+bd update <issue-id> --status done
+
+# Sync with git remote
+bd sync
+```
+
+### Working with Issues
+
+Issues in Beads are:
+- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
+- **AI-friendly**: CLI-first design works perfectly with AI coding agents
+- **Branch-aware**: Issues can follow your branch workflow
+- **Always in sync**: Auto-syncs with your commits
+
+## Why Beads?
+
+✨ **AI-Native Design**
+- Built specifically for AI-assisted development workflows
+- CLI-first interface works seamlessly with AI coding agents
+- No context switching to web UIs
+
+🚀 **Developer Focused**
+- Issues live in your repo, right next to your code
+- Works offline, syncs when you push
+- Fast, lightweight, and stays out of your way
+
+🔧 **Git Integration**
+- Automatic sync with git commits
+- Branch-aware issue tracking
+- Intelligent JSONL merge resolution
+
+## Get Started with Beads
+
+Try Beads in your own projects:
+
+```bash
+# Install Beads
+curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your repo
+bd init
+
+# Create your first issue
+bd create "Try out Beads"
+```
+
+## Learn More
+
+- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
+- **Quick Start Guide**: Run `bd quickstart`
+- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
+
+---
+
+*Beads: Issue tracking that moves at the speed of thought* ⚡
diff --git a/.beads/config.yaml b/.beads/config.yaml
@@ -0,0 +1,62 @@
+# Beads Configuration File
+# This file configures default behavior for all bd commands in this repository
+# All settings can also be set via environment variables (BD_* prefix)
+# or overridden with command-line flags
+
+# Issue prefix for this repository (used by bd init)
+# If not set, bd init will auto-detect from directory name
+# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
+# issue-prefix: ""
+
+# Use no-db mode: load from JSONL, no SQLite, write back after each command
+# When true, bd will use .beads/issues.jsonl as the source of truth
+# instead of SQLite database
+# no-db: false
+
+# Disable daemon for RPC communication (forces direct database access)
+# no-daemon: false
+
+# Disable auto-flush of database to JSONL after mutations
+# no-auto-flush: false
+
+# Disable auto-import from JSONL when it's newer than database
+# no-auto-import: false
+
+# Enable JSON output by default
+# json: false
+
+# Default actor for audit trails (overridden by BD_ACTOR or --actor)
+# actor: ""
+
+# Path to database (overridden by BEADS_DB or --db)
+# db: ""
+
+# Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
+# auto-start-daemon: true
+
+# Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
+# flush-debounce: "5s"
+
+# Git branch for beads commits (bd sync will commit to this branch)
+# IMPORTANT: Set this for team projects so all clones use the same sync branch.
+# This setting persists across clones (unlike database config which is gitignored).
+# Can also use BEADS_SYNC_BRANCH env var for local override.
+# If not set, bd sync will require you to run 'bd config set sync.branch <branch>'.
+# sync-branch: "beads-sync"
+
+# Multi-repo configuration (experimental - bd-307)
+# Allows hydrating from multiple repositories and routing writes to the correct JSONL
+# repos:
+#   primary: "."  # Primary repo (where this database lives)
+#   additional:   # Additional repos to hydrate from (read-only)
+#     - ~/beads-planning  # Personal planning repo
+#     - ~/work-planning   # Work planning repo
+
+# Integration settings (access with 'bd config get/set')
+# These are stored in the database, not in this file:
+# - jira.url
+# - jira.project
+# - linear.url
+# - linear.api-key
+# - github.org
+# - github.repo
diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl
@@ -1,12 +1,12 @@
 {"id":"sql-in-the-shell-1dc","title":"Add missing .puppeteer.js file","description":"GitHub Action referenziert .puppeteer.js (Zeile 35), aber die Datei existiert nicht im Repo","status":"closed","priority":2,"issue_type":"bug","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:02.038285+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:44:37.545813+01:00","closed_at":"2026-01-11T13:44:37.545813+01:00","close_reason":"Not needed anymore - Marp CLI 4.x has built-in browser support"}
 {"id":"sql-in-the-shell-518","title":"Modernize GitHub Actions workflow","description":"Node 12 und veraltete Actions (checkout@v1, setup-node@v1) auf aktuelle Versionen updaten","status":"closed","priority":1,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:43.341427+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:44:37.429751+01:00","closed_at":"2026-01-11T13:44:37.429751+01:00","close_reason":"Updated to Node 20, actions v4, removed Puppeteer dependency"}
-{"id":"sql-in-the-shell-68a","title":"Add package-lock.json to repository","description":"package-lock.json sollte eingecheckt werden fuer reproduzierbare Builds","status":"open","priority":3,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:02.147685+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:38:02.147685+01:00"}
-{"id":"sql-in-the-shell-71n","title":"Use portable shebang in shell scripts","description":"cartesian.sh und crt.sh: #!/bin/bash -\u003e #!/usr/bin/env bash fuer bessere Portabilitaet","status":"open","priority":4,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:01.811854+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:38:01.811854+01:00"}
-{"id":"sql-in-the-shell-9h6","title":"Add error handling to cartesian.sh","description":"Fehlerbehandlung hinzufuegen: set -e, Pruefung ob Dateien existieren","status":"open","priority":3,"issue_type":"feature","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:01.92679+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:38:01.92679+01:00"}
-{"id":"sql-in-the-shell-b7e","title":"Fix package.json author metadata","description":"Author ist noch 'Yuki Hattori' vom Original-Template, sollte auf Martin Funk geaendert werden","status":"open","priority":3,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:43.226369+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:37:43.226369+01:00"}
-{"id":"sql-in-the-shell-c02","title":"Fix typo: Selection -\u003e Selektion in CheatSheet.md","description":"Zeile 24: 'Selection' sollte 'Selektion' heissen (Konsistenz zur Praesentation)","status":"open","priority":4,"issue_type":"bug","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.426674+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:37:52.426674+01:00"}
-{"id":"sql-in-the-shell-ez8","title":"Update ZEIT Now references to Vercel","description":"ZEIT Now heisst jetzt Vercel - README und Deployment-Optionen aktualisieren","status":"open","priority":4,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:02.261645+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:38:02.261645+01:00"}
-{"id":"sql-in-the-shell-gx2","title":"Add shell command example to Umbenennung slide","description":"PITCHME.md:113-118 - Die Slide 'Umbenennung' hat keinen Shell-Befehl-Vergleich wie die anderen Slides","status":"open","priority":3,"issue_type":"feature","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.550599+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:37:52.550599+01:00"}
-{"id":"sql-in-the-shell-lwa","title":"Replace template README with project-specific content","description":"README.md ist komplett vom marp-cli-example Template, sollte eigenen Inhalt haben","status":"open","priority":2,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.292815+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:37:52.292815+01:00"}
-{"id":"sql-in-the-shell-mfu","title":"Verify Matt Might inspiration link","description":"PITCHME.md:173 - Link http://matt.might.net/articles/sql-in-the-shell/ pruefen ob noch erreichbar","status":"open","priority":4,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.666943+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:37:52.666943+01:00"}
+{"id":"sql-in-the-shell-68a","title":"Add package-lock.json to repository","description":"package-lock.json sollte eingecheckt werden fuer reproduzierbare Builds","status":"closed","priority":3,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:02.147685+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:45:20.54646+01:00","closed_at":"2026-01-11T13:45:20.54646+01:00","close_reason":"Committed with dependency update"}
+{"id":"sql-in-the-shell-71n","title":"Use portable shebang in shell scripts","description":"cartesian.sh und crt.sh: #!/bin/bash -\u003e #!/usr/bin/env bash fuer bessere Portabilitaet","status":"closed","priority":4,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:01.811854+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.28892+01:00","closed_at":"2026-01-11T13:47:02.28892+01:00","close_reason":"Changed to #!/usr/bin/env bash with set -euo pipefail"}
+{"id":"sql-in-the-shell-9h6","title":"Add error handling to cartesian.sh","description":"Fehlerbehandlung hinzufuegen: set -e, Pruefung ob Dateien existieren","status":"closed","priority":3,"issue_type":"feature","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:01.92679+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.414688+01:00","closed_at":"2026-01-11T13:47:02.414688+01:00","close_reason":"Added set -euo pipefail"}
+{"id":"sql-in-the-shell-b7e","title":"Fix package.json author metadata","description":"Author ist noch 'Yuki Hattori' vom Original-Template, sollte auf Martin Funk geaendert werden","status":"closed","priority":3,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:43.226369+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.044978+01:00","closed_at":"2026-01-11T13:47:02.044978+01:00","close_reason":"Changed to Martin Funk"}
+{"id":"sql-in-the-shell-c02","title":"Fix typo: Selection -\u003e Selektion in CheatSheet.md","description":"Zeile 24: 'Selection' sollte 'Selektion' heissen (Konsistenz zur Praesentation)","status":"closed","priority":4,"issue_type":"bug","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.426674+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.167577+01:00","closed_at":"2026-01-11T13:47:02.167577+01:00","close_reason":"Fixed: Selection -\u003e Selektion"}
+{"id":"sql-in-the-shell-ez8","title":"Update ZEIT Now references to Vercel","description":"ZEIT Now heisst jetzt Vercel - README und Deployment-Optionen aktualisieren","status":"closed","priority":4,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:38:02.261645+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.790558+01:00","closed_at":"2026-01-11T13:47:02.790558+01:00","close_reason":"Not needed - removed template README with ZEIT Now references"}
+{"id":"sql-in-the-shell-gx2","title":"Add shell command example to Umbenennung slide","description":"PITCHME.md:113-118 - Die Slide 'Umbenennung' hat keinen Shell-Befehl-Vergleich wie die anderen Slides","status":"closed","priority":3,"issue_type":"feature","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.550599+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.536597+01:00","closed_at":"2026-01-11T13:47:02.536597+01:00","close_reason":"Added awk example"}
+{"id":"sql-in-the-shell-lwa","title":"Replace template README with project-specific content","description":"README.md ist komplett vom marp-cli-example Template, sollte eigenen Inhalt haben","status":"closed","priority":2,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.292815+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:01.917969+01:00","closed_at":"2026-01-11T13:47:01.917969+01:00","close_reason":"Replaced with project-specific German README"}
+{"id":"sql-in-the-shell-mfu","title":"Verify Matt Might inspiration link","description":"PITCHME.md:173 - Link http://matt.might.net/articles/sql-in-the-shell/ pruefen ob noch erreichbar","status":"closed","priority":4,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:52.666943+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:47:02.658486+01:00","closed_at":"2026-01-11T13:47:02.658486+01:00","close_reason":"Link works fine"}
 {"id":"sql-in-the-shell-vc2","title":"Update Marp CLI from ^0.17.0 to latest","description":"Die aktuelle Version ist ~4.x, das Projekt nutzt eine sehr alte Version","status":"closed","priority":1,"issue_type":"chore","owner":"Martin@MartinFunk.de","created_at":"2026-01-11T13:37:43.10327+01:00","created_by":"Martin Funk","updated_at":"2026-01-11T13:43:23.961855+01:00","closed_at":"2026-01-11T13:43:23.961855+01:00","close_reason":"Updated to ^4.2.3"}
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,3 @@
+
+# Use bd merge for beads JSONL files
+.beads/issues.jsonl merge=beads
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,40 @@
+# Agent Instructions
+
+This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.
+
+## Quick Reference
+
+```bash
+bd ready              # Find available work
+bd show <id>          # View issue details
+bd update <id> --status in_progress  # Claim work
+bd close <id>         # Complete work
+bd sync               # Sync with git
+```
+
+## Landing the Plane (Session Completion)
+
+**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
+
+**MANDATORY WORKFLOW:**
+
+1. **File issues for remaining work** - Create issues for anything that needs follow-up
+2. **Run quality gates** (if code changed) - Tests, linters, builds
+3. **Update issue status** - Close finished work, update in-progress items
+4. **PUSH TO REMOTE** - This is MANDATORY:
+   ```bash
+   git pull --rebase
+   bd sync
+   git push
+   git status  # MUST show "up to date with origin"
+   ```
+5. **Clean up** - Clear stashes, prune remote branches
+6. **Verify** - All changes committed AND pushed
+7. **Hand off** - Provide context for next session
+
+**CRITICAL RULES:**
+- Work is NOT complete until `git push` succeeds
+- NEVER stop before pushing - that leaves work stranded locally
+- NEVER say "ready to push when you are" - YOU must push
+- If push fails, resolve and retry until it succeeds
+
diff --git a/CheatSheet.md b/CheatSheet.md
@@ -21,7 +21,7 @@ marp: true
 - Bonus: Sortierung
   - `awk -F ',' 'OFS="," {print $2, $1, $3}' Customer_A.csv | sort --field-separator=',' --key=2`
 
-## Selection
+## Selektion
 
 - `SELECT * FROM Customers WHERE Country LIKE '%ada%';`
   - `cat Customer_A.csv | grep ada`
diff --git a/PITCHME.md b/PITCHME.md
@@ -116,6 +116,8 @@ Relationenalgebra auf der Kommandozeile
 > \rho_{[\mathrm{neu}\leftarrow\mathrm{alt}]}(R):= \{t'|t'(R-\mathrm{alt})=t(R-\mathrm{alt}) \land t'(\mathrm{neu})=t(\mathrm{alt})\}
 > $$
 
+- `awk -F ',' '{print $2, $1}' R`
+
 ---
 
 ![bg](#148)
diff --git a/README.md b/README.md
diff --git a/package.json b/package.json
diff --git a/work/bin/cartesian.sh b/work/bin/cartesian.sh
diff --git a/work/bin/crt.sh b/work/bin/crt.sh

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+`
	`2`	`+# Use bd merge for beads JSONL files`
	`3`	`+.beads/issues.jsonl merge=beads`