⚒ ACG P2P · guild mesh

AI Craftspeople Guild · peer-to-peer, serverless, SCADA-instrumented chat plant.

---

📡 Live plant readout

Badges below read controls/db/tags.json on every render. Edit that file (or use one of the issue forms below) and the HMI updates.

💬 chat

📡 tracker · signalling

🔑 identity · ⌖ version

⚠ errors · 🧪 sandbox

---

🎛 Controls

Every button below is a pre-filled GitHub issue form — filing it writes to the DB. The sync workflow (.github/workflows/sync-db.yml) picks each one up and commits the merged JSON back to main.

Open issue templates directly

• tag-update.yml — 🏷️ <path> = <value>, quality, type, note
• log-entry.yml — ⚠ [<LEVEL>] <msg> with optional stack / meta
• control-action.yml — clear-log · rotate-tracker · join-room · pin/unpin-tag · force-reannounce · toggle-monitor · custom

---

🧬 Architecture

flowchart LR
  subgraph browser [browser]
    CHAT[💬 chat]
    AUTH[🔑 auth]
    VER[⌖ version]
    ERR[⚠ errors]
    SCADA[🖥️ SCADA]
    SBX[🧪 sandbox]
  end
  BUS((🛰️ acg-mesh))
  DB[(🗄️ db / tags.json)]
  BADGES[shields.io badges]
  FORMS[issue forms]

  CHAT --> SCADA
  AUTH --> SCADA
  VER --> SCADA
  ERR --> SCADA
  SBX --> BUS
  BUS --> SCADA
  SCADA -.-> DB
  DB --> BADGES
  FORMS -.-> DB

Loading

---

📁 Repo layout

⚒ ACGP2P/
├─ index.html            🏠  operator dashboard / landing
├─ controls/             🎛  control-plane subsystems
│   ├─ scada/              🖥️  owns sys.* version.* + dense manifests (§0—§4)
│   │   ├─ 00-legend.json  …  04-sandbox.json       declarative specs
│   │   ├─ programs/           per-module dense-glyph specs
│   │   ├─ errors/         ⚠  owns errors.*  (gateway-log area)
│   │   └─ gateway/        🛰  SCADA gateway host
│   │       ├─ styles/         theme.css · style.css · section.css   (HMI consistency)
│   │       ├─ scripts/        runtime ES modules (main · ui · config · p2p · peers · chat · auth · version · errors · sandbox-bridge · scada/*)
│   │       ├─ providers/      registry.json — canonical tag-provider registry
│   │       └─ auth/       🔑  identity module · owns auth.* (webrtc/webtorrent/discord/github/google)
│   ├─ hmi/                🖼  ISA-101 operator interface (layers, palette, faceplates)
│   │   └─ chat/             💬  P2P chat HMI screen · owns chat.* room.* tracker.* peers.* signal.*
│   ├─ plc/                🔧  GitPLC universal PLC namespace (git/ UDT templates)
│   ├─ sandbox/            🧪  browser-only tools · owns sandbox.*
│   │   └─ web-llm/          🧠 voice-powered in-browser LLM
│   ├─ db/                 🗄️  tags.json (HMI source) · README.md
│   └─ docs/standards/     📐  Konomi meta-standard + GitPLC standard
├─ .github/
│   ├─ ISSUE_TEMPLATE/   tag-update · log-entry · control-action
│   └─ workflows/        sync-db.yml

---

🌐 Glyphs · type shorthand

See controls/scada/00-legend.json for the full decompressor. Every manifest in this repo uses the same grammar:

glyph	meaning	glyph	meaning
🏗️	UDT	📋	provider
📦	instance	🏷️	tag
🔌	channel	🖥️	HMI
💬	chat	🧪	sandbox
👥	peer	🧠	LLM
📡	tracker	🎤	voice
🔀	commit	💜	emotion
📁	file	🛰️	mesh bridge
🔑	identity	⚙️	config
🟢 🟡 🔴	tag quality	和	resonant / complete

---

🏗️ Quick start

# serve locally (no build)
python3 -m http.server 8000
open http://localhost:8000/

Or just visit https://teslasolar.github.io/ACGP2P/ and the mesh finds its peers.

---

📄 License

MIT · © AI Craftspeople Guild