{
  "id": "mba-m1-desk-connections",
  "entityKind": "pack",
  "version": "2.0.0",
  "title": "M1 Air desk connection evidence pack",
  "intent": "Separate display limits, USB accessory power and Wi-Fi reachability before escalating a desk setup fault.",
  "modelId": "mba-m1",
  "deviceFamily": "laptop",
  "modelApplicability": {
    "id": "mba-m1",
    "name": "MacBook Air M1",
    "family": "laptop",
    "revision": "MacBook Air (M1, 2020), Apple M1 chip",
    "os": "macOS Big Sur or later; Ventura and later call the preferences app System Settings. Diagnostic screens vary by macOS.",
    "region": "US-first; local repair provider requirements vary.",
    "help": "Choose Apple menu → About This Mac. Confirm MacBook Air (M1, 2020) and Chip: Apple M1. An Intel processor or another chip does not match.",
    "exclusions": [
      "MacBook Air Intel 2020",
      "MacBook Air M2",
      "MacBook Pro M1"
    ],
    "sourceIds": [
      "mac-id",
      "mac-spec",
      "mac-diagnostics"
    ]
  },
  "exclusions": [
    "MacBook Air Intel 2020",
    "MacBook Air M2",
    "MacBook Pro M1"
  ],
  "category": "preparation",
  "taskIds": [
    "mba-m1-external-display",
    "mba-m1-usb-disabled",
    "mba-m1-wifi-access"
  ],
  "includedTasks": [
    {
      "id": "mba-m1-external-display",
      "modelId": "mba-m1",
      "title": "One native external display on M1 Air",
      "intent": "Separate the M1 display-count limit from a cable, input or detection problem.",
      "category": "connections",
      "sourceIds": [
        "mac-display",
        "mac-spec",
        "mac-safety"
      ],
      "diagramId": "laptop-m1-ports",
      "prerequisites": [
        "Built-in display works",
        "One native external display used for the test"
      ],
      "tools": [
        "Powered monitor with correct input selected",
        "Compatible video-capable cable or adapter"
      ],
      "steps": [
        {
          "id": "limit",
          "text": "The M1 Air supports one native external display, up to 6K at 60 Hz. Record a second native display as outside this task; software-driven display adapters need their own support.",
          "sourceIds": [
            "mac-spec"
          ],
          "locator": "Display Support"
        },
        {
          "id": "path",
          "text": "Keep the lid open. Connect the powered monitor directly, removing the dock from this comparison. Confirm the monitor input and video capability of the cable/adapter.",
          "sourceIds": [
            "mac-display"
          ],
          "locator": "Check cables and connections"
        },
        {
          "id": "detect",
          "text": "Open Displays in System Settings, or System Preferences on older macOS. Hold Option to expose Detect Displays. If the Mac asks to allow your own display, review that request locally.",
          "sourceIds": [
            "mac-display"
          ],
          "locator": "Detect your display / Allow your display to connect"
        },
        {
          "id": "compare",
          "text": "Record whether the monitor is detected separately from whether an image appears. Compare one documented compatible cable while holding monitor, input and display mode constant.",
          "sourceIds": [
            "mac-display"
          ],
          "locator": "Check cables / Find out what your Mac supports; original matrix"
        },
        {
          "id": "retain",
          "text": "If direct video works and the dock path fails, keep that distinction for the dock vendor. A blank image after detection should include the monitor’s input and brightness checks.",
          "sourceIds": [
            "mac-display"
          ],
          "locator": "Check cables / Check display brightness"
        }
      ],
      "checks": [
        {
          "id": "safety",
          "question": "Is there swelling, a lifted case or trackpad, liquid damage, smoke, a burning smell, or damaged power equipment?",
          "goal": "Establish whether any powered comparison is safe.",
          "sourceIds": [
            "mac-safety"
          ],
          "options": [
            {
              "id": "safe",
              "label": "No visible danger",
              "next": "count"
            },
            {
              "id": "danger",
              "label": "Yes, or suspected damage",
              "next": "stop"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "count",
          "question": "Is the trial limited to one native external display?",
          "goal": "Respect the M1 hardware limit.",
          "sourceIds": [
            "mac-spec"
          ],
          "options": [
            {
              "id": "one",
              "label": "One display",
              "next": "path"
            },
            {
              "id": "multiple",
              "label": "Trying more than one native display",
              "next": "limit"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "path",
          "question": "Is the powered display connected directly through a compatible video path?",
          "goal": "Remove the dock and input confounders.",
          "sourceIds": [
            "mac-display"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Direct path confirmed",
              "next": "video"
            },
            {
              "id": "not-ready",
              "label": "Cable/input compatibility not established",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "video",
          "question": "What did the direct connection show?",
          "goal": "Distinguish detection, image and dock behavior.",
          "sourceIds": [
            "mac-display"
          ],
          "options": [
            {
              "id": "working",
              "label": "Usable image directly",
              "next": "ready"
            },
            {
              "id": "detected-dark",
              "label": "Detected, but image remains dark",
              "next": "service"
            },
            {
              "id": "absent",
              "label": "Not detected with available compatible comparison",
              "next": "service"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        }
      ],
      "terminals": {
        "ready": {
          "type": "preparation_saved",
          "title": "Direct display baseline saved",
          "text": "Keep the direct working mode before investigating the dock or a second-display solution.",
          "handoff": [
            "Record direct cable type and selected input.",
            "Give the dock vendor the direct-versus-dock result if that path still fails."
          ]
        },
        "limit": {
          "type": "maintenance_possible",
          "title": "Use a supported comparison",
          "text": "Test one native external monitor on this M1 Air. Additional-display software has separate requirements.",
          "handoff": [
            "Identify whether an additional-display product uses its own software.",
            "Ask its vendor about exact M1/macOS support."
          ]
        },
        "attention": {
          "type": "maintenance_possible",
          "title": "Confirm the video path",
          "text": "A charging-only cable or unverified adapter cannot establish a display fault.",
          "handoff": [
            "Confirm cable/adapter video support in its documentation.",
            "Keep the monitor’s power and selected input in the record."
          ]
        },
        "service": {
          "type": "service_needed",
          "title": "Take detection and image results to support",
          "text": "A direct compatible setup still lacks usable video. Share both sides of the connection with Apple and the monitor vendor.",
          "handoff": [
            "Record detected versus absent, and dark versus usable image.",
            "Bring the exact monitor/cable/adapter details privately."
          ]
        },
        "uncertain": {
          "type": "preparation_saved",
          "title": "Keep the unanswered checks visible",
          "text": "The native display count, cable capability or detection result is not established.",
          "handoff": [
            "Provide native display count and direct connection result.",
            "Separate monitor detection from visible image.",
            "Keep unperformed conditions marked Not tested. Ask the provider to confirm these before further changes."
          ]
        },
        "stop": {
          "type": "service_needed",
          "title": "Stop the powered checks",
          "text": "Stop using or charging damaged equipment. Keep away from hot or smoking equipment; obtain emergency help for an immediate fire risk. Arrange manufacturer guidance before handling or transport.",
          "handoff": [
            "Tell Apple about the visible damage before arranging a MacBook Air service.",
            "Provide native display count and direct connection result.",
            "Do not open the case, remove the battery, press a lifted surface, or continue a test to complete this record."
          ]
        }
      },
      "missing": "The native display count, cable capability or detection result is not established.",
      "handoff": [
        "Provide native display count and direct connection result.",
        "Separate monitor detection from visible image."
      ],
      "outcomeChecks": [
        "One native monitor limit was observed.",
        "Direct and dock paths are kept separate."
      ],
      "workflow": {
        "family": "condition-matrix",
        "summary": "Record detection and image separately for a supported single-display path.",
        "osOptions": [
          "macos26-plus",
          "macos-earlier",
          "macos-unknown"
        ],
        "fields": [
          {
            "id": "display-count",
            "label": "Native external displays",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not checked"
              },
              {
                "value": "one",
                "label": "One"
              },
              {
                "value": "more",
                "label": "More than one"
              }
            ]
          },
          {
            "id": "video-path",
            "label": "Connection being observed",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not checked"
              },
              {
                "value": "direct-usbc",
                "label": "Direct USB-C video"
              },
              {
                "value": "direct-adapter",
                "label": "Direct video adapter"
              },
              {
                "value": "dock",
                "label": "Dock/hub"
              }
            ]
          },
          {
            "id": "detection",
            "label": "Displays settings result",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not checked"
              },
              {
                "value": "detected-image",
                "label": "Detected with image"
              },
              {
                "value": "detected-dark",
                "label": "Detected but dark"
              },
              {
                "value": "absent",
                "label": "Not detected"
              }
            ]
          }
        ],
        "matrix": {
          "title": "Single-display conditions",
          "rows": [
            {
              "id": "direct",
              "label": "Direct monitor",
              "condition": "One powered monitor; verified input; lid open"
            },
            {
              "id": "other-cable",
              "label": "Alternative video cable",
              "condition": "Same monitor/input; one compatible cable change"
            },
            {
              "id": "dock",
              "label": "Dock path",
              "condition": "Only after a direct working baseline, using documented dock support"
            }
          ],
          "results": [
            {
              "value": "not-tested",
              "label": "Not tested"
            },
            {
              "value": "works",
              "label": "Works in this condition"
            },
            {
              "value": "fails",
              "label": "Fails in this condition"
            },
            {
              "value": "intermittent",
              "label": "Intermittent"
            },
            {
              "value": "not-applicable",
              "label": "Not applicable"
            }
          ]
        },
        "reportFocus": [
          "M1 native display limit",
          "Video cable capability",
          "Detection versus image"
        ],
        "notDoneGuidance": [
          "An unavailable compatible video cable remains Not tested.",
          "Do not treat a second native display as a failed Mac port."
        ]
      },
      "entityKind": "task",
      "version": "2.0.0",
      "deviceFamily": "laptop",
      "modelApplicability": {
        "id": "mba-m1",
        "name": "MacBook Air M1",
        "family": "laptop",
        "revision": "MacBook Air (M1, 2020), Apple M1 chip",
        "os": "macOS Big Sur or later; Ventura and later call the preferences app System Settings. Diagnostic screens vary by macOS.",
        "region": "US-first; local repair provider requirements vary.",
        "help": "Choose Apple menu → About This Mac. Confirm MacBook Air (M1, 2020) and Chip: Apple M1. An Intel processor or another chip does not match.",
        "exclusions": [
          "MacBook Air Intel 2020",
          "MacBook Air M2",
          "MacBook Pro M1"
        ],
        "sourceIds": [
          "mac-id",
          "mac-spec",
          "mac-diagnostics"
        ]
      },
      "exclusions": [
        "MacBook Air Intel 2020",
        "MacBook Air M2",
        "MacBook Pro M1"
      ],
      "materials": [
        "Keep any existing backup accessible to you.",
        "Keep credentials and personal files outside this record."
      ],
      "stopConditions": [
        "Stop using and charging equipment with swelling, casing separation, smoke, a burning smell or suspected battery damage. Do not open or press on it.",
        "Set damaged accessories aside. Do not open mains adapters or force connectors.",
        "Do not erase, reset, flash firmware or bypass a lock as a default diagnostic step."
      ],
      "branches": [
        {
          "from": "safety",
          "answer": "safe",
          "to": "count"
        },
        {
          "from": "safety",
          "answer": "danger",
          "to": "stop"
        },
        {
          "from": "safety",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "count",
          "answer": "one",
          "to": "path"
        },
        {
          "from": "count",
          "answer": "multiple",
          "to": "limit"
        },
        {
          "from": "count",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "path",
          "answer": "yes",
          "to": "video"
        },
        {
          "from": "path",
          "answer": "not-ready",
          "to": "attention"
        },
        {
          "from": "path",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "video",
          "answer": "working",
          "to": "ready"
        },
        {
          "from": "video",
          "answer": "detected-dark",
          "to": "service"
        },
        {
          "from": "video",
          "answer": "absent",
          "to": "service"
        },
        {
          "from": "video",
          "answer": "unknown",
          "to": "uncertain"
        }
      ],
      "sources": [
        {
          "id": "mac-display",
          "title": "External display dark or low resolution",
          "url": "https://support.apple.com/en-gb/102501",
          "locator": "Connections / Support limits / Detection / Accessory permission",
          "purpose": "Direct video path, Detect Displays and detection versus image",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-spec",
          "title": "MacBook Air (M1, 2020) technical specifications",
          "url": "https://support.apple.com/en-us/111883",
          "locator": "Charging and Expansion / Display Support",
          "purpose": "Two USB-C Thunderbolt/USB4 ports and one native external display up to 6K at 60 Hz",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-safety",
          "title": "Important safety information for your Mac",
          "url": "https://support.apple.com/guide/macbook-air/important-safety-information-apd9b8f7aa11/mac",
          "locator": "Handling / Built-in battery / Charging",
          "purpose": "General damaged-equipment and moisture safety only; M1-specific connections are sourced from mac-spec",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-id",
          "title": "Identify MacBook Air model",
          "url": "https://support.apple.com/en-ie/102869",
          "locator": "Find model / MacBook Air M1 2020",
          "purpose": "Model and chip confirmation",
          "checkedAt": "2026-10-04",
          "reuse": "Reference only. Original paraphrase; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-diagnostics",
          "title": "Use Apple Diagnostics to test your Mac",
          "url": "https://support.apple.com/en-gb/102550",
          "locator": "Prepare / Apple silicon / Run Apple Diagnostics / Results",
          "purpose": "M1 Options then Command-D; Tahoe 26+ selected tests versus earlier automatic testing; preserve reference code",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        }
      ],
      "assets": [
        {
          "id": "laptop-m1-ports",
          "path": "/assets/laptop-m1-ports.svg",
          "title": "M1 Air connection map",
          "alt": "Original schematic showing two left USB-C ports, right headphone jack and a direct one-display comparison.",
          "sourceIds": [
            "mac-spec",
            "mac-display"
          ],
          "caption": "Original schematic, not to scale. MacBook Air M1 (2020); one native external display. Inspect the real connector before use.",
          "kind": "Original schematic"
        }
      ],
      "relatedIds": [
        "mba-m1-wifi-access",
        "mba-m1-keyboard-input",
        "mba-m1-speaker-output"
      ],
      "estimatedDuration": {
        "minutes": 20,
        "label": "Planning estimate for recording observations; excludes charging, backups, drying and service. Not a measured repair time."
      },
      "legacyVersion": "1.0.0",
      "legacyChecks": [
        {
          "id": "safety",
          "goal": "Separate unsafe hardware from routine preparation.",
          "question": "Any swelling, casing separation, liquid damage, smoke, burning smell, or damaged battery/adapter?",
          "sourceIds": [
            "mac-charge"
          ],
          "options": [
            {
              "id": "safe",
              "label": "No visible danger",
              "next": "check-1"
            },
            {
              "id": "danger",
              "label": "Yes, or suspected damage",
              "next": "stop"
            },
            {
              "id": "unknown",
              "label": "I cannot confirm",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "check-1",
          "goal": "Stay within the model’s stated support.",
          "question": "Is only one native external display connected with a video-capable direct path?",
          "sourceIds": [
            "mac-display",
            "mac-spec"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Yes",
              "next": "check-2"
            },
            {
              "id": "no",
              "label": "No",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "check-2",
          "goal": "Record a visible output.",
          "question": "Does the display show video after input and detection checks?",
          "sourceIds": [
            "mac-display",
            "mac-spec"
          ],
          "options": [
            {
              "id": "yes",
              "label": "External video appears",
              "next": "ready"
            },
            {
              "id": "no",
              "label": "External display stays dark",
              "next": "service"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        }
      ],
      "legacyPreparation": [
        "Built-in display works",
        "One native external display is used for this comparison",
        "Powered external display",
        "Video-capable compatible cable or adapter",
        "A private place to keep your findings",
        "A current backup if the device is accessible"
      ]
    },
    {
      "id": "mba-m1-usb-disabled",
      "modelId": "mba-m1",
      "title": "USB Devices Disabled: accessory and hub isolation",
      "intent": "Determine whether the warning follows an accessory, a port or a hub power arrangement.",
      "category": "connections",
      "sourceIds": [
        "mac-usb",
        "mac-spec",
        "mac-safety"
      ],
      "diagramId": "laptop-m1-ports",
      "prerequisites": [
        "Only owned, trusted USB equipment is involved",
        "Any accessible external storage is safely ejected before disconnection"
      ],
      "tools": [
        "Affected accessory",
        "Hub’s documented power supply if it is self-powered"
      ],
      "steps": [
        {
          "id": "inventory",
          "text": "Record whether the warning involves storage, an input device or another peripheral, and whether it was direct or through a hub. Stop transfers before changing the connection.",
          "sourceIds": [
            "mac-usb"
          ],
          "locator": "Opening: external devices and power messages; original worksheet"
        },
        {
          "id": "reconnect",
          "text": "Safely disconnect and reconnect the accessory. If it is storage and cannot be ejected safely, pause and ask for support instead of unplugging during activity.",
          "sourceIds": [
            "mac-usb"
          ],
          "locator": "Troubleshooting → disconnect and reconnect; conservative data-preservation limit"
        },
        {
          "id": "direct",
          "text": "Compare the accessory directly on the Mac, using only its documented adapter if required. Keep other nonessential USB accessories disconnected for a clear result.",
          "sourceIds": [
            "mac-usb"
          ],
          "locator": "Troubleshooting → connect directly instead of hub"
        },
        {
          "id": "port",
          "text": "Compare the same direct accessory on the other USB-C port without changing its cable. If no compatible direct path is available, leave this row Not tested.",
          "sourceIds": [
            "mac-usb",
            "mac-spec"
          ],
          "locator": "Troubleshooting → different port; Charging and Expansion"
        },
        {
          "id": "hub",
          "text": "For a self-powered hub, verify its specified AC supply is connected. Compare the powered hub path only after recording the direct result; persistent warnings go to Apple or the accessory vendor.",
          "sourceIds": [
            "mac-usb"
          ],
          "locator": "Troubleshooting → self-powered hub / contact Apple"
        }
      ],
      "checks": [
        {
          "id": "safety",
          "question": "Is there swelling, a lifted case or trackpad, liquid damage, smoke, a burning smell, or damaged power equipment?",
          "goal": "Establish whether any powered comparison is safe.",
          "sourceIds": [
            "mac-safety"
          ],
          "options": [
            {
              "id": "safe",
              "label": "No visible danger",
              "next": "disconnect"
            },
            {
              "id": "danger",
              "label": "Yes, or suspected damage",
              "next": "stop"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "disconnect",
          "question": "Can the accessory be disconnected safely, with storage transfers stopped?",
          "goal": "Protect data before changing connections.",
          "sourceIds": [
            "mac-usb"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Ready for a safe comparison",
              "next": "direct"
            },
            {
              "id": "no",
              "label": "Storage busy or safe removal uncertain",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "direct",
          "question": "Does the same accessory work directly on the Mac?",
          "goal": "Separate hub behavior.",
          "sourceIds": [
            "mac-usb"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Works directly",
              "next": "hub"
            },
            {
              "id": "no",
              "label": "Direct warning/failure on available ports",
              "next": "service"
            },
            {
              "id": "unavailable",
              "label": "No compatible direct path",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "hub",
          "question": "What is the hub comparison?",
          "goal": "Identify the next accessory support question.",
          "sourceIds": [
            "mac-usb"
          ],
          "options": [
            {
              "id": "works",
              "label": "Works with documented hub power",
              "next": "ready"
            },
            {
              "id": "fails",
              "label": "Direct works; hub still fails",
              "next": "hub-help"
            },
            {
              "id": "none",
              "label": "No hub is involved",
              "next": "ready"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        }
      ],
      "terminals": {
        "ready": {
          "type": "preparation_saved",
          "title": "USB connection condition saved",
          "text": "Keep the path and power arrangement that worked.",
          "handoff": [
            "Record direct-port results and hub power state.",
            "Repeat only if the warning returns under the same safe conditions."
          ]
        },
        "hub-help": {
          "type": "maintenance_possible",
          "title": "Take the hub result to its vendor",
          "text": "The accessory worked directly but the documented hub path did not.",
          "handoff": [
            "Provide hub model and its power supply details privately.",
            "Include the direct baseline and remaining hub warning."
          ]
        },
        "service": {
          "type": "service_needed",
          "title": "Request a USB accessory review",
          "text": "The available direct comparisons still fail. This result cannot identify a replaceable Mac port.",
          "handoff": [
            "Bring accessory, cable and direct-port results to Apple or its vendor.",
            "Flag storage involvement and any unverified backup before repair."
          ]
        },
        "attention": {
          "type": "maintenance_possible",
          "title": "Preserve the missing comparison",
          "text": "Safe removal or a compatible direct connection is not available.",
          "handoff": [
            "Finish file activity and verify a safe removal path first.",
            "Ask the accessory vendor to confirm the supported direct adapter."
          ]
        },
        "uncertain": {
          "type": "preparation_saved",
          "title": "Keep the unanswered checks visible",
          "text": "The direct path, safe-removal state or hub power requirement is still unknown.",
          "handoff": [
            "Identify accessory category and original direct/hub path.",
            "Provide the safe-removal limitation and tested ports without device contents.",
            "Keep unperformed conditions marked Not tested. Ask the provider to confirm these before further changes."
          ]
        },
        "stop": {
          "type": "service_needed",
          "title": "Stop the powered checks",
          "text": "Stop using or charging damaged equipment. Keep away from hot or smoking equipment; obtain emergency help for an immediate fire risk. Arrange manufacturer guidance before handling or transport.",
          "handoff": [
            "Tell Apple about the visible damage before arranging a MacBook Air service.",
            "Identify accessory category and original direct/hub path.",
            "Do not open the case, remove the battery, press a lifted surface, or continue a test to complete this record."
          ]
        }
      },
      "missing": "The direct path, safe-removal state or hub power requirement is still unknown.",
      "handoff": [
        "Identify accessory category and original direct/hub path.",
        "Provide the safe-removal limitation and tested ports without device contents."
      ],
      "outcomeChecks": [
        "Hub power and direct-port results are separate.",
        "Storage was not disconnected during transfers."
      ],
      "workflow": {
        "family": "power-comparison",
        "summary": "Trace the same accessory through direct ports and its documented powered hub.",
        "osOptions": [
          "macos26-plus",
          "macos-earlier",
          "macos-unknown"
        ],
        "fields": [
          {
            "id": "usb-kind",
            "label": "Accessory category",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not identified"
              },
              {
                "value": "storage",
                "label": "External storage"
              },
              {
                "value": "input",
                "label": "Keyboard/mouse"
              },
              {
                "value": "camera-audio",
                "label": "Camera/audio"
              },
              {
                "value": "other",
                "label": "Another trusted peripheral"
              }
            ]
          },
          {
            "id": "hub-power",
            "label": "Hub power arrangement",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Unknown"
              },
              {
                "value": "no-hub",
                "label": "No hub"
              },
              {
                "value": "bus",
                "label": "Bus-powered hub"
              },
              {
                "value": "self-powered",
                "label": "Self-powered with specified supply"
              }
            ]
          },
          {
            "id": "warning-scope",
            "label": "Warning follows",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not established"
              },
              {
                "value": "hub-only",
                "label": "Hub path only"
              },
              {
                "value": "one-port",
                "label": "One direct port"
              },
              {
                "value": "both-ports",
                "label": "Both direct ports"
              },
              {
                "value": "cleared",
                "label": "No warning now"
              }
            ]
          }
        ],
        "matrix": {
          "title": "Same accessory, different path",
          "rows": [
            {
              "id": "direct-a",
              "label": "First direct USB-C port",
              "condition": "Same accessory/cable, no hub"
            },
            {
              "id": "direct-b",
              "label": "Other direct USB-C port",
              "condition": "Same accessory/cable, no hub"
            },
            {
              "id": "powered-hub",
              "label": "Documented powered hub",
              "condition": "Same accessory with hub’s specified supply connected"
            }
          ],
          "results": [
            {
              "value": "not-tested",
              "label": "Not tested"
            },
            {
              "value": "works",
              "label": "Works in this condition"
            },
            {
              "value": "fails",
              "label": "Fails in this condition"
            },
            {
              "value": "intermittent",
              "label": "Intermittent"
            },
            {
              "value": "not-applicable",
              "label": "Not applicable"
            }
          ]
        },
        "reportFocus": [
          "Accessory category",
          "Direct versus hub result",
          "Port comparison and storage limits"
        ],
        "notDoneGuidance": [
          "Do not force a plug or test an undocumented power supply.",
          "If safe storage removal is unavailable, keep further rows Not tested."
        ]
      },
      "entityKind": "task",
      "version": "2.0.0",
      "deviceFamily": "laptop",
      "modelApplicability": {
        "id": "mba-m1",
        "name": "MacBook Air M1",
        "family": "laptop",
        "revision": "MacBook Air (M1, 2020), Apple M1 chip",
        "os": "macOS Big Sur or later; Ventura and later call the preferences app System Settings. Diagnostic screens vary by macOS.",
        "region": "US-first; local repair provider requirements vary.",
        "help": "Choose Apple menu → About This Mac. Confirm MacBook Air (M1, 2020) and Chip: Apple M1. An Intel processor or another chip does not match.",
        "exclusions": [
          "MacBook Air Intel 2020",
          "MacBook Air M2",
          "MacBook Pro M1"
        ],
        "sourceIds": [
          "mac-id",
          "mac-spec",
          "mac-diagnostics"
        ]
      },
      "exclusions": [
        "MacBook Air Intel 2020",
        "MacBook Air M2",
        "MacBook Pro M1"
      ],
      "materials": [
        "Keep any existing backup accessible to you.",
        "Keep credentials and personal files outside this record."
      ],
      "stopConditions": [
        "Stop using and charging equipment with swelling, casing separation, smoke, a burning smell or suspected battery damage. Do not open or press on it.",
        "Set damaged accessories aside. Do not open mains adapters or force connectors.",
        "Do not erase, reset, flash firmware or bypass a lock as a default diagnostic step."
      ],
      "branches": [
        {
          "from": "safety",
          "answer": "safe",
          "to": "disconnect"
        },
        {
          "from": "safety",
          "answer": "danger",
          "to": "stop"
        },
        {
          "from": "safety",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "disconnect",
          "answer": "yes",
          "to": "direct"
        },
        {
          "from": "disconnect",
          "answer": "no",
          "to": "attention"
        },
        {
          "from": "disconnect",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "direct",
          "answer": "yes",
          "to": "hub"
        },
        {
          "from": "direct",
          "answer": "no",
          "to": "service"
        },
        {
          "from": "direct",
          "answer": "unavailable",
          "to": "attention"
        },
        {
          "from": "direct",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "hub",
          "answer": "works",
          "to": "ready"
        },
        {
          "from": "hub",
          "answer": "fails",
          "to": "hub-help"
        },
        {
          "from": "hub",
          "answer": "none",
          "to": "ready"
        },
        {
          "from": "hub",
          "answer": "unknown",
          "to": "uncertain"
        }
      ],
      "sources": [
        {
          "id": "mac-usb",
          "title": "USB Devices Disabled on Mac",
          "url": "https://support.apple.com/en-us/102204",
          "locator": "Troubleshooting list",
          "purpose": "Other port, direct accessory and documented self-powered hub supply",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-spec",
          "title": "MacBook Air (M1, 2020) technical specifications",
          "url": "https://support.apple.com/en-us/111883",
          "locator": "Charging and Expansion / Display Support",
          "purpose": "Two USB-C Thunderbolt/USB4 ports and one native external display up to 6K at 60 Hz",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-safety",
          "title": "Important safety information for your Mac",
          "url": "https://support.apple.com/guide/macbook-air/important-safety-information-apd9b8f7aa11/mac",
          "locator": "Handling / Built-in battery / Charging",
          "purpose": "General damaged-equipment and moisture safety only; M1-specific connections are sourced from mac-spec",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-id",
          "title": "Identify MacBook Air model",
          "url": "https://support.apple.com/en-ie/102869",
          "locator": "Find model / MacBook Air M1 2020",
          "purpose": "Model and chip confirmation",
          "checkedAt": "2026-10-04",
          "reuse": "Reference only. Original paraphrase; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-diagnostics",
          "title": "Use Apple Diagnostics to test your Mac",
          "url": "https://support.apple.com/en-gb/102550",
          "locator": "Prepare / Apple silicon / Run Apple Diagnostics / Results",
          "purpose": "M1 Options then Command-D; Tahoe 26+ selected tests versus earlier automatic testing; preserve reference code",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-display",
          "title": "External display dark or low resolution",
          "url": "https://support.apple.com/en-gb/102501",
          "locator": "Connections / Support limits / Detection / Accessory permission",
          "purpose": "Direct video path, Detect Displays and detection versus image",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        }
      ],
      "assets": [
        {
          "id": "laptop-m1-ports",
          "path": "/assets/laptop-m1-ports.svg",
          "title": "M1 Air connection map",
          "alt": "Original schematic showing two left USB-C ports, right headphone jack and a direct one-display comparison.",
          "sourceIds": [
            "mac-spec",
            "mac-display"
          ],
          "caption": "Original schematic, not to scale. MacBook Air M1 (2020); one native external display. Inspect the real connector before use.",
          "kind": "Original schematic"
        }
      ],
      "relatedIds": [
        "mba-m1-usbc-charge",
        "mba-m1-diagnostics",
        "mba-m1-safe-mode"
      ],
      "estimatedDuration": {
        "minutes": 20,
        "label": "Planning estimate for recording observations; excludes charging, backups, drying and service. Not a measured repair time."
      },
      "legacyVersion": "1.0.0",
      "legacyChecks": [
        {
          "id": "safety",
          "goal": "Separate unsafe hardware from routine preparation.",
          "question": "Any swelling, casing separation, liquid damage, smoke, burning smell, or damaged battery/adapter?",
          "sourceIds": [
            "mac-charge"
          ],
          "options": [
            {
              "id": "safe",
              "label": "No visible danger",
              "next": "check-1"
            },
            {
              "id": "danger",
              "label": "Yes, or suspected damage",
              "next": "stop"
            },
            {
              "id": "unknown",
              "label": "I cannot confirm",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "check-1",
          "goal": "Isolate hub power and connection.",
          "question": "Have you compared one device directly rather than through an unpowered hub?",
          "sourceIds": [
            "mac-usb"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Yes",
              "next": "check-2"
            },
            {
              "id": "no",
              "label": "No",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "check-2",
          "goal": "Observe recognition.",
          "question": "Is the accessory recognized without the disabled-device alert?",
          "sourceIds": [
            "mac-usb"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Recognized normally",
              "next": "ready"
            },
            {
              "id": "no",
              "label": "Alert or failure remains",
              "next": "service"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        }
      ],
      "legacyPreparation": [
        "Only owned trusted accessories are used",
        "Storage devices are safely ejected before disconnecting",
        "Affected USB accessory",
        "Its required power supply, if self-powered",
        "A private place to keep your findings",
        "A current backup if the device is accessible"
      ]
    },
    {
      "id": "mba-m1-wifi-access",
      "modelId": "mba-m1",
      "title": "Wi-Fi association versus internet access",
      "intent": "Separate joining a network, reaching the internet and a network-specific failure.",
      "category": "connections",
      "sourceIds": [
        "mac-wifi",
        "mac-safety"
      ],
      "diagramId": "laptop-mac-settings",
      "prerequisites": [
        "Permission to use each comparison network",
        "Managed VPN/security settings will remain under IT control"
      ],
      "tools": [
        "Another permitted device or trusted network if available"
      ],
      "steps": [
        {
          "id": "join",
          "text": "Check whether the Mac joined Wi-Fi before testing internet access. Keep the network name and password outside this record; record only whether association succeeded.",
          "sourceIds": [
            "mac-wifi"
          ],
          "locator": "Check the Wi-Fi connection"
        },
        {
          "id": "access",
          "text": "On the joined network, compare a familiar website with another known online service. Record whether the problem affects internet access broadly or just one service.",
          "sourceIds": [
            "mac-wifi"
          ],
          "locator": "Opening description: websites, email and internet services; original service comparison"
        },
        {
          "id": "cross",
          "text": "If permitted, compare another device on the same network and the Mac on a different trusted network. Keep VPN/security policy unchanged and label unavailable comparisons Not tested.",
          "sourceIds": [
            "mac-wifi"
          ],
          "locator": "Try a different network or contact your ISP / Check VPN"
        },
        {
          "id": "tools",
          "text": "Confirm the Mac’s date and time. If useful, hold Option while opening Wi-Fi and choose Open Wireless Diagnostics; keep its detailed report private.",
          "sourceIds": [
            "mac-wifi"
          ],
          "locator": "Check date and time / Use the built-in diagnostic tools"
        },
        {
          "id": "route",
          "text": "A failure shared across devices goes to the network administrator or ISP. A Mac-only result across trusted networks goes to Apple/IT with the network comparison and diagnostic availability.",
          "sourceIds": [
            "mac-wifi"
          ],
          "locator": "Try a different network or contact your ISP"
        }
      ],
      "checks": [
        {
          "id": "safety",
          "question": "Is there swelling, a lifted case or trackpad, liquid damage, smoke, a burning smell, or damaged power equipment?",
          "goal": "Establish whether any powered comparison is safe.",
          "sourceIds": [
            "mac-safety"
          ],
          "options": [
            {
              "id": "safe",
              "label": "No visible danger",
              "next": "association"
            },
            {
              "id": "danger",
              "label": "Yes, or suspected damage",
              "next": "stop"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "association",
          "question": "Is the Mac joined to the intended permitted Wi-Fi network?",
          "goal": "Separate association from internet reachability.",
          "sourceIds": [
            "mac-wifi"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Joined",
              "next": "internet"
            },
            {
              "id": "no",
              "label": "Cannot join",
              "next": "service"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "internet",
          "question": "Does internet access work beyond one app or website?",
          "goal": "Locate the observed scope.",
          "sourceIds": [
            "mac-wifi"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Other services work",
              "next": "ready"
            },
            {
              "id": "no",
              "label": "Several services fail",
              "next": "cross-device"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "cross-device",
          "question": "What did the network comparison show?",
          "goal": "Choose the appropriate support owner.",
          "sourceIds": [
            "mac-wifi"
          ],
          "options": [
            {
              "id": "network",
              "label": "Other device fails here / Mac works elsewhere",
              "next": "network"
            },
            {
              "id": "mac",
              "label": "Other device works; Mac fails on two networks",
              "next": "service"
            },
            {
              "id": "missing",
              "label": "No permitted comparison available",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        }
      ],
      "terminals": {
        "ready": {
          "type": "preparation_saved",
          "title": "Service-specific lead recorded",
          "text": "A working internet comparison points the next investigation toward the failing service or app.",
          "handoff": [
            "Retain Wi-Fi association and which service category worked.",
            "Take the failing app result to its provider without sharing network credentials."
          ]
        },
        "network": {
          "type": "maintenance_possible",
          "title": "Contact the network owner",
          "text": "The observed failure follows this network rather than only this Mac.",
          "handoff": [
            "Share the same-network comparison with the administrator or ISP.",
            "Keep managed VPN and router changes under their control."
          ]
        },
        "service": {
          "type": "service_needed",
          "title": "Share the Mac connection evidence",
          "text": "Apple or IT needs the association and cross-network results before a hardware conclusion.",
          "handoff": [
            "Report whether joining failed or only internet access failed.",
            "Offer Wireless Diagnostics privately if requested."
          ]
        },
        "attention": {
          "type": "maintenance_possible",
          "title": "Keep the missing network comparison",
          "text": "A second trusted network or device was unavailable. One failure cannot locate the cause.",
          "handoff": [
            "Record whether VPN/security software is managed.",
            "Ask the administrator for a permitted comparison path."
          ]
        },
        "uncertain": {
          "type": "preparation_saved",
          "title": "Keep the unanswered checks visible",
          "text": "Network association or the comparison result is unconfirmed. Retain the exact stage that was unavailable.",
          "handoff": [
            "Provide association versus internet status.",
            "Share same-network and alternate-network results without passwords or network names.",
            "Keep unperformed conditions marked Not tested. Ask the provider to confirm these before further changes."
          ]
        },
        "stop": {
          "type": "service_needed",
          "title": "Stop the powered checks",
          "text": "Stop using or charging damaged equipment. Keep away from hot or smoking equipment; obtain emergency help for an immediate fire risk. Arrange manufacturer guidance before handling or transport.",
          "handoff": [
            "Tell Apple about the visible damage before arranging a MacBook Air service.",
            "Provide association versus internet status.",
            "Do not open the case, remove the battery, press a lifted surface, or continue a test to complete this record."
          ]
        }
      },
      "missing": "Network association or the comparison result is unconfirmed. Retain the exact stage that was unavailable.",
      "handoff": [
        "Provide association versus internet status.",
        "Share same-network and alternate-network results without passwords or network names."
      ],
      "outcomeChecks": [
        "Joining and internet access are separate observations.",
        "The next contact matches the network comparison."
      ],
      "workflow": {
        "family": "condition-matrix",
        "summary": "Compare access scope without collecting network credentials.",
        "osOptions": [
          "macos26-plus",
          "macos-earlier",
          "macos-unknown"
        ],
        "fields": [
          {
            "id": "association",
            "label": "Wi-Fi association",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not checked"
              },
              {
                "value": "joined",
                "label": "Joined"
              },
              {
                "value": "not-joined",
                "label": "Could not join"
              }
            ]
          },
          {
            "id": "access-scope",
            "label": "Internet symptom",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Not checked"
              },
              {
                "value": "one-service",
                "label": "One app/site"
              },
              {
                "value": "many-services",
                "label": "Several internet services"
              },
              {
                "value": "working",
                "label": "Access works"
              }
            ]
          },
          {
            "id": "network-control",
            "label": "Network/VPN management",
            "type": "select",
            "options": [
              {
                "value": "unknown",
                "label": "Unknown"
              },
              {
                "value": "personal",
                "label": "Personally managed"
              },
              {
                "value": "organization",
                "label": "Organization managed"
              },
              {
                "value": "guest",
                "label": "Guest network"
              }
            ]
          }
        ],
        "matrix": {
          "title": "Network conditions",
          "rows": [
            {
              "id": "mac-current",
              "label": "Mac on current network",
              "condition": "Joined Wi-Fi; same ordinary internet action"
            },
            {
              "id": "other-device",
              "label": "Another device here",
              "condition": "Permitted device; same network and action"
            },
            {
              "id": "mac-alternate",
              "label": "Mac on another network",
              "condition": "Trusted permitted network; same action and VPN policy"
            }
          ],
          "results": [
            {
              "value": "not-tested",
              "label": "Not tested"
            },
            {
              "value": "works",
              "label": "Works in this condition"
            },
            {
              "value": "fails",
              "label": "Fails in this condition"
            },
            {
              "value": "intermittent",
              "label": "Intermittent"
            },
            {
              "value": "not-applicable",
              "label": "Not applicable"
            }
          ]
        },
        "reportFocus": [
          "Association state",
          "Internet service scope",
          "Network-specific versus device-specific evidence"
        ],
        "notDoneGuidance": [
          "Do not record SSIDs, passwords or diagnostic archives here.",
          "If network policy forbids the comparison, leave it Not tested."
        ]
      },
      "entityKind": "task",
      "version": "2.0.0",
      "deviceFamily": "laptop",
      "modelApplicability": {
        "id": "mba-m1",
        "name": "MacBook Air M1",
        "family": "laptop",
        "revision": "MacBook Air (M1, 2020), Apple M1 chip",
        "os": "macOS Big Sur or later; Ventura and later call the preferences app System Settings. Diagnostic screens vary by macOS.",
        "region": "US-first; local repair provider requirements vary.",
        "help": "Choose Apple menu → About This Mac. Confirm MacBook Air (M1, 2020) and Chip: Apple M1. An Intel processor or another chip does not match.",
        "exclusions": [
          "MacBook Air Intel 2020",
          "MacBook Air M2",
          "MacBook Pro M1"
        ],
        "sourceIds": [
          "mac-id",
          "mac-spec",
          "mac-diagnostics"
        ]
      },
      "exclusions": [
        "MacBook Air Intel 2020",
        "MacBook Air M2",
        "MacBook Pro M1"
      ],
      "materials": [
        "Keep any existing backup accessible to you.",
        "Keep credentials and personal files outside this record."
      ],
      "stopConditions": [
        "Stop using and charging equipment with swelling, casing separation, smoke, a burning smell or suspected battery damage. Do not open or press on it.",
        "Set damaged accessories aside. Do not open mains adapters or force connectors.",
        "Do not erase, reset, flash firmware or bypass a lock as a default diagnostic step."
      ],
      "branches": [
        {
          "from": "safety",
          "answer": "safe",
          "to": "association"
        },
        {
          "from": "safety",
          "answer": "danger",
          "to": "stop"
        },
        {
          "from": "safety",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "association",
          "answer": "yes",
          "to": "internet"
        },
        {
          "from": "association",
          "answer": "no",
          "to": "service"
        },
        {
          "from": "association",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "internet",
          "answer": "yes",
          "to": "ready"
        },
        {
          "from": "internet",
          "answer": "no",
          "to": "cross-device"
        },
        {
          "from": "internet",
          "answer": "unknown",
          "to": "uncertain"
        },
        {
          "from": "cross-device",
          "answer": "network",
          "to": "network"
        },
        {
          "from": "cross-device",
          "answer": "mac",
          "to": "service"
        },
        {
          "from": "cross-device",
          "answer": "missing",
          "to": "attention"
        },
        {
          "from": "cross-device",
          "answer": "unknown",
          "to": "uncertain"
        }
      ],
      "sources": [
        {
          "id": "mac-wifi",
          "title": "Mac cannot connect to the internet over Wi-Fi",
          "url": "https://support.apple.com/en-ie/101588",
          "locator": "Connection / Date and time / Diagnostics / Different network",
          "purpose": "Association versus internet, permitted network comparison and Wireless Diagnostics",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-safety",
          "title": "Important safety information for your Mac",
          "url": "https://support.apple.com/guide/macbook-air/important-safety-information-apd9b8f7aa11/mac",
          "locator": "Handling / Built-in battery / Charging",
          "purpose": "General damaged-equipment and moisture safety only; M1-specific connections are sourced from mac-spec",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-id",
          "title": "Identify MacBook Air model",
          "url": "https://support.apple.com/en-ie/102869",
          "locator": "Find model / MacBook Air M1 2020",
          "purpose": "Model and chip confirmation",
          "checkedAt": "2026-10-04",
          "reuse": "Reference only. Original paraphrase; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-spec",
          "title": "MacBook Air (M1, 2020) technical specifications",
          "url": "https://support.apple.com/en-us/111883",
          "locator": "Charging and Expansion / Display Support",
          "purpose": "Two USB-C Thunderbolt/USB4 ports and one native external display up to 6K at 60 Hz",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-diagnostics",
          "title": "Use Apple Diagnostics to test your Mac",
          "url": "https://support.apple.com/en-gb/102550",
          "locator": "Prepare / Apple silicon / Run Apple Diagnostics / Results",
          "purpose": "M1 Options then Command-D; Tahoe 26+ selected tests versus earlier automatic testing; preserve reference code",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-sound",
          "title": "No sound from Mac speakers",
          "url": "https://support.apple.com/en-nz/guide/mac-help/mchlp1439/mac",
          "locator": "Opening / Built-in speakers / External outputs",
          "purpose": "App volume, local source and selected built-in output",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-keyboard",
          "title": "Mac does not respond to key presses",
          "url": "https://support.apple.com/en-sa/guide/mac-help/mchlp1240/mac",
          "locator": "Built-in keyboard / Other keys",
          "purpose": "Low battery, Slow Keys, Mouse Keys and input layout",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        },
        {
          "id": "mac-sleep",
          "title": "Mac sleeps or wakes unexpectedly",
          "url": "https://support.apple.com/en-gb/guide/mac-help/-mchlp2995/mac",
          "locator": "Check sleep settings / Network access / Sharing / Activity / Something else is waking your Mac",
          "purpose": "Sleep/wake settings, background activity and peripheral comparison",
          "checkedAt": "2026-10-13",
          "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
          "licenseStatus": "Public support document; no redistribution license assumed."
        }
      ],
      "assets": [
        {
          "id": "laptop-mac-settings",
          "path": "/assets/laptop-mac-settings.svg",
          "title": "Mac settings and observation map",
          "alt": "Original schematic locating Sound Output, Accessibility Keyboard and Pointer Control, and sleep-related settings; older macOS labels differ.",
          "sourceIds": [
            "mac-sound",
            "mac-keyboard",
            "mac-sleep"
          ],
          "caption": "Original schematic of setting relationships. Use the guide version matching installed macOS; this is not a screenshot.",
          "kind": "Original schematic"
        }
      ],
      "relatedIds": [
        "mba-m1-external-display",
        "mba-m1-keyboard-input",
        "mba-m1-speaker-output"
      ],
      "estimatedDuration": {
        "minutes": 20,
        "label": "Planning estimate for recording observations; excludes charging, backups, drying and service. Not a measured repair time."
      },
      "legacyVersion": "1.0.0",
      "legacyChecks": [
        {
          "id": "safety",
          "goal": "Separate unsafe hardware from routine preparation.",
          "question": "Any swelling, casing separation, liquid damage, smoke, burning smell, or damaged battery/adapter?",
          "sourceIds": [
            "mac-charge"
          ],
          "options": [
            {
              "id": "safe",
              "label": "No visible danger",
              "next": "check-1"
            },
            {
              "id": "danger",
              "label": "Yes, or suspected damage",
              "next": "stop"
            },
            {
              "id": "unknown",
              "label": "I cannot confirm",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "check-1",
          "goal": "Separate network outage from this Mac.",
          "question": "Can another device access the internet on the same network?",
          "sourceIds": [
            "mac-wifi"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Yes",
              "next": "check-2"
            },
            {
              "id": "no",
              "label": "No",
              "next": "attention"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        },
        {
          "id": "check-2",
          "goal": "Identify a network-specific lead.",
          "question": "Does the Mac access the internet on another trusted network?",
          "sourceIds": [
            "mac-wifi"
          ],
          "options": [
            {
              "id": "yes",
              "label": "Works on another network",
              "next": "ready"
            },
            {
              "id": "no",
              "label": "Fails on both",
              "next": "service"
            },
            {
              "id": "unknown",
              "label": "Not checked / unsure",
              "next": "uncertain"
            }
          ]
        }
      ],
      "legacyPreparation": [
        "You may use the selected networks",
        "No managed-network settings will be changed without IT",
        "Another device or another trusted network for comparison",
        "A private place to keep your findings",
        "A current backup if the device is accessible"
      ]
    }
  ],
  "stages": [
    {
      "id": "map",
      "title": "Map the desk setup",
      "items": [
        "Record display count and direct/dock paths before disconnecting safe accessories.",
        "The M1 Air supports one native external display; keep unsupported requests separate.",
        "Choose one known network and avoid entering its name or password in this report."
      ]
    },
    {
      "id": "isolate",
      "title": "Compare one condition at a time",
      "items": [
        "Use the display task to separate cable/input and supported configuration.",
        "Use the USB task to compare a single accessory and its required power.",
        "Record whether another device reaches the internet on the same network."
      ]
    },
    {
      "id": "handoff",
      "title": "Provide a reproducible setup",
      "items": [
        "Tell the provider which direct condition worked and which dock condition failed.",
        "Bring only the relevant safe accessory if requested.",
        "Keep network credentials and personal device contents private."
      ]
    },
    {
      "id": "return",
      "title": "Reassemble carefully",
      "items": [
        "Reconnect the verified display and accessories one at a time.",
        "Repeat the same supported configuration and network control.",
        "Retain the first connection that reintroduces a symptom."
      ]
    }
  ],
  "prerequisites": [
    "Confirm the exact model locally.",
    "Review the stop conditions before attempting any included check."
  ],
  "tools": [
    "Existing safe accessories only when the included task calls for them."
  ],
  "materials": [
    "Your own existing backup method.",
    "Credentials kept privately outside this record."
  ],
  "checks": [
    {
      "id": "safety",
      "question": "Is it safe to continue with a non-invasive preparation record?",
      "goal": "Use the stop route for suspected damage; it still creates a useful service report.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "options": [
        {
          "id": "safe",
          "label": "No visible danger",
          "next": "scope"
        },
        {
          "id": "danger",
          "label": "Damage, swelling, smoke or unsafe heat",
          "next": "stop"
        },
        {
          "id": "unknown",
          "label": "I cannot confirm",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "scope",
      "question": "Have you reviewed the 3 included task records and marked any unperformed checks?",
      "goal": "Separate display limits, USB accessory power and Wi-Fi reachability before escalating a desk setup fault.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "options": [
        {
          "id": "yes",
          "label": "Records reviewed",
          "next": "data"
        },
        {
          "id": "partial",
          "label": "Only some records are available",
          "next": "partial"
        },
        {
          "id": "unknown",
          "label": "Not reviewed yet",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "data",
      "question": "Is backup and private owner access ready, or has the unresolved data risk been discussed with the provider?",
      "goal": "A prepared report does not guarantee that a repair preserves data.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "options": [
        {
          "id": "yes",
          "label": "Ready or discussed with the provider",
          "next": "ready"
        },
        {
          "id": "no",
          "label": "Data risk still needs discussion",
          "next": "data-risk"
        },
        {
          "id": "unknown",
          "label": "Not checked",
          "next": "uncertain"
        }
      ]
    }
  ],
  "branches": [
    {
      "from": "safety",
      "answer": "safe",
      "to": "scope"
    },
    {
      "from": "safety",
      "answer": "danger",
      "to": "stop"
    },
    {
      "from": "safety",
      "answer": "unknown",
      "to": "uncertain"
    },
    {
      "from": "scope",
      "answer": "yes",
      "to": "data"
    },
    {
      "from": "scope",
      "answer": "partial",
      "to": "partial"
    },
    {
      "from": "scope",
      "answer": "unknown",
      "to": "uncertain"
    },
    {
      "from": "data",
      "answer": "yes",
      "to": "ready"
    },
    {
      "from": "data",
      "answer": "no",
      "to": "data-risk"
    },
    {
      "from": "data",
      "answer": "unknown",
      "to": "uncertain"
    }
  ],
  "steps": [
    {
      "id": "stage-map",
      "text": "Map the desk setup: Record display count and direct/dock paths before disconnecting safe accessories. The M1 Air supports one native external display; keep unsupported requests separate. Choose one known network and avoid entering its name or password in this report.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "locator": "Preparation pack synthesis of the linked manufacturer tasks; individual operations retain their task-specific source sections."
    },
    {
      "id": "stage-isolate",
      "text": "Compare one condition at a time: Use the display task to separate cable/input and supported configuration. Use the USB task to compare a single accessory and its required power. Record whether another device reaches the internet on the same network.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "locator": "Preparation pack synthesis of the linked manufacturer tasks; individual operations retain their task-specific source sections."
    },
    {
      "id": "stage-handoff",
      "text": "Provide a reproducible setup: Tell the provider which direct condition worked and which dock condition failed. Bring only the relevant safe accessory if requested. Keep network credentials and personal device contents private.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "locator": "Preparation pack synthesis of the linked manufacturer tasks; individual operations retain their task-specific source sections."
    },
    {
      "id": "stage-return",
      "text": "Reassemble carefully: Reconnect the verified display and accessories one at a time. Repeat the same supported configuration and network control. Retain the first connection that reintroduces a symptom.",
      "sourceIds": [
        "mac-spec",
        "mac-display",
        "mac-usb",
        "mac-wifi"
      ],
      "locator": "Preparation pack synthesis of the linked manufacturer tasks; individual operations retain their task-specific source sections."
    }
  ],
  "outcomeChecks": [
    "Native display support and direct versus hub connections",
    "USB accessory behavior when isolated",
    "Local Wi-Fi association versus internet access"
  ],
  "stopConditions": [
    "Stop using and charging equipment with swelling, casing separation, smoke, a burning smell or suspected battery damage. Do not open or press on it.",
    "Set damaged accessories aside. Do not open mains adapters or force connectors.",
    "Do not erase, reset, flash firmware or bypass a lock as a default diagnostic step."
  ],
  "sources": [
    {
      "id": "mac-spec",
      "title": "MacBook Air (M1, 2020) technical specifications",
      "url": "https://support.apple.com/en-us/111883",
      "locator": "Charging and Expansion / Display Support",
      "purpose": "Two USB-C Thunderbolt/USB4 ports and one native external display up to 6K at 60 Hz",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-display",
      "title": "External display dark or low resolution",
      "url": "https://support.apple.com/en-gb/102501",
      "locator": "Connections / Support limits / Detection / Accessory permission",
      "purpose": "Direct video path, Detect Displays and detection versus image",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-usb",
      "title": "USB Devices Disabled on Mac",
      "url": "https://support.apple.com/en-us/102204",
      "locator": "Troubleshooting list",
      "purpose": "Other port, direct accessory and documented self-powered hub supply",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-wifi",
      "title": "Mac cannot connect to the internet over Wi-Fi",
      "url": "https://support.apple.com/en-ie/101588",
      "locator": "Connection / Date and time / Diagnostics / Different network",
      "purpose": "Association versus internet, permitted network comparison and Wireless Diagnostics",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-id",
      "title": "Identify MacBook Air model",
      "url": "https://support.apple.com/en-ie/102869",
      "locator": "Find model / MacBook Air M1 2020",
      "purpose": "Model and chip confirmation",
      "checkedAt": "2026-10-04",
      "reuse": "Reference only. Original paraphrase; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-diagnostics",
      "title": "Use Apple Diagnostics to test your Mac",
      "url": "https://support.apple.com/en-gb/102550",
      "locator": "Prepare / Apple silicon / Run Apple Diagnostics / Results",
      "purpose": "M1 Options then Command-D; Tahoe 26+ selected tests versus earlier automatic testing; preserve reference code",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    }
  ],
  "assets": [
    {
      "id": "laptop-m1-ports",
      "path": "/assets/laptop-m1-ports.svg",
      "title": "M1 Air connection map",
      "alt": "Original schematic showing two left USB-C ports, right headphone jack and a direct one-display comparison.",
      "sourceIds": [
        "mac-spec",
        "mac-display"
      ],
      "caption": "Original schematic, not to scale. MacBook Air M1 (2020); one native external display. Inspect the real connector before use.",
      "kind": "Original schematic"
    }
  ],
  "relatedIds": [
    "mba-m1-external-display",
    "mba-m1-usb-disabled",
    "mba-m1-wifi-access"
  ],
  "terminals": {
    "ready": {
      "type": "preparation_saved",
      "title": "Handoff packet assembled",
      "text": "Review the evidence report and share it directly with the provider you choose.",
      "handoff": [
        "Native display support and direct versus hub connections",
        "USB accessory behavior when isolated",
        "Local Wi-Fi association versus internet access",
        "Retain which included task records are unfinished, unavailable or stopped.",
        "Confirm the provider’s data-handling plan before agreeing to data-changing work."
      ]
    },
    "partial": {
      "type": "preparation_saved",
      "title": "Partial packet ready",
      "text": "The packet lists available results alongside missing task records. Use it to agree which safe observations remain.",
      "handoff": [
        "Native display support and direct versus hub connections",
        "USB accessory behavior when isolated",
        "Local Wi-Fi association versus internet access",
        "Retain which included task records are unfinished, unavailable or stopped.",
        "Confirm the provider’s data-handling plan before agreeing to data-changing work."
      ]
    },
    "data-risk": {
      "type": "service_needed",
      "title": "Data protection needs a conversation",
      "text": "Export the available evidence and discuss backup or access limitations before handing over the device.",
      "handoff": [
        "Tell the provider which data is inaccessible and whether a verified backup exists.",
        "Native display support and direct versus hub connections",
        "USB accessory behavior when isolated",
        "Local Wi-Fi association versus internet access",
        "Retain which included task records are unfinished, unavailable or stopped.",
        "Confirm the provider’s data-handling plan before agreeing to data-changing work."
      ]
    },
    "uncertain": {
      "type": "preparation_saved",
      "title": "Unconfirmed handoff packet",
      "text": "The report keeps unknown fields and unperformed checks visible. Ask the provider which observation is safe and necessary next.",
      "handoff": [
        "Explain that safety or readiness has not yet been confirmed.",
        "Native display support and direct versus hub connections",
        "USB accessory behavior when isolated",
        "Local Wi-Fi association versus internet access",
        "Retain which included task records are unfinished, unavailable or stopped.",
        "Confirm the provider’s data-handling plan before agreeing to data-changing work."
      ]
    },
    "stop": {
      "type": "service_needed",
      "title": "Stop-use handoff packet",
      "text": "Do not reproduce a hazardous fault. Export the observations already available and follow manufacturer service guidance.",
      "handoff": [
        "Do not use, charge, open or press on equipment with suspected battery damage.",
        "Keep suspected damaged accessories out of routine comparison tests.",
        "Native display support and direct versus hub connections",
        "USB accessory behavior when isolated",
        "Local Wi-Fi association versus internet access",
        "Retain which included task records are unfinished, unavailable or stopped.",
        "Confirm the provider’s data-handling plan before agreeing to data-changing work."
      ]
    }
  },
  "workflow": {
    "family": "condition-matrix",
    "summary": "Separate display limits, USB accessory power and Wi-Fi reachability before escalating a desk setup fault.",
    "osOptions": [
      "macos26-plus",
      "macos-earlier",
      "macos-unknown"
    ],
    "fields": [
      {
        "id": "display-count",
        "label": "Native external displays in this comparison",
        "type": "select",
        "options": [
          {
            "value": "one",
            "label": "One external display"
          },
          {
            "value": "multiple",
            "label": "More than one requested"
          },
          {
            "value": "none",
            "label": "No external display"
          }
        ]
      },
      {
        "id": "connection-path",
        "label": "Accessory path",
        "type": "select",
        "options": [
          {
            "value": "direct",
            "label": "Direct to the Mac"
          },
          {
            "value": "hub",
            "label": "Through a hub or dock"
          },
          {
            "value": "mixed",
            "label": "Compared both"
          },
          {
            "value": "unknown",
            "label": "Not checked"
          }
        ]
      },
      {
        "id": "network-compare",
        "label": "Network control result",
        "type": "select",
        "options": [
          {
            "value": "other-works",
            "label": "Another device has internet on this network"
          },
          {
            "value": "both-fail",
            "label": "Both devices lack internet"
          },
          {
            "value": "unavailable",
            "label": "No control comparison"
          }
        ]
      }
    ],
    "matrix": {
      "title": "Before, during and after service",
      "rows": [
        {
          "id": "pack-condition-1",
          "label": "Comparison 1",
          "condition": "One supported display on a direct compatible connection"
        },
        {
          "id": "pack-condition-2",
          "label": "Comparison 2",
          "condition": "One USB accessory at a time, with required independent power"
        },
        {
          "id": "pack-condition-3",
          "label": "Comparison 3",
          "condition": "Known network compared with another device under the same conditions"
        }
      ],
      "results": [
        {
          "value": "not-tested",
          "label": "Not checked"
        },
        {
          "value": "works",
          "label": "Expected response"
        },
        {
          "value": "fails",
          "label": "Symptom present"
        },
        {
          "value": "intermittent",
          "label": "Comes and goes"
        },
        {
          "value": "not-applicable",
          "label": "Not available / not applicable"
        }
      ]
    },
    "logPrompts": [
      "One supported display on a direct compatible connection",
      "One USB accessory at a time, with required independent power",
      "Known network compared with another device under the same conditions"
    ],
    "reportFocus": [
      "Native display support and direct versus hub connections",
      "USB accessory behavior when isolated",
      "Local Wi-Fi association versus internet access"
    ],
    "notDoneGuidance": [
      "An absent task record remains unstarted in the packet.",
      "Only mark a check performed when its recorded condition actually occurred.",
      "Stopped or unavailable tests remain useful handoff evidence."
    ]
  },
  "estimatedDuration": {
    "minutes": 25,
    "label": "Planning estimate for assembling existing evidence; excludes testing, backup and service."
  }
}