Initial commit — Performance West telecom compliance platform

Includes: API (Express/TypeScript), Astro site, Python workers,
document generators, FCC compliance tools, Canada CRTC formation,
Ansible infrastructure, and deployment scripts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

scripts/formation/states/il/__init__.py

@@ -0,0 +1,2 @@
+from .adapter import adapter
+from .config import CONFIG

scripts/formation/states/il/adapter.py

@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+from playwright.async_api import Page
+
+from scripts.formation.base import StatePortal
+from .config import CONFIG
+
+
+class ILPortal(StatePortal):
+    """Illinois Secretary of State portal adapter."""
+
+    config = CONFIG
+
+    async def search_name(self, page: Page, name: str) -> dict:
+        """Search the Illinois business name database.
+
+        Uses Socrata open data API (data.illinois.gov) when available,
+        falls back to the SOS web portal.
+
+        Args:
+            page: Playwright page instance.
+            name: Business name to search for.
+
+        Returns:
+            dict with 'available' (bool) and 'results' (list).
+        """
+        search_method = CONFIG.get("search_method", "web")
+
+        if search_method == "socrata":
+            # TODO: implement Socrata API search against data.illinois.gov
+            return {"available": False, "results": [], "status": "not yet implemented"}
+
+        await page.goto(CONFIG["search_url"])
+
+        # TODO: populate selectors during portal inspection
+        search_input = CONFIG["selectors"]["search_input"]
+        search_button = CONFIG["selectors"]["search_button"]
+        results_table = CONFIG["selectors"]["results_table"]
+
+        if search_input:
+            await page.fill(search_input, name)
+        if search_button:
+            await page.click(search_button)
+        if results_table:
+            await page.wait_for_selector(results_table)
+
+        return {"available": False, "results": [], "status": "not yet implemented"}
+
+    async def file_llc(self, page: Page, payload: dict) -> dict:
+        """File an LLC formation with the Illinois SOS.
+
+        Args:
+            page: Playwright page instance.
+            payload: Formation data including name, agent, members.
+
+        Returns:
+            dict with filing confirmation or error details.
+        """
+        await page.goto(CONFIG["portal_url"])
+
+        # TODO: implement actual filing flow during portal inspection
+        return {"filed": False, "status": "not yet implemented"}
+
+    async def file_corporation(self, page: Page, payload: dict) -> dict:
+        """File a Corporation formation with the Illinois SOS.
+
+        Args:
+            page: Playwright page instance.
+            payload: Formation data including name, agent, directors.
+
+        Returns:
+            dict with filing confirmation or error details.
+        """
+        await page.goto(CONFIG["portal_url"])
+
+        # TODO: implement actual filing flow during portal inspection
+        return {"filed": False, "status": "not yet implemented"}
+
+
+adapter = ILPortal()

scripts/formation/states/il/config.py

@@ -0,0 +1,30 @@
+CONFIG = {
+    "state": "IL",
+    "state_name": "Illinois",
+    "agency": "SOS",
+    "agency_name": "Secretary of State",
+    "portal_url": "https://ilsos.gov",
+    "search_url": "https://apps.ilsos.gov/corporatellc/CorporateLlcController",
+    "search_method": "socrata",
+    "socrata_domain": "data.illinois.gov",
+    "registered_agent": {
+        "name": "Northwest Registered Agent",
+        "street": "33 N Dearborn St Ste 1210",
+        "city": "Chicago",
+        "state": "IL",
+        "zip": "60602",
+    },
+    "fees": {
+        "llc": 150,
+        "corporation": 150,
+    },
+    "selectors": {
+        "search_input": "",
+        "search_button": "",
+        "results_table": "",
+        "name_field": "",
+        "agent_name_field": "",
+        "agent_address_field": "",
+        "submit_button": "",
+    },
+}