Developer Documentation Index

This directory is for WifiWand maintainers and developers. These documents contain deep technical details, research, and internal strategy.

Use ../../docs/README.md for end-user and operator documentation.

macOS Helper Development

• macOS Helper Permissions - Documentation of the helper's permission behavior and the "com.wifiwand.helper" bundle identity.
• macOS Code Signing (Context) - Technical context for macOS code signing and notarization.
• macOS Code Signing (Instructions) - Step-by-step instructions for maintainers to sign and notarize a release.

Developer Environment

• Isolated AI Dev VM Setup - Step-by-step guide for building an isolated VM-based development environment with Ansible, suitable for Linux now and Apple Silicon later.
• Testing Guide - Test scopes, real-environment tags, coverage artifact handling, and CI expectations.

Documentation Server

• Documentation Server - Local MkDocs setup, live server usage, strict builds, and troubleshooting.

General Information

• Command Architecture - Detailed explanation of the current command scheme, including command binding, registry dispatch, shell integration, and the WifiWand::Commands::OutputSupport boundary.
• public_ip Command Architecture - Design notes for the dedicated external-IP command and its separation from info.
• connected? vs internet_connectivity_state - Analysis of the semantic split between WiFi connection state and host-level internet reachability, with API cleanup suggestions.

Architecture Changes

• macOS Redacted Network Names Policy - Design note covering the command-semantics problem created by macOS SSID redaction and the proposed default policy for exact-SSID operations.

Internal Reports And Planning

• AI Library Analysis: Claude - One-off analysis of WifiWand as a Ruby library.
• AI Library Analysis: Gemini - Alternate analysis of WifiWand as a Ruby library.

Agent Prompts And Review Notes

• Prompt Library - Reusable prompts and reviewer guidance for internal workflows.