opencode-skills-collection 4.0.71 → 4.0.73

package/bundled-skills/dali-short-address-commissioner/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: dali-short-address-commissioner
+description: "Commissions DALI and DALI-2 (IEC 62386) lighting buses: short-address assignment (0-63), 24-bit binary search collision resolution, groups, and DT8 color control. Trigger phrases: commission dali, dali short address, dali collision resolution, dali bus addressing, dali-2 setup."
+category: architecture
+risk: safe
+source: community
+source_repo: wwewtech/dali-short-address-commissioner
+source_type: community
+date_added: "2026-09-22"
+author: wwewtech
+tags: [dali, dali-2, lighting-control, iec-62386, building-automation, iot]
+tools: [claude, cursor, gemini, windsurf]
+license: "MIT"
+---
+
+# DALI Short-Address Commissioner: Deterministic IEC 62386 Bus Provisioning
+
+Systematically discover, resolve address collisions, assign short addresses (0–63), program groups and scenes, configure DT8 color gear, and schedule emergency battery duration tests on DALI and DALI-2 networks per IEC 62386.
+
+## When to Use This Skill
+
+Activate this skill when:
+- Bringing up, commissioning, or expanding DALI or DALI-2 lighting installations (KNX/DALI gateways, Tridonic, Philips Dynalite, Helvar, Osram, Lunatone).
+- The user asks: "How do I commission this DALI bus?", "Fix duplicate DALI short addresses", "Assign DALI addresses without erasing existing fixtures", or "Program DALI groups and DT8 tunable white".
+- Resolving address clash loops where multiple ballasts respond simultaneously to broadcast queries.
+- Designing or scheduling DALI-2 Part 202 emergency lighting duration and function tests across staggered floor circuits.
+
+Do NOT use this skill when:
+- Commissioning DMX512/RDM stage lighting, 0–10V analog dimming, or proprietary wireless RF networks (Zigbee, Bluetooth Mesh, Casambi).
+- Diagnosing dead ballasts or physical wiring faults before basic DALI bus voltage (12V–20.5V DC) and current limits (<= 250mA) are confirmed.
+- Programming building-wide KNX logic (this skill covers the DALI protocol domain strictly).
+
+## Core Mental Models & Non-Negotiable Rules
+
+1. **The 64-Address Bus Capacity Law**:
+   - A single DALI subnet supports strictly **0 to 63 short addresses** (64 control gear units maximum).
+   - Groups are strictly bounded to **0 to 15** (16 groups).
+   - Scenes are strictly bounded to **0 to 15** (16 scenes).
+   - If an installation has 65+ ballasts, the physical bus MUST be segmented into multiple DALI subnets with separate line masters or gateways.
+
+2. **The Double-Command 100ms Transmission Invariant**:
+   - Configuration and addressing commands (INITIALISE [cmd 258], RANDOMISE [259], SET SHORT ADDRESS [267], ENABLE WRITE [cmd 32], etc.) MUST be transmitted **twice within 100ms** to be executed by control gear.
+   - Sending an addressing command only once will result in silent ignored execution by all IEC 62386 compliant gear.
+
+3. **The 15-Minute Hardware Commissioning Timer**:
+   - Transmitting `INITIALISE` (cmd 258) starts a mandatory 15-minute countdown timer inside every ballast's micro-controller.
+   - All discovery, random address binary searching, and short address assignment MUST complete within 15 minutes, or the bus must receive a periodic keep-alive `INITIALISE` refresh.
+   - Upon completion, the master MUST transmit `TERMINATE` (cmd 257) to lock operational memory and exit programming state.
+
+4. **24-Bit Random Address Binary Search ($2^{24} = 16,777,216$ Space)**:
+   - When gear enters randomizing state (`RANDOMISE`), each unit generates a pseudo-random 24-bit integer (`0x000000` to `0xFFFFFF`).
+   - The master searches the 24-bit space using `SEARCHADDRH`, `SEARCHADDRM`, `SEARCHADDRL` and `COMPARE` (cmd 265).
+   - If multiple ballasts match, the master performs binary search down to a single device.
+   - Once isolated, assign short address via `PROGRAM SHORT ADDRESS` (cmd 267) and immediately transmit `WITHDRAW` (cmd 266) so the addressed fixture drops out of remaining search iterations.
+
+5. **Physical Identify & Non-Destructive Extension Invariant**:
+   - Every assigned short address MUST be verified visually using `IDENTIFY` or toggling `RECALL MAX LEVEL` / `OFF` before committing to lighting schedules.
+   - When adding fixtures to an existing operational line, NEVER broadcast a global `INITIALISE (all)`; use `INITIALISE (without short address)` so already-commissioned ballasts (0–63) preserve their programming.
+
+## Named Sins & Anti-Patterns (Что категорически ЗАПРЕЩЕНО)
+
+| Anti-Pattern | Manifestation in Code/Workflow | Mandatory Production Counter-Rule |
+| :--- | :--- | :--- |
+| **Single-Shot Addressing Commands** | Sending cmd 258 or cmd 267 once without repetition. | Always repeat configuration commands within a strict 100ms window. |
+| **Exceeding 64 Short Addresses** | Attempting to assign address 64 or 65 on one loop. | Partition into Subnet A and Subnet B; enforce 0–63 maximum. |
+| **Timer Starvation** | Letting the 15-minute `INITIALISE` window expire mid-search. | Issue keep-alive refresh or optimize binary search loop to < 3 minutes. |
+| **Ghost Address Overwrite** | Assigning address 0 without scanning if address 0 is in use. | Run non-destructive `QUERY STATUS` (cmd 144) across 0–63 before reassigning. |
+| **Bus Overcurrent Overload** | Connecting 64 ballasts (2mA each) + sensors to a 100mA PSU. | Verify total quiescent load $\le$ PSU rating (250mA max per IEC 62386). |
+| **DT8 / DT6 Type Mismatch** | Controlling tunable white gear with single-channel DT6 arc power. | Issue `SELECT DIMMING CURVE / COLOUR` (Part 209) and send DT8 color coordinates. |
+| **Simultaneous Emergency Discharge** | Triggering 3-hour duration tests on all emergency lights at once. | Stagger tests across alternating weeks/groups to ensure safety illumination. |
+| **Missing WITHDRAW Command** | Forgetting cmd 266 after addressing a found ballast. | Send `WITHDRAW` immediately after `PROGRAM SHORT ADDRESS` to exclude from search. |
+| **DALI Polarity Panic** | Halting installation claiming standard DALI requires polarity. | Note DALI uses an integrated bridge rectifier; polarity is non-critical (though consistent coloring is advised). |
+| **Energizing Unverified Mains** | Commissioning ballasts while 230V live mains work is ongoing. | Enforce physical lockout/tagout (LOTO) prior to terminal connection. |
+
+## Concrete Archetypes / Presets
+
+### Archetype 1: Greenfield DALI Discovery & Binary Search (Python/C Pseudo-code)
+```python
+import time
+
+def send_dali_double_cmd(cmd_byte1: int, cmd_byte2: int):
+    transmit_dali_frame(cmd_byte1, cmd_byte2)
+    time.sleep(0.015)  # 15ms spacing
+    transmit_dali_frame(cmd_byte1, cmd_byte2)
+
+def commission_greenfield_bus() -> dict:
+    assigned = {}
+    # 1. Start 15-min commissioning session
+    send_dali_double_cmd(0xA5, 0x00)  # INITIALISE (all gear)
+    send_dali_double_cmd(0xA7, 0x00)  # RANDOMISE
+    time.sleep(0.100)                  # Wait 100ms for random address generation
+
+    next_short_addr = 0
+    while next_short_addr < 64:
+        low, high = 0x000000, 0xFFFFFF
+        found_random_addr = None
+
+        # Binary search 24-bit space
+        while low <= high:
+            mid = (low + high) // 2
+            set_search_address(mid)
+            if query_compare():  # cmd 265: does any gear have random_addr <= mid?
+                found_random_addr = mid
+                high = mid - 1
+            else:
+                low = mid + 1
+
+        if found_random_addr is None:
+            break  # No more unaddressed fixtures on the bus
+
+        # Isolate and assign
+        set_search_address(found_random_addr)
+        short_addr_payload = (next_short_addr << 1) | 0x01
+        send_dali_double_cmd(0xB7, short_addr_payload)  # PROGRAM SHORT ADDRESS
+        send_dali_cmd(0xAB, 0x00)                       # WITHDRAW (cmd 266)
+
+        # Physical verify
+        flash_fixture(next_short_addr)
+        assigned[next_short_addr] = hex(found_random_addr)
+        next_short_addr += 1
+
+    send_dali_cmd(0xA1, 0x00)  # TERMINATE (cmd 257)
+    return assigned
+```
+
+### Archetype 2: Surgical Replacement of a Failed Ballast
+```python
+def replace_single_failed_ballast(expected_short_addr: int):
+    # Do NOT wipe existing 63 ballasts:
+    send_dali_double_cmd(0xA5, 0xFF)  # INITIALISE (ONLY gear without short address)
+    send_dali_double_cmd(0xA7, 0x00)  # RANDOMISE
+    time.sleep(0.100)
+
+    # Perform binary search for the single new replacement unit
+    random_addr = search_single_unit()
+    set_search_address(random_addr)
+
+    # Program directly into the missing slot
+    payload = (expected_short_addr << 1) | 0x01
+    send_dali_double_cmd(0xB7, payload)
+    send_dali_cmd(0xAB, 0x00)  # WITHDRAW
+    send_dali_cmd(0xA1, 0x00)  # TERMINATE
+```
+
+### Archetype 3: Group & DT8 Tunable White Configuration
+```python
+def configure_dt8_tunable_white(short_addr: int, mirek: int, group_id: int):
+    # Mirek = 1,000,000 / Kelvin (e.g. 2700K = 370 mirek, 6500K = 153 mirek)
+    send_dali_cmd(0x01, 0x00)  # DTR0: low byte of mirek
+    send_dali_cmd(0x03, 0x00)  # DTR1: high byte of mirek
+    send_dali_double_cmd(0xE7, 0x20)  # SET TEMP COLOUR (DT8 Part 209)
+    # Add to group (0-15)
+    group_payload = 0x60 | (group_id & 0x0F)
+    send_dali_double_cmd(0x01 | (short_addr << 1), group_payload)
+```
+
+## The Pre-Emit Quality Gate Checklist
+
+Before finalizing any DALI commissioning plan or script, check:
+- [ ] **Address Ceiling**: Total short addresses $\le 64$ (addresses 0–63).
+- [ ] **Double Transmission Timing**: Configuration commands repeat twice within 100ms.
+- [ ] **Commissioning Window**: 15-minute timer monitored with `TERMINATE` sent at conclusion.
+- [ ] **Withdrawal Discipline**: `WITHDRAW` (cmd 266) sent immediately after each address assignment.
+- [ ] **Bus Current Check**: Total quiescent load calculated ($\le 250\text{mA}$ power supply capacity).
+- [ ] **Emergency Test Staggering**: Emergency battery duration tests scheduled in alternating groups.
+- [ ] **Physical Verification**: `IDENTIFY` / `WINK` toggle step included for human visual signoff.
+
+## Self-Correction & Verification Loop
+
+### Bad (Vibe-Coded AI Slop Output):
+> "To assign addresses on DALI, loop from 1 to 100 and send cmd 267 to each light. If lights don't respond, change the positive and negative wires because DALI needs polarity."
+*Problems: Exceeds 64 addresses, addresses start at 1 instead of 0, misses double-command transmission, forgets random search, wrongly asserts DALI polarity dependence.*
+
+### Good (Production DALI Commissioner Output):
+> 1. Verify bus PSU delivers 16V DC with total load under 250mA (e.g., 42 ballasts $\times$ 2mA = 84mA).
+> 2. Send `INITIALISE (all)` [cmd 258] twice within 100ms, starting the 15-minute commissioning watchdog.
+> 3. Transmit `RANDOMISE` [cmd 259] twice within 100ms.
+> 4. Execute 24-bit binary search across `SEARCHADDR` space. For each isolated unit, transmit `PROGRAM SHORT ADDRESS` (slot 0–41) twice within 100ms, immediately followed by `WITHDRAW` [cmd 266].
+> 5. Issue `TERMINATE` [cmd 257] to exit programming mode and physically pulse each luminaire to verify mapping.
+
+## Limitations
+
+- DALI command support, timing, gear limits, and DT8 behavior vary by control gear, device type, and IEC 62386 edition. Confirm commands against the exact gear and gateway manuals before transmission.
+- Commissioning can disrupt occupied lighting and emergency systems. Coordinate an approved outage and have a qualified lighting professional verify any live bus operation; never treat these examples as a substitute for site procedures.
+- Pseudo-code is illustrative and is not a tested gateway driver. Verify address mapping and every fixture physically before saving configuration.

