Add AOXC standalone library, consumer manifest & validation, Foundry runbook, and cross-cutting fixes

[aoxc]

Motivation

• Provide a stable, machine-consumable AOXC contract library for downstream chains (e.g. aoxchain) with deterministic deployment primitives and a manifest usable by CI/backends.
• Make local/CI Foundry onboarding deterministic and operator-friendly via an idempotent installer and runbook in the README.
• Harden cross-repo imports, type-safety, and owner/operator checks across scripts, contracts and tests to reduce lint/compile/runtime issues.

Description

• Added a standalone AOXC library surface under src/aoxc-library/ including IAoxcModule, AoxcModuleRegistry, AoxcModuleFactory, example modules, and a thin wrapper AoxcDaoManagerModule that forwards constructor args to the V2 governance implementation.
• Introduced machine-readable manifest generation and validation: script/generate_library_manifest.py produces src/aoxc-library/manifest/approved-modules.json and script/validate_library_consumer_config.py validates consumer configs (example: configs/aoxchain.consumer.example.json).
• Documentation and operator runbooks added/updated: docs/AOXCHAIN_* files, src/aoxc-library/README.md additions, and Foundry installation/runbook text appended to README.md plus script/install_foundry.sh installer.
• Cross-cutting Solidity and test fixes: normalized named imports (import {X} from ...), added internal helper checks (_onlyOwner, _onlyOperator), tightened integer bounds with explicit checks and safe casts in core modules, and adjusted scripts to use Script imports; updated tests to use SafeERC20 (IERC20(...).safeTransfer(...)) and named imports so the suite compiles against the refactored codepaths.

Testing

• Ran build and unit/integration/fuzz suites with Foundry via forge build, forge test, and forge test --fuzz, and exercised the new manifest tooling using python3 script/generate_library_manifest.py and python3 script/validate_library_consumer_config.py; the automated test runs completed successfully.
• Verified that the generated manifest src/aoxc-library/manifest/approved-modules.json is produced by script/generate_library_manifest.py and that the example consumer config configs/aoxchain.consumer.example.json validates with script/validate_library_consumer_config.py.
• Confirmed scripts compile and deployment scripts (*.s.sol) import and run under the updated forge-std/Script pattern by executing representative script compile checks.

---

Codex Task

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.