ieee80211: separate capability and BSS state ownership

[mgonzalezlopezudc]

Summary

Refactor IEEE 802.11 capability preparation and BSS/peer-state ownership around explicit typed
contracts and deterministic initialization dependencies.

The MAC assembles an idempotent local capability profile from typed PHY contributors. Management
owns accepted BSS, operation and peer transitions, while the MIB stores the committed view and
publishes changes after the associated bookkeeping is complete. Catalog consumers use a narrow
read-only mode-set provider; management-only preparation is exposed through the extended MAC
configuration provider.

The series also preserves the simplified legacy-STA abstraction: a legacy STA associated with an
HT AP retains the BSS identity, channel and association state but does not install HT operation.

Review order

1. common: change: prepare interface identity before link-layer users establishes the shared
   readiness prerequisite and identifies the implementation plan.
2. ieee80211: change: separate capability and BSS state ownership introduces the typed contracts,
   migrates consumers, and includes the simplified legacy-STA capability gate and lifecycle tests.
3. ieee80211: refactor: separate the read-only mode-set provider narrows catalog-only consumers.

No fingerprint or statistical baseline is changed.

Architectural and compatibility surface

The change affects the common initialization-stage graph, IEEE 802.11 MAC, management and MIB
ownership, PHY capability contracts, mode-set/catalog consumers, NED provider wiring, and the
corresponding unit, module and protocol fixtures. Public C++ and NED provider APIs change; the
release notes and migration guide document the provider and notification-lifetime changes.

The implementation does not change MSG inputs, on-air field serialization, packet representation,
feature descriptors, statistical baselines, or files under the sealed common/packet/ subtree.
The synthetic 20/40 MHz management and selection fixtures do not claim real 40 MHz packet-PHY
support, and the external-upper fixture does not claim real TAP I/O.

Validation

Validation across the series includes debug builds for the focused commit points and a release build
for the main implementation, followed by focused tests covering:

• HT capability preparation, peer-mode selection and MIB association IDs;
• capability-provider substitution, configuration contracts, BSS notifications, AP/STA lifecycle,
  simplified initialization, reassociation and channel changes;
• association, HT association, reassociation and deauthentication protocol exchanges; and
• the legacy MacNonQos and MacQos ad hoc fingerprints, run 0, 10 seconds, with unchanged
  tplx expectations, plus 18 unchanged Wi-Fi/Ethernet/VLAN/configurator fingerprint cases.

Scoped architecture checks for the IEEE 802.11 MAC and PHY paths pass. Interface checking reports
only the existing AV-CONTRACT-02 bodies. No recorded baseline changed.

The exact implementation plan and its evidence are tracked in
the implementation plan and
the evidence companion.

Validation is deterministic and uses the checked-in configurations, run 0 and seed 0/default where
applicable. The recorded evidence does not claim performance results, real TAP I/O, a complete
feature-disabled campaign, or a full repository-wide cross-protocol initialization campaign.

Reproducible local cleanup verification

Each of the three output commits passed make MODE=debug -j8 and the selected legacy fingerprints.
The common prerequisite passed three initialization/lifecycle module cases; both WLAN commit points
passed the following nine module and three unit cases. The final source tree is identical to the
previously audited 7058073ea84ba90394a7ee16a971b30de06433ef.

# Repository root, each commit:
make MODE=debug -j8
# Common prerequisite:
inet_run_module_tests -m debug -f 'Ieee80211(HtAssociation|MgmtStaSimplifiedInitialization|MgmtApLifecycle)_1\.test'
# Both WLAN commit points:
inet_run_module_tests -m debug -f 'Ieee80211(HtAssociation|HtCapabilityPreparation|ConfigurationContracts|MgmtStaBeaconUpdate|MgmtStaSimplifiedInitialization|MgmtApLifecycle|MgmtStaLifecycle|MgmtApReassociationSnapshot|MgmtApChannelChange)_1\.test'
inet_run_unit_tests -m debug -f 'Ieee80211(HtCapabilities|PeerModeSelection|MibAssociationId)_1\.test'

The two fingerprints were executed through opp_repl --load @opp -p inet after setting INET_ROOT
to the checkout, using this exact scoped call and a temporary JSON projection of the unchanged CSV
expectations (MacNonQos=5749-0281/tplx, MacQos=1486-cbae/tplx):

p = get_default_simulation_project()
p.fingerprint_store = "/tmp/pr1216-cleanup-v2/csv-expectations.json"
configs = [SimulationConfig(p, "examples/adhoc/qos", config=c, num_runs=1, sim_time_limit="10s")
           for c in ["MacNonQos", "MacQos"]]
r = run_fingerprint_tests(simulation_configs=configs, mode="debug", run_number=0,
                          ingredients_list=["tplx"], sim_time_limit="10s",
                          build=False, concurrent=False)

Both cases passed on the original head and every rewritten commit, with unchanged expectations.
Fixtures used run 0 and seed 0/default. No new release, feature-disabled, full-protocol or full
cross-protocol campaign was run during this cleanup; broader validation above is prior evidence.