package/bundled-skills/eol-resistor-calculator/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: eol-resistor-calculator
+description: "Calculates and validates end-of-line (EOL, SEOL, DEOL, TEOL) resistor loops for intrusion alarm panels (Honeywell, DSC, Paradox, Bosch) with wire gauge drop and state tables. Trigger phrases: eol resistor, deol wiring, alarm zone resistor, calculate end of line, double eol tamper."
+category: architecture
+risk: safe
+source: community
+source_repo: wwewtech/eol-resistor-calculator
+source_type: community
+date_added: "2026-09-22"
+author: wwewtech
+tags: [security-systems, hardware, electronics, alarm-panel, circuit-design, electrical-engineering]
+tools: [claude, cursor, gemini, windsurf]
+license: "MIT"
+---
+
+# EOL Resistor Calculator: Precision Intrusion Loop Supervision & State Solver
+
+Accurately size, configure, and troubleshoot Single (SEOL), Double (DEOL), and Triple (TEOL) end-of-line resistor loops across major security panel architectures with copper wire drop compensation and tamper state discrimination.
+
+## When to Use This Skill
+
+Activate this skill when:
+- Sizing, retrofitting, or diagnosing hardwired security loops on alarm panels (DSC PowerSeries/Neo, Honeywell Ademco Vista, Paradox EVO/Spectra, Bosch B/G Series, Texecom Premier Elite).
+- The user asks: "How do I wire double EOL on a DSC panel?", "Calculate zone loop resistance for a 200m cable run", "Troubleshoot a constant zone tamper fault", or "What resistor values does Honeywell Vista use?".
+- Differentiating between Normal, Alarm, Tamper (Short), and Cut (Open) circuit states across varying panel threshold windows.
+- Sizing copper loop resistance drops on long perimeter runs (e.g. 22 AWG over 150+ meters) to prevent phantom false alarms.
+
+Do NOT use this skill when:
+- Designing wireless sensors or addressable polling loop multiplexers (polling loops use digital transponders, not passive EOL resistors).
+- Bypassing safety or life-safety supervision circuits (never advise strapping out resistors or bypassing line supervision).
+- Working on 2-wire smoke detector loops without consulting panel-specific smoke circuit polarity and current-limiting specs.
+
+## Core Mental Models & Non-Negotiable Rules
+
+1. **The Far-End Placement Axiom (Strict Anti-Panel Stacking)**:
+   - Resistors MUST be installed **inside the sensor housing at the farthest physical end of the cable run**.
+   - Placing resistors across screw terminals inside the alarm panel enclosure protects only the metal cabinet itself; the entire 50-meter cable run to the sensor is left vulnerable to undetected wire cuts or staple shorts.
+   - Any wiring diagram showing EOL resistors at the panel board for field sensors is flagged as a Grade 2/Grade 3 compliance violation.
+
+2. **The 4-State Double-EOL (DEOL) Truth Table**:
+   - Double EOL uses two resistors: an End-of-Line resistor ($R_{EOL}$) and an Alarm contact resistor ($R_{ALARM}$).
+   - Standard series-parallel configuration (e.g., DSC standard 5.6k / 5.6k):
+     $$\text{Loop State} = \begin{cases} 
+     0\ \Omega\ (\text{Short Circuit}) & \implies \mathbf{Tamper\ (Short)} \\
+     R_{EOL}\ (5.6\text{k}\ \Omega) & \implies \mathbf{Normal\ (Secure)} \\
+     R_{EOL} + R_{ALARM}\ (11.2\text{k}\ \Omega) & \implies \mathbf{Alarm\ (Tripped)} \\
+     \infty\ \Omega\ (\text{Open Circuit}) & \implies \mathbf{Tamper\ (Cut\ Wire)}
+     \end{cases}$$
+   - This provides complete supervised discrimination between intruder activation and physical sabotage.
+
+3. **Copper Wire Resistance Compensation Formula**:
+   - Long field cable runs add series loop resistance across both conductors:
+     $$R_{loop} = 2 \times D \times \rho_{gauge}$$
+     where $D$ is one-way distance in meters, and $\rho_{gauge}$ is resistance per meter:
+     - **22 AWG (0.326 mm²)**: $0.053\ \Omega/\text{meter}$ ($16.14\ \Omega/1000\text{ft}$)
+     - **20 AWG (0.518 mm²)**: $0.033\ \Omega/\text{meter}$ ($10.15\ \Omega/1000\text{ft}$)
+     - **18 AWG (0.823 mm²)**: $0.021\ \Omega/\text{meter}$ ($6.38\ \Omega/1000\text{ft}$)
+   - A 150m run of 22 AWG adds $2 \times 150 \times 0.053 \approx 15.9\ \Omega$. Ensure total loop resistance does not push readings beyond the panel's $\pm 15\%$ ADC tolerance window.
+
+4. **Panel Reference Resistor Standards Matrix**:
+   - **DSC PowerSeries / Neo**: $5.6\text{k}\ \Omega$ SEOL / $5.6\text{k} + 5.6\text{k}$ DEOL.
+   - **Honeywell Ademco Vista**: $2.0\text{k}\ \Omega$ SEOL (Standard zones), $1.0\text{k}$ (Zone 1 on some models).
+   - **Paradox EVO / Spectra**: $1.0\text{k}\ \Omega$ SEOL / $1.0\text{k} + 1.0\text{k}$ DEOL (or ATZ mode with $1.0\text{k} / 2.2\text{k}$).
+   - **Bosch B / G Series**: Dual supervision with $1.0\text{k} / 2.0\text{k}$ or panel-selectable windows.
+   - **Texecom Premier Elite**: $2.2\text{k} / 4.7\text{k}$ or selectable Grade 3 Triple-EOL ($4.7\text{k} / 4.7\text{k} / 2.2\text{k}$ anti-mask).
+
+5. **ADC Voltage Divider Acceptance Windows**:
+   - Security panels measure zone voltage through an internal pull-up resistor ($R_{pullup}$, typically $1\text{k}$ to $3.3\text{k}\ \Omega$) connected to a reference voltage ($V_{ref}$, typically $5.0\text{V}$ or $13.8\text{V}$).
+   - Terminal voltage is given by:
+     $$V_{zone} = V_{ref} \times \frac{R_{loop\_total}}{R_{pullup} + R_{loop\_total}}$$
+   - Always confirm whether a measured terminal voltage falls inside the manufacturer's specified ADC threshold window before replacing field hardware.
+
+## Named Sins & Anti-Patterns (Что категорически ЗАПРЕЩЕНО)
+
+| Anti-Pattern | Manifestation in Code/Workflow | Mandatory Production Counter-Rule |
+| :--- | :--- | :--- |
+| **Panel-Terminal Resistor Stacking** | Crimping EOL resistors into the screw terminals on the panel PCB. | Install resistors exclusively inside the remote sensor housing. |
+| **Vendor Value Cross-Contamination** | Putting 2.0k Honeywell resistors onto a DSC panel requiring 5.6k. | Verify panel model and enforce manufacturer-specific resistance ratings. |
+| **DEOL Series/Parallel Inversion** | Swapping series and parallel resistors on an alarm PIR contact. | Wire $R_{ALARM}$ in parallel with NC alarm switch; wire $R_{EOL}$ in series with loop. |
+| **Neglecting Wire Drop on Long Runs** | Ignoring 40+ $\Omega$ wire resistance on a 300-meter warehouse fence zone. | Calculate loop resistance $2 \times D \times \rho$ and verify against panel budget. |
+| **Twist-and-Tape Resistor Splices** | Twisting resistor leads by hand and wrapping with electrical tape. | Use soldered heat-shrink sleeves or grease-filled B-connectors/crimps. |
+| **Fire/Burg Supervised Mix-up** | Applying burglar DEOL tamper logic to 2-wire latching fire zones. | Fire loops strictly require Normally Open (NO) contacts with SEOL supervision. |
+| **Unshielded AC Parallel Run** | Running 22/4 unshielded alarm cable in parallel with 230V mains. | Maintain 300mm physical separation or use twisted shielded pair (STP). |
+| **Strapping Out Trouble Zones** | Advising a user to twist zone wires together to clear a trouble condition. | Diagnose root cause (open wire, bad contact, corroded resistor) methodically. |
+| **Confusing NO and NC Contacts** | Treating a magnetic reed switch (NC) like an exit request button (NO). | Verify sensor contact behavior in quiescent, non-alarm states. |
+| **Unrecorded Commissioning Values** | Leaving an install without recording measured DC resistance values. | Deliver an audit log of measured loop ohms across Normal, Alarm, and Tamper. |
+
+## Concrete Archetypes / Presets
+
+### Archetype 1: Double-EOL (DEOL) Sensor Wiring Schematic (DSC 5.6k)
+```
+       (+) ZONE TERMINAL (Panel)
+               │
+               ▼  [Core 1: Field Wire]
+       ┌───────┴────────────────────────┐
+       │ SENSOR HOUSING (Far End)       │
+       │                                │
+       │    TAMPER SWITCH (NC)          │
+       │     ┌────[ / ]────┐            │
+       │     │             │            │
+       │     ▼             ▼            │
+       │    ( )           ( )           │
+       │     │             │            │
+       │     │        ALARM RELAY (NC)  │
+       │     │     ┌────[ / ]────┐      │
+       │     │     │             │      │
+       │     │     │   R_ALARM   │      │
+       │     │     └───[5.6k]────┘      │
+       │     │             │            │
+       │     ▼             ▼            │
+       │   R_EOL [5.6k]    │            │
+       │     │             │            │
+       └─────┼─────────────┼────────────┘
+             │             │
+             └─────────────┘
+               ▲
+               │  [Core 2: Field Wire]
+       (─) COMMON TERMINAL (Panel)
+
+State Resistance:
+• Secure:  5.6k Ω
+• Alarm:  11.2k Ω (Alarm contact opens, forcing current through R_ALARM)
+• Tamper: 0 Ω (Short circuit) or ∞ Ω (Cut wire or Tamper contact opens)
+```
+
+### Archetype 2: Loop Resistance & Tolerance Calculator (Python 3.10+)
+```python
+def calculate_loop_parameters(
+    panel_eol_nominal: float,
+    panel_tolerance_pct: float,
+    one_way_distance_m: float,
+    wire_gauge_awg: int = 22,
+    deol_mode: bool = True
+) -> dict:
+    # Ohms per meter for solid annealed copper conductors
+    RESISTANCE_PER_M = {18: 0.0209, 20: 0.0333, 22: 0.0530, 24: 0.0842}
+    rho = RESISTANCE_PER_M.get(wire_gauge_awg, 0.0530)
+    
+    wire_loop_ohms = 2.0 * one_way_distance_m * rho
+    normal_resistance = panel_eol_nominal + wire_loop_ohms
+    alarm_resistance = (panel_eol_nominal * 2.0 if deol_mode else float('inf')) + wire_loop_ohms
+    
+    tol_window = panel_eol_nominal * (panel_tolerance_pct / 100.0)
+    normal_min = panel_eol_nominal - tol_window
+    normal_max = panel_eol_nominal + tol_window
+    
+    is_normal_acceptable = (normal_min <= normal_resistance <= normal_max)
+    
+    return {
+        "wire_loop_resistance_ohms": round(wire_loop_ohms, 2),
+        "measured_normal_expected": round(normal_resistance, 2),
+        "measured_alarm_expected": round(alarm_resistance, 2),
+        "panel_acceptance_window": (round(normal_min, 2), round(normal_max, 2)),
+        "is_acceptable": is_normal_acceptable,
+        "recommendation": "OK" if is_normal_acceptable else "Wire resistance exceeds panel tolerance! Upsize to 20 AWG or 18 AWG."
+    }
+```
+
+### Archetype 3: Multimeter Field Diagnostic Workflow
+```markdown
+1. Disconnect zone loop wires from panel terminal Z1 and COM.
+2. Set digital multimeter to 20k Ω DC resistance range.
+3. Clip probes to black and red loop wires.
+4. Read resistance:
+   - Reading = 0 Ω: Direct short on cable or tamper circuit pinched.
+   - Reading = ~5.6k Ω: Loop is secure and healthy.
+   - Reading = ~11.2k Ω: Sensor is currently tripped (door open, motion active).
+   - Reading = O.L (∞ Ω): Broken conductor, disconnected terminal, or open tamper switch.
+5. Reconnect to panel and verify terminal voltage across Z1 and COM:
+   - Normal secure: 2.2V - 2.8V DC (on 5V pullup).
+   - Alarm: 3.5V - 4.1V DC.
+   - Tamper/Short: 0.0V DC.
+   - Cut/Open: 5.0V DC.
+```
+
+## The Pre-Emit Quality Gate Checklist
+
+Before emitting any alarm wiring advice, schematic, or resistor calculation:
+- [ ] **Placement Verification**: Explicitly mandate resistor placement at the remote detector, strictly barring panel-terminal stacking.
+- [ ] **Manufacturer Compliance**: Verified nominal EOL values match the specific panel model (Honeywell 2.0k, DSC 5.6k, Paradox 1.0k, etc.).
+- [ ] **Wire Gauge Compensation**: Calculated two-conductor wire loop resistance for distances $> 50$ meters.
+- [ ] **DEOL State Coverage**: Documented all 4 states (Normal, Alarm, Tamper Short, Tamper Open).
+- [ ] **Fire Circuit Distinction**: Confirmed burglary DEOL logic is never recommended for latching fire loops.
+- [ ] **Physical Connection Standards**: Specified soldered heat-shrink or B-connector crimps over raw tape twists.
+- [ ] **Zero Supervision Bypass**: Zero instructions provided to defeat or bypass loop supervision resistors.
+
+## Self-Correction & Verification Loop
+
+### Bad (Vibe-Coded AI Slop Output):
+> "To wire an alarm sensor, just twist the resistor onto the zone screw terminals on the panel board. A 1k resistor usually works for all panels. If you get a zone fault, just bypass the zone or short the wires together."
+*Problems: Fatal panel-terminal stacking, generic wrong resistor value, advises bypassing safety supervision, ignores tamper discrimination.*
+
+### Good (Production EOL Resistor Calculator Output):
+> For a **DSC PowerSeries Neo** panel using a **Double-EOL (DEOL)** PIR detector over an **80m run of 22 AWG** cable:
+> 1. **Resistor Placement**: Install two 5.6k $\Omega$ resistors (5% tolerance, 0.25W) strictly inside the PIR housing at the far end of the run.
+> 2. **Wiring Topology**:
+>    - Connect Tamper switch in series with the loop.
+>    - Connect first 5.6k $\Omega$ resistor ($R_{EOL}$) in series with the loop.
+>    - Connect second 5.6k $\Omega$ resistor ($R_{ALARM}$) in parallel across the NC Alarm relay contacts.
+> 3. **Wire Resistance Drop**: 80m of 22 AWG adds $2 \times 80 \times 0.053 = 8.48\ \Omega$. Total secure loop resistance will be $5,608.5\ \Omega$, well within DSC's $\pm 10\%$ acceptance window ($5,040\ \Omega$ to $6,160\ \Omega$).
+> 4. **Multimeter Diagnostic Verification**:
+>    - Secure: $5.61\text{k}\ \Omega$.
+>    - Walk-test (Alarm): $11.21\text{k}\ \Omega$.
+>    - Sensor cover removed (Tamper): $\infty\ \Omega$ (Open).
+>    - Crushed wire (Short): $8.5\ \Omega$ (Panel registers Tamper Short).
+
+## Limitations
+
+- EOL values, wiring topologies, and zone states are panel- and detector-specific. Use the installation manual and approved wiring diagram for the exact model; the examples are not universal specifications.
+- Work on alarm systems only with owner authorization and qualified personnel. Do not bypass supervision, disable an active alarm, or leave a protected site without a verified restored state.
+- Cable resistance and resistor tolerances are estimates. Measure the installed loop and confirm the panel's published acceptance ranges before changing configuration.

