Establish the project operating foundation

[siriusctrl]

What changed

• reorganize README, contributor guidance, agent instructions, source maps, configuration, testing, and architecture documentation
• add ADRs for the core product and package-boundary decisions
• standardize Node 22, root build/check/verify commands, documentation checks, API smoke tooling, and GitHub Actions
• bring the web package into test coverage and expand chart-projection edge-case tests
• archive the completed refactor roadmap and synchronize the human API contract with the portable agent reference

Why

The repository had strong implementation depth, but its entry points, durable decisions, verification commands, and agent-facing guidance were distributed across several files. This change creates a clear operating model for users, contributors, and coding agents while keeping the current package architecture and simulation-only product boundary explicit.

Impact

Contributors now have one documented setup and verification path, CI exercises every workspace package, documentation links are checked automatically, and future architecture changes have explicit ownership and ADR conventions.

Validation

• corepack pnpm check
• corepack pnpm build
• corepack pnpm coverage
• corepack pnpm verify:ui
• corepack pnpm verify:preview
• git diff --check
• shell and Node script syntax checks

The live API smoke path was added but not executed because it requires a running API, external market access, and a writable local database.