diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index 5008ddf..0000000
Binary files a/.DS_Store and /dev/null differ
diff --git a/.github/workflows/demon.yml b/.github/workflows/demon.yml
new file mode 100644
index 0000000..21e853b
--- /dev/null
+++ b/.github/workflows/demon.yml
@@ -0,0 +1,62 @@
+name: Maxwell's Demon
+
+on:
+ issues:
+ types: [opened]
+
+concurrency:
+ group: demon-state
+ cancel-in-progress: false
+
+permissions:
+ contents: write
+ issues: write
+
+jobs:
+ sort:
+ if: "startsWith(github.event.issue.title, 'demon: sort 12 bits')"
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Sort 12 bits into the lattice
+ run: |
+ python3 - <<'EOF'
+ import datetime
+ import json
+
+ path = "state/demon.json"
+ with open(path) as fh:
+ state = json.load(fh)
+ state["bits_sorted"] += 12
+ state["generation"] += 1
+ state["demons"] += 1
+ state["last_sorted_at"] = datetime.datetime.now(
+ datetime.timezone.utc
+ ).isoformat(timespec="seconds")
+ with open(path, "w") as fh:
+ json.dump(state, fh, indent=2)
+ fh.write("\n")
+ EOF
+ python3 engine/generate_entropy_svg.py
+
+ - name: Commit lowered entropy
+ env:
+ AUTHOR: ${{ github.event.issue.user.login }}
+ run: |
+ git config user.name "github-actions[bot]"
+ git config user.email "41898470+github-actions[bot]@users.noreply.github.com"
+ git add state/demon.json assets/entropy.svg
+ git commit -m "chore: demon sorted 12 bits (S lowered by @${AUTHOR})"
+ git pull --rebase origin "${GITHUB_REF_NAME}"
+ git push
+
+ - name: Thank the demon and close the gate
+ env:
+ GH_TOKEN: ${{ github.token }}
+ ISSUE: ${{ github.event.issue.number }}
+ run: |
+ gh issue comment "$ISSUE" --repo "$GITHUB_REPOSITORY" --body \
+ "12 bits sorted. Entropy of this README decreased by 34.4 zJ (12 × kT ln 2 at 300 K). The second law remains statistical. Thank you, demon."
+ gh issue edit "$ISSUE" --repo "$GITHUB_REPOSITORY" --add-label demon
+ gh issue close "$ISSUE" --repo "$GITHUB_REPOSITORY"
diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
new file mode 100644
index 0000000..21cb5f0
--- /dev/null
+++ b/.github/workflows/nightly.yml
@@ -0,0 +1,37 @@
+name: Nightly Telemetry
+
+on:
+ schedule:
+ - cron: "17 6 * * *"
+ workflow_dispatch:
+
+concurrency:
+ group: demon-state
+ cancel-in-progress: false
+
+permissions:
+ contents: write
+
+jobs:
+ refresh:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Refresh feed, stats, featured cards, entropy field
+ env:
+ GITHUB_TOKEN: ${{ github.token }}
+ run: python3 engine/nightly.py
+
+ - name: Commit if changed
+ run: |
+ if git diff --quiet; then
+ echo "no changes"
+ exit 0
+ fi
+ git config user.name "github-actions[bot]"
+ git config user.email "41898470+github-actions[bot]@users.noreply.github.com"
+ git add README.md state/demon.json assets/entropy.svg
+ git commit -m "chore: nightly telemetry refresh"
+ git pull --rebase origin "${GITHUB_REF_NAME}"
+ git push
diff --git a/.github/workflows/snake.yml b/.github/workflows/snake.yml
index 81849ab..988375b 100644
--- a/.github/workflows/snake.yml
+++ b/.github/workflows/snake.yml
@@ -4,19 +4,15 @@ on:
schedule:
# Runs every 12 hours
- cron: "0 */12 * * *"
-
+
workflow_dispatch:
-
- push:
- branches:
- - main
jobs:
generate:
runs-on: ubuntu-latest
permissions:
contents: write
-
+
steps:
- name: Generate Snake
uses: Platane/snk/svg-only@v3
@@ -25,11 +21,11 @@ jobs:
outputs: |
dist/github-contribution-grid-snake.svg
dist/github-contribution-grid-snake-dark.svg?palette=github-dark
-
+
- name: Push to output branch
uses: crazy-max/ghaction-github-pages@v4
with:
target_branch: output
build_dir: dist
env:
- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
\ No newline at end of file
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e43b0f9
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.DS_Store
diff --git a/CLAUDE.md b/CLAUDE.md
index 45c2fb1..9b4b58f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,23 +4,33 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## Repository Overview
-This is a GitHub profile repository containing only a README.md file that displays on the @developtheweb GitHub profile page. There is no source code, build configuration, or tests in this repository.
+This is the GitHub profile repository for @developtheweb. Its README renders on the profile page and is a live system, not a static page: an animated entropy-reversal SVG whose state is lowered by visitors ("Maxwell's demon"), plus nightly-refreshed telemetry. Do not reintroduce third-party rendering services (capsule-render, readme-typing-svg, komarev, vercel stats/quotes apps) — everything renders from this repo, GitHub, or stevenmilanese.com assets.
-## Repository Structure
+## Architecture
```
-/home/aurelius/git/developtheweb/
-└── README.md
+README.md profile page; contains marker-fenced generated sections
+engine/generate_entropy_svg.py SMIL-animated assets/entropy.svg from state/demon.json (stdlib only)
+engine/nightly.py refreshes README marker sections + bumps entropy generation (stdlib only)
+state/demon.json bits_sorted / generation / demons / last_sorted_at
+assets/entropy.svg generated — never hand-edit; regenerate via the engine
+.github/workflows/demon.yml issues:opened, title "demon: sort 12 bits" → +12 bits, regen SVG, commit, comment, close
+.github/workflows/nightly.yml cron 17 6 * * * → engine/nightly.py, commit if changed
+.github/workflows/snake.yml cron every 12h → contribution snake SVGs on the `output` branch
```
-## Working with this Repository
+## README marker sections (machine-written — edit the generators, not the sections)
-Since this is a profile repository with only a README.md file:
+- `` — 4 newest Strange Quarks articles (RSS `/feed.xml` if populated, else parsed from https://stevenmilanese.com/blog HTML)
+- `` — telemetry row with live star/repo totals
+- `` — featured cards (anthropic-certs, slTrain, meowchi-releases, mpl) with live star counts
-- Any changes should maintain the professional formatting and structure of the profile README
-- The README uses GitHub-flavored markdown with centered content, badges, and images
-- External image assets are referenced from `https://github.com/developtheweb/stevenmilanese-com/blob/main/public/`
+`engine/nightly.py` is fail-safe per section: on fetch/parse failure it leaves that section untouched and exits 0.
-## Note
+## Conventions
-This is not a development project - it's a GitHub profile repository used for personal branding and showcasing work. There are no build commands, tests, or development workflows associated with this repository.
\ No newline at end of file
+- Conventional commit messages (`feat:`, `fix:`, `chore:`, `ci:`). No attribution footers of any kind.
+- Contact is `rev@moonfactory.dev` only — the old Telegram link and the old level-host email address are retired and must not reappear.
+- Entropy formula: `S = max(12.7, 100 − 0.0002·bits_sorted)`; 12 bits per demon click = 34.4 zJ (12 × kT ln 2 at 300 K).
+- SVG regeneration is deterministic for a given `generation` — diffs stay reviewable.
+- Test locally with `python3 engine/generate_entropy_svg.py` and `GITHUB_TOKEN=$(gh auth token) python3 engine/nightly.py` (both stdlib-only; no pip installs).
diff --git a/README.md b/README.md
index 47ffd49..fc9bf66 100644
--- a/README.md
+++ b/README.md
@@ -1,191 +1,120 @@
-
-
+# Reversing the irreversible
-
-
+*Rev. Steven Milanese — the second law is statistical, not sacred. The demon pays its bills in bits.*
-
- [](https://git.io/typing-svg)
-
-
-
-
-
-
-
-
+
+
+ [⚡ Be the demon — sort 12 bits](https://github.com/developtheweb/developtheweb/issues/new?title=demon%3A+sort+12+bits&body=One+tap.+Submit+to+sort.)
+
+ Each click opens a one-tap issue; an Action sorts the field, recommits the SVG, closes the issue. This README's state is community-lowered entropy.
-
-
-
-
-
-
+## About the Reverend
-## 🎯 About Me
-
-```python
-class StevenMilanese:
- def __init__(self):
- self.title = "Autodidactic Polymath | Systems Alchemist"
- self.location = "🌍 Earth"
- self.os = "Arch Linux BTW 🐧"
- self.current_focus = ["AI Architecture", "Quantum Computing", "WebGL", "Spiritual Tech"]
- self.philosophy = "Bridge technical excellence with human experience"
-
- def transform_challenges(self, problem):
- return f"✨ Inspired solution for {problem}"
+```
+Reverend ≔ Physicist ⊗ Minister ⊗ Systems_Alchemist
+domain : ℝ³·¹ ⊗ CY₃(χ = ±6)
+axiom : complexity ⟼ elegance
+method : ∀ p ∈ Inconceivable — solve(p) ∨ pose(better_p)
+runtime : Arch Linux, btw
```
-I transform complex challenges into inspired technological solutions. By seamlessly integrating Artificial Intelligence with cutting-edge development practices, I create systems that push the boundaries of what's possible. My expertise spans multiple domains including theoretical physics, mathematics, AI systems architecture, and spiritual technology.
+*Written in MPL — the author's own language. Ordained minister, autodidactic polymath, natural philosopher. The ministry and the physics are the same inquiry conducted at different energy scales.*
-## 🚀 Tech Arsenal
+## The mission — goals inconceivable by design
+
+
+
+
+**Reverse the irreversible**
+
+Maxwell's demon on GitHub's own infrastructure, funded in Landauer's currency. *(running above)*
+
+
+
+
+**Derive the three generations**
+
+Calabi–Yau compactifications, χ = ±6. [ORCID](https://orcid.org/0009-0008-0442-208X) · [OSF](https://osf.io/3tsd4/) · [companion essays](https://stevenmilanese.com/blog/tag/calabi-yau-manifolds)
+
+
+
+
+
+
+**Cognitive universality**
+
+[MPL](https://github.com/developtheweb/mpl): if you can write the equation, you can run it.
+
+
+
+
+**Planetary intelligence**
+
+Earth as information processor, argued in full on [Strange Quarks](https://stevenmilanese.com/blog/planetary-intelligence-earth-as-information-processor).
+
+
+
+
+
+
-### Languages & Frameworks
-
-
-
-
-
-
-
-
-### Operating System & Environment
-
-
-
-
-
-### Tools & Technologies
-
-
-
-
-
-
-
+`10¹⁰⁶ yr until heat death — the deadline` · `2.9 zJ of order per bit sorted (kT ln 2, 300 K)` · `★ 27 stars across 14 public repos`
+
-## 📊 GitHub Analytics
+## Beneath the physics — the verified inventory
+
diff --git a/assets/entropy.svg b/assets/entropy.svg
new file mode 100644
index 0000000..9fb7c8a
--- /dev/null
+++ b/assets/entropy.svg
@@ -0,0 +1,126 @@
+
diff --git a/engine/generate_entropy_svg.py b/engine/generate_entropy_svg.py
new file mode 100644
index 0000000..c053295
--- /dev/null
+++ b/engine/generate_entropy_svg.py
@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+"""Generate assets/entropy.svg — a SMIL-animated entropy-reversal field.
+
+120 particles loop from a seeded chaos cloud into a (2,5) torus-knot
+lattice, hold, and scatter back. State (bits sorted by visitors, chaos
+generation) comes from state/demon.json. Stdlib only; deterministic for
+a given generation so regenerated output is diffable.
+"""
+
+import hashlib
+import json
+import math
+import os
+import sys
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+STATE_PATH = os.path.join(ROOT, "state", "demon.json")
+OUT_PATH = os.path.join(ROOT, "assets", "entropy.svg")
+
+WIDTH, HEIGHT = 880, 260
+MARGIN = 20
+N_PARTICLES = 120
+KNOT_R, KNOT_r = 150, 58
+DUR = "11s"
+KEY_TIMES = "0;0.64;0.82;1"
+KEY_SPLINES = "0.25 0.1 0.25 1;0 0 1 1;0.55 0 0.45 1"
+
+BG = "#010409"
+BORDER = "#21262d"
+CYAN = "#4dd4e8"
+DEEP = "#1d6f7d"
+GREEN = "#7ee2a8"
+MUTED = "#8b949e"
+
+
+def seeded_unit(index, generation, channel):
+ """Deterministic float in [0, 1) from particle index + generation."""
+ digest = hashlib.sha256(f"{index}:{generation}:{channel}".encode()).digest()
+ return int.from_bytes(digest[:8], "big") / 2**64
+
+
+def knot_points(n):
+ """(2,5) torus knot sampled at n points, scaled/centered to the canvas."""
+ raw = []
+ for i in range(n):
+ t = 2 * math.pi * i / n
+ rad = KNOT_R + KNOT_r * math.cos(5 * t)
+ raw.append((rad * math.cos(2 * t), 0.62 * rad * math.sin(2 * t)))
+ xs, ys = [p[0] for p in raw], [p[1] for p in raw]
+ span_x, span_y = max(xs) - min(xs), max(ys) - min(ys)
+ scale = min((WIDTH - 2 * MARGIN) / span_x, (HEIGHT - 2 * MARGIN) / span_y)
+ cx, cy = (max(xs) + min(xs)) / 2, (max(ys) + min(ys)) / 2
+ return [
+ (WIDTH / 2 + (x - cx) * scale, HEIGHT / 2 + (y - cy) * scale)
+ for x, y in raw
+ ]
+
+
+def main():
+ with open(STATE_PATH) as fh:
+ state = json.load(fh)
+ bits = int(state.get("bits_sorted", 0))
+ generation = int(state.get("generation", 0))
+ entropy = max(12.7, 100 - 0.0002 * bits)
+ s_label = f"{entropy:.1f}"
+
+ lattice = knot_points(N_PARTICLES)
+ parts = [
+ f'")
+
+ svg = "\n".join(parts) + "\n"
+ os.makedirs(os.path.dirname(OUT_PATH), exist_ok=True)
+ with open(OUT_PATH, "w") as fh:
+ fh.write(svg)
+ size = os.path.getsize(OUT_PATH)
+ print(f"wrote {OUT_PATH} ({size} bytes, S={s_label}, bits={bits}, gen={generation})")
+ if size > 200 * 1024:
+ print("error: SVG exceeds 200 KB budget", file=sys.stderr)
+ sys.exit(1)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/engine/nightly.py b/engine/nightly.py
new file mode 100644
index 0000000..d4358b2
--- /dev/null
+++ b/engine/nightly.py
@@ -0,0 +1,210 @@
+#!/usr/bin/env python3
+"""Nightly telemetry refresh for the profile README.
+
+Updates the marker-fenced sections of README.md:
+ FEED — 4 newest Strange Quarks articles (RSS if populated, else the
+ server-rendered blog HTML)
+ STATS — telemetry row with live star/repo totals
+ FEATURED — star counts on the featured project cards
+and bumps the entropy field's chaos generation so the field differs daily.
+
+Every section is fail-safe: if a fetch or parse fails, that section is left
+untouched and the script still exits 0. Stdlib only.
+"""
+
+import datetime
+import html as htmllib
+import json
+import os
+import re
+import subprocess
+import sys
+import urllib.request
+import xml.etree.ElementTree as ET
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+README = os.path.join(ROOT, "README.md")
+STATE_PATH = os.path.join(ROOT, "state", "demon.json")
+
+SITE = "https://stevenmilanese.com"
+FEED_URL = f"{SITE}/feed.xml"
+BLOG_URL = f"{SITE}/blog"
+
+FEATURED_REPOS = [
+ ("anthropic-certs", "Verified Anthropic certifications — Claude, API, Claude Code CLI, MCP."),
+ ("slTrain", "A steam locomotive for your terminal, smoke trail included."),
+ ("meowchi-releases", "A desktop pet that evolves when you actually get work done."),
+ ("mpl", "Mathematics Programming Language — write the equation, run the equation."),
+]
+
+
+def fetch(url, accept=None):
+ req = urllib.request.Request(url, headers={"User-Agent": "developtheweb-nightly/1.0"})
+ if accept:
+ req.add_header("Accept", accept)
+ token = os.environ.get("GITHUB_TOKEN")
+ if token and url.startswith("https://api.github.com"):
+ req.add_header("Authorization", f"Bearer {token}")
+ with urllib.request.urlopen(req, timeout=30) as resp:
+ return resp.read().decode("utf-8", errors="replace")
+
+
+def gh_api(path):
+ return json.loads(fetch(f"https://api.github.com{path}", accept="application/vnd.github+json"))
+
+
+def replace_section(text, marker, body):
+ start, end = f"", f""
+ if start not in text or end not in text:
+ raise ValueError(f"missing {marker} markers")
+ pre = text.split(start)[0]
+ post = text.split(end)[1]
+ return f"{pre}{start}\n{body}\n{end}{post}"
+
+
+def articles_from_rss():
+ root = ET.fromstring(fetch(FEED_URL))
+ items = []
+ for item in root.iter("item"):
+ title = (item.findtext("title") or "").strip()
+ link = (item.findtext("link") or "").strip()
+ pub = (item.findtext("pubDate") or "").strip()
+ date = None
+ try:
+ date = datetime.datetime.strptime(pub[:16].strip(), "%a, %d %b %Y")
+ except ValueError:
+ pass
+ if title and link:
+ items.append({"title": title, "url": link, "date": date, "meta": ""})
+ return items
+
+
+def articles_from_html():
+ page = fetch(BLOG_URL)
+ skip = ("/blog/tag/", "/blog/author/")
+ anchors = [
+ m for m in re.finditer(r']+href="(/blog/[a-z0-9][a-z0-9-]*)"', page)
+ if not m.group(1).startswith(skip)
+ ]
+ seen, articles = set(), []
+ for idx, m in enumerate(anchors):
+ slug = m.group(1)
+ if slug in seen:
+ continue
+ seen.add(slug)
+ stop = len(page)
+ for nxt in anchors[idx + 1:]:
+ if nxt.group(1) != slug:
+ stop = nxt.start()
+ break
+ window = page[m.start():stop]
+ title_m = re.search(r'alt="([^"]+)"', window)
+ stripped = re.sub(r"<[^>]+>", " ", window)
+ stripped = htmllib.unescape(re.sub(r"", "", stripped))
+ date_m = re.search(r"([A-Z][a-z]+ \d{1,2}, \d{4})", stripped)
+ mins_m = re.search(r"(\d+)\s*min", stripped)
+ views_m = re.search(r"([\d,]+)\s*views", stripped)
+ if not (title_m and date_m):
+ continue
+ date = datetime.datetime.strptime(date_m.group(1), "%B %d, %Y")
+ meta = f"{mins_m.group(1)} min read" if mins_m else (
+ f"{views_m.group(1)} views" if views_m else ""
+ )
+ articles.append({
+ "title": htmllib.unescape(title_m.group(1)),
+ "url": f"{SITE}{slug}",
+ "date": date,
+ "meta": meta,
+ })
+ return articles
+
+
+def update_feed(text):
+ articles = []
+ try:
+ articles = articles_from_rss()
+ except Exception as exc:
+ print(f"feed: rss unusable ({exc}); falling back to html")
+ if not articles:
+ articles = articles_from_html()
+ dated = [a for a in articles if a["date"]]
+ dated.sort(key=lambda a: a["date"], reverse=True)
+ newest = dated[:4]
+ if len(newest) < 4:
+ raise ValueError(f"only {len(newest)} parseable articles")
+ rows = ["| Article | |", "|:---|---:|"]
+ for a in newest:
+ title = a["title"].replace("|", "\\|")
+ when = a["date"].strftime("%b %d, %Y").replace(" 0", " ")
+ meta = f"{when} · {a['meta']}" if a["meta"] else when
+ rows.append(f"| [{title}]({a['url']}) | {meta} |")
+ return replace_section(text, "FEED", "\n".join(rows))
+
+
+def update_stats(text):
+ repos = gh_api("/users/developtheweb/repos?per_page=100&type=owner")
+ public = [r for r in repos if not r["private"]]
+ stars = sum(r["stargazers_count"] for r in public)
+ line = (
+ "
\n\n"
+ "`10¹⁰⁶ yr until heat death — the deadline` · "
+ "`2.9 zJ of order per bit sorted (kT ln 2, 300 K)` · "
+ f"`★ {stars} stars across {len(public)} public repos`\n\n"
+ "
"
+ )
+ return replace_section(text, "STATS", line)
+
+
+def update_featured(text):
+ cards = []
+ for name, blurb in FEATURED_REPOS:
+ repo = gh_api(f"/repos/developtheweb/{name}")
+ cards.append(
+ f'
+*Rev. Steven Milanese — the second law is statistical, not sacred. The demon pays its bills in bits.*
-
- [](https://git.io/typing-svg)
-
-
- 
+ 
+
+ [⚡ Be the demon — sort 12 bits](https://github.com/developtheweb/developtheweb/issues/new?title=demon%3A+sort+12+bits&body=One+tap.+Submit+to+sort.)
+
+ Each click opens a one-tap issue; an Action sorts the field, recommits the SVG, closes the issue. This README's state is community-lowered entropy.
- 
- 
- 
- 
- 
- 
-
-