package/bundled-skills/esl-price-sync/SKILL.md

@@ -0,0 +1,210 @@
+---
+name: esl-price-sync
+description: "Synchronizes retail prices between ERP/POS systems and Electronic Shelf Labels (SES-imagotag, ZKONG, Pricer, Hanshow, SOLUM) with delta watermarking, idempotency, and battery modeling. Trigger phrases: esl price sync, electronic shelf labels, zkong sync, ses imagotag price, ghost pricing audit."
+category: architecture
+risk: safe
+source: community
+source_repo: wwewtech/esl-price-sync
+source_type: community
+date_added: "2026-09-22"
+author: wwewtech
+tags: [retail-tech, esl, iot, supply-chain, systems-integration, enterprise-software]
+tools: [claude, cursor, gemini, windsurf]
+license: "MIT"
+---
+
+# ESL Price Sync: Deterministic Retail Shelf-Edge Pricing Architecture
+
+Ensure strict real-time parity between ERP/POS price masters and Electronic Shelf Label (ESL) fleets (SES-imagotag, ZKONG, Pricer, Hanshow, SOLUM) via bounded delta streams, monotonic idempotency tokens, and Sub-GHz RF battery preservation models.
+
+## When to Use This Skill
+
+Activate this skill when:
+- Designing, implementing, or auditing integration pipelines between enterprise retail masters (SAP, Oracle Retail, Dynamics 365, Lightspeed) and ESL server platforms.
+- The user asks: "How do I sync price updates to ESL tags without draining batteries?", "Debug ghost pricing where POS doesn't match the shelf tag", "Design an idempotent delta feed for ZKONG or SES-imagotag", or "Schedule promotional pricing with automatic rollback".
+- Reconciling price discrepancy logs between central ERP databases, ESL middleware, and wireless base station ACK telemetry.
+- Calculating battery life depletion curves for e-paper tags running on CR2450 coin cells under varying refresh frequencies.
+
+Do NOT use this skill when:
+- Managing e-commerce web store frontends or dynamic pricing algorithms (this skill governs faithful delivery of decided prices to physical tags).
+- Troubleshooting individual dead hardware tags before gateway RF coverage and RSSI signal propagation have been verified.
+- Performing live write operations on production store fleets without a preceding read-only audit verification pass.
+
+## Core Mental Models & Non-Negotiable Rules
+
+1. **The 5-Layer ESL Architecture Pipeline**:
+   - Every price synchronization event traverses five distinct operational tiers:
+     $$\mathbf{Price\ Master\ (ERP/POS)} \xrightarrow{\text{Extract}} \mathbf{Transform\ Middleware} \xrightarrow{\text{API/Message}} \mathbf{ESL\ Server} \xrightarrow{\text{Sub-GHz/2.4GHz}} \mathbf{Base\ Station\ (AP)} \xrightarrow{\text{RF\ Packet}} \mathbf{Physical\ Tag}$$
+   - **Traceability Invariant**: Every price payload MUST carry a deterministic `trace_id` recording timestamps and status codes across all five layers. A "200 OK" from the ESL central server API is NEVER treated as proof that the physical shelf display has updated.
+
+2. **Strict Delta Discipline & Cryptographic Watermarking**:
+   - Pushing a full 50,000-SKU store catalog on a scheduled cron is strictly forbidden.
+   - Updates MUST be generated by calculating a cryptographic row hash:
+     $$\text{RowHash} = \text{SHA256}(\text{SKU} + \text{BasePrice} + \text{PromoPrice} + \text{Currency} + \text{UnitOfMeasure} + \text{Barcode} + \text{TemplateID})$$
+   - Only records where $\text{RowHash}_{new} \neq \text{RowHash}_{pushed}$ are queued for transmission.
+   - Full pushes are strictly restricted to initial store commissioning and disaster recovery restores.
+
+3. **Monotonic Idempotency & Out-of-Order Packet Defense**:
+   - High-volume retail message brokers inevitably deliver packets out of order during network re-balancing.
+   - Every transmission packet MUST include an `idempotency_key` and a monotonically increasing `version_timestamp` (ISO 8601 UTC).
+   - If an incoming price payload has $\text{version\_timestamp} \le \text{last\_applied\_version}$, the ESL middleware MUST discard the payload to eliminate race condition reversions.
+
+4. **RF Gateway Rate-Limiting & Battery Longevity Budget**:
+   - Each physical e-paper display refresh costs between $12\ \mu\text{Ah}$ and $25\ \mu\text{Ah}$.
+   - A dual-CR2450 battery pack provides $1,200\text{ mAh}$ nominal capacity ($960\text{ mAh}$ usable considering passivation and low-temperature shelf environments).
+   - **The 3-Update Daily Rule**: Limiting tag updates to $\le 3$ refreshes per day guarantees a $5.5\text{--}7\text{ year}$ operational lifespan.
+   - **Base Station Queue Throttling**: Gateways operate over shared Sub-GHz (868/915 MHz) or proprietary 2.4 GHz RF channels. Batch transmissions must not exceed 150 tag updates per gateway per minute to prevent RF collision retries from draining batteries.
+
+5. **Read-Only Audit Mode by Default**:
+   - Diagnostic and reconciliation tasks MUST execute in read-only audit mode.
+   - Output discrepancy reports containing SKU, ERP Price, Gateway ACK Price, and Divergence Layer.
+   - State-changing write updates require explicit operator consent.
+
+## Named Sins & Anti-Patterns (Что категорически ЗАПРЕЩЕНО)
+
+| Anti-Pattern | Manifestation in Code/Workflow | Mandatory Production Counter-Rule |
+| :--- | :--- | :--- |
+| **Scheduled Full Catalog Floods** | Blasting 60,000 tags every night at midnight. | Stream strict deltas using SHA256 content watermarks. |
+| **Ghost Price Blindness** | Assuming API `200 OK` means the customer sees the new price. | Track gateway ACK packet receipts (`status: ACK_CONFIRMED`). |
+| **Non-Idempotent Retries** | Retrying failed HTTP calls without idempotency keys. | Attach `UUIDv5(sku, store_id, price_timestamp)` to all mutations. |
+| **Timezone Ambiguity** | Pushing promo prices without UTC/local time offsets. | Enforce ISO 8601 UTC timestamps with explicit store local offsets. |
+| **Gateway RF Flooding** | Blasting 5,000 updates/second to a single RF base station. | Enforce leaky-bucket queue throttling ($\le 150\text{ tags/min/AP}$). |
+| **Silent Canvas Overflow** | Pushing a 6-digit price into a 4-digit template field ($1499 becomes $14). | Validate text bounds and template layout dimensions before enqueueing. |
+| **Destructive Rollback Omission** | Deploying flash sales without pre-computing revert state. | Cache previous active state to enable 1-click atomic rollback. |
+| **Orphan Tag Neglect** | Leaving decommissioned tags in the active database. | Reconcile missing heartbeat tags after 72 hours; flag as `ORPHAN`. |
+| **Mid-Day Peak Syncing** | Pushing massive price shifts during peak Saturday shopping hours. | Schedule bulk promotions before store opening or during off-peak hours. |
+| **Unshielded Write Broadcasts** | Executing write scripts without an audit dry-run. | Enforce dry-run simulation mode prior to initiating physical RF broadcasts. |
+
+## Concrete Archetypes / Presets
+
+### Archetype 1: Idempotent Delta Synchronizer (Python 3.10+)
+```python
+import hashlib
+import time
+from typing import Dict, List, Optional
+
+def compute_sku_hash(item: dict) -> str:
+    payload = f"{item['sku']}:{item['price']}:{item['promo_price']}:{item['uom']}:{item['template']}"
+    return hashlib.sha256(payload.encode('utf-8')).hexdigest()
+
+class ESLDeltaSyncPipeline:
+    def __init__(self, watermark_db: dict, max_rate_per_min: int = 150):
+        self.watermark_db = watermark_db  # SKU -> last_pushed_hash
+        self.max_rate_per_min = max_rate_per_min
+        self.last_tx_time = 0.0
+
+    def process_catalog_stream(self, incoming_feed: List[dict], dry_run: bool = True) -> dict:
+        to_push = []
+        unchanged = 0
+
+        for item in incoming_feed:
+            sku = item['sku']
+            current_hash = compute_sku_hash(item)
+            last_hash = self.watermark_db.get(sku)
+
+            if current_hash != last_hash:
+                idempotency_key = hashlib.sha1(f"{sku}:{item['version']}:{current_hash}".encode()).hexdigest()
+                to_push.append({
+                    "sku": sku,
+                    "tag_id": item['tag_id'],
+                    "price_data": item,
+                    "idempotency_key": idempotency_key,
+                    "content_hash": current_hash
+                })
+            else:
+                unchanged += 1
+
+        if dry_run:
+            return {"mode": "DRY_RUN", "queued_for_rf": len(to_push), "unchanged": unchanged}
+
+        # Rate-limited physical transmission
+        sent = 0
+        min_interval = 60.0 / self.max_rate_per_min
+        for job in to_push:
+            now = time.time()
+            elapsed = now - self.last_tx_time
+            if elapsed < min_interval:
+                time.sleep(min_interval - elapsed)
+
+            transmit_to_esl_gateway(job)
+            self.watermark_db[job['sku']] = job['content_hash']
+            self.last_tx_time = time.time()
+            sent += 1
+
+        return {"mode": "LIVE_COMMITTED", "sent_deltas": sent, "unchanged": unchanged}
+```
+
+### Archetype 2: Reconciliation Audit Report Schema
+```json
+{
+  "audit_timestamp": "2026-09-22T10:15:00Z",
+  "store_id": "STORE-0842",
+  "total_audited_skus": 14200,
+  "in_sync": 14188,
+  "ghost_pricing_discrepancies": [
+    {
+      "sku": "SKU-99014",
+      "barcode": "4006381333931",
+      "tag_mac": "00:1A:7D:DA:71:04",
+      "aisle": "Aisle 4 - Cereals",
+      "erp_master_price": 4.99,
+      "esl_server_price": 4.99,
+      "tag_ack_price": 3.99,
+      "divergence_layer": "RF Base Station (Packet dropped due to antenna shadow)",
+      "last_ack_timestamp": "2026-09-20T04:12:00Z",
+      "recommended_action": "Force targeted re-transmit on Channel 11"
+    }
+  ]
+}
+```
+
+### Archetype 3: Battery Longevity Estimation Model
+```python
+def estimate_tag_battery_years(
+    updates_per_day: float,
+    ambient_temp_celsius: float = 21.0,
+    battery_mah: float = 1200.0,
+    uAh_per_refresh: float = 18.0,
+    standby_uA: float = 1.2
+) -> float:
+    # Temperature de-rating factor (freezer sections de-rate capacity significantly)
+    temp_factor = 0.65 if ambient_temp_celsius < 0.0 else (0.85 if ambient_temp_celsius < 10.0 else 1.0)
+    effective_mah = battery_mah * 0.85 * temp_factor  # 85% usable chemistry margin
+
+    daily_drain_uAh = (updates_per_day * uAh_per_refresh) + (standby_uA * 24.0)
+    daily_drain_mAh = daily_drain_uAh / 1000.0
+
+    lifespan_days = effective_mah / daily_drain_mAh
+    return round(lifespan_days / 365.25, 2)
+```
+
+## The Pre-Emit Quality Gate Checklist
+
+Before finalizing any ESL integration, sync workflow, or audit output:
+- [ ] **Delta Discipline**: Confirmed that only changed row hashes are queued; no scheduled full catalog pushes.
+- [ ] **Idempotency Proof**: Monotonic versioning and idempotency keys attached to every modification payload.
+- [ ] **5-Layer Traceability**: Explicit separation between ERP status, server queue, and base station physical tag ACK.
+- [ ] **RF Rate-Limiting**: Gateway transmission queued at $\le 150$ updates/min per AP.
+- [ ] **Battery Budget Checked**: Verified tag refresh schedule does not breach 3 updates/day lifespan limit.
+- [ ] **Layout Safety**: Text width and font truncation verified against display canvas dimensions.
+- [ ] **Dry-Run Audit Default**: Executed read-only reconciliation prior to proposing live write broadcasts.
+
+## Self-Correction & Verification Loop
+
+### Bad (Vibe-Coded AI Slop Output):
+> "To update the electronic labels, run a Python script that loops over all 50,000 products in your database and POSTs them to the ZKONG API every hour. If prices are wrong on the shelves, just run the script again."
+*Problems: Fatal catalog flooding, battery destruction, zero delta tracking, zero idempotency, ignores gateway rate-limiting, blind to physical tag ACK status.*
+
+### Good (Production ESL Price Sync Output):
+> 1. Execute read-only audit comparing ERP pricing against ESL gateway ACK states; identify 12 divergent SKUs.
+> 2. Compute SHA256 delta hashes for all modified SKUs since watermark `2026-09-22T08:00:00Z`.
+> 3. Generate idempotent mutation payloads with `UUIDv5` tokens and monotonic timestamp versioning.
+> 4. Verify tag layout: Confirm that promo prices fit within the 2.9-inch 3-color e-paper template without numeric truncation.
+> 5. Queue rate-limited dispatch at 120 tags/min on Base Station 03, logging transmission to physical tag ACK confirmation.
+
+## Limitations
+
+- ESL APIs, radio limits, acknowledgements, battery figures, and rate limits depend on the vendor, firmware, tag model, and local radio rules. Confirm each value in the deployed system's documentation before use.
+- Start with read-only reconciliation and a small authorized pilot. A server acknowledgement does not prove the physical label displayed the intended value; require tag-level confirmation and a rollback plan before wider writes.
+- Protect retail pricing, product, and device identifiers as business data. Do not transmit credentials or customer data in diagnostic logs or reports.
+- The scripts and payloads in this guide are illustrative and are not vendor-certified integrations.

