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/mn/__init__.py

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

scripts/formation/states/mn/adapter.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+from playwright.async_api import Page
+
+from scripts.formation.base import StatePortal
+from .config import CONFIG
+
+
+class MNPortal(StatePortal):
+    """Minnesota Secretary of State portal adapter."""
+
+    config = CONFIG
+
+    async def search_name(self, page: Page, name: str) -> dict:
+        """Search the Minnesota business name database.
+
+        Args:
+            page: Playwright page instance.
+            name: Business name to search for.
+
+        Returns:
+            dict with 'available' (bool) and 'results' (list).
+        """
+        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 Minnesota 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 Minnesota 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 = MNPortal()

scripts/formation/states/mn/config.py

@@ -0,0 +1,29 @@
+CONFIG = {
+    "state": "MN",
+    "state_name": "Minnesota",
+    "agency": "SOS",
+    "agency_name": "Secretary of State",
+    "portal_url": "https://sos.state.mn.us",
+    "search_url": "https://mblsportal.sos.state.mn.us/Business/Search",
+    "registered_agent": {
+        "name": "Northwest Registered Agent",
+        "street": "1000 Washington Ave S Ste 200",
+        "city": "Minneapolis",
+        "state": "MN",
+        "zip": "55415",
+    },
+    "fees": {
+        "llc": 155,
+        "corporation": 155,
+    },
+    "notes": "No RA required. No annual fee.",
+    "selectors": {
+        "search_input": "",
+        "search_button": "",
+        "results_table": "",
+        "name_field": "",
+        "agent_name_field": "",
+        "agent_address_field": "",
+        "submit_button": "",
+    },
+}