package/bundled-skills/jev-social/SKILL.md

@@ -11,7 +11,7 @@ author: socai-io
 tags: [social-media, research, instagram, tiktok, linkedin, browser-automation, jev]
 tools: [claude, codex]
 license: "MIT"
-license_source: "https://github.com/socai-io/jev-social/blob/05581cac6b8c21c85e54883b5f2b93c16f40f419/LICENSE"
+license_source: "https://github.com/socai-io/jev-social/blob/782d809c68e2015536359aa7dceede9a3cdbb7f1/LICENSE"
 ---
 # Jev Social
 
@@ -19,7 +19,7 @@ license_source: "https://github.com/socai-io/jev-social/blob/05581cac6b8c21c85e5
 
 Jev Social turns a natural-language social research goal into bounded Jev routing decisions, then delegates platform-read-only browser work to the local socai CLI. Use the captured posts, profiles, comments, videos, and opened details to produce a compact, source-linked report instead of exposing raw CLI output. "Read-only" means no social-account mutation; the CLI still writes private local run records and may download requested media.
 
-The executable examples below are pinned to the tested runtime commit included in Jev Social `v0.1.4`. A pin improves reproducibility but is not a trust guarantee; keep the package, browser data, and returned content inside the safety boundaries below.
+The executable examples below are pinned to the tested runtime commit included in Jev Social `v0.1.5`. A pin improves reproducibility but is not a trust guarantee; keep the package, browser data, and returned content inside the safety boundaries below.
 
 ## When to Use
 - Use when a user requests evidence-backed research on Instagram, TikTok, or LinkedIn and wants real public posts or profiles rather than a general web summary.
@@ -45,7 +45,7 @@ If the exact pinned package is not already available locally, explain that the n
 Run the status command before every research task:
 
 ```bash
-npx github:socai-io/jev-social#05581cac6b8c21c85e54883b5f2b93c16f40f419 status
+npx github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1 status
 ```
 
 Require all of the following before continuing:
@@ -68,7 +68,7 @@ Pass the goal as one argument with an argv-capable process runner; never constru
 ```text
 program: npx
 argv:
-  - github:socai-io/jev-social#05581cac6b8c21c85e54883b5f2b93c16f40f419
+  - github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1
   - search
   - <exact research goal as one argument>
   - --platform
@@ -126,7 +126,7 @@ Use only TikTok if its capability is reported as supported. Open details before
 When the user explicitly asks for the local demo UI, start it on loopback only:
 
 ```bash
-npx github:socai-io/jev-social#05581cac6b8c21c85e54883b5f2b93c16f40f419 serve --port 8766
+npx github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1 serve --port 8766
 ```
 
 Report `http://127.0.0.1:8766`. Leave the process running only when the user asked for a local demo server, and do not expose it on a public interface.