Add component-based simulation editor and interactive session CLI

[concordia-claw]

Design and inspect Concordia simulations through a graphical editor or a persistent concordia-session prompt. Entities are built from standard prefabs and components; both clients share authoring actions and validated service operations. The GUI/CLI guide teaches the entity-component pattern, CLI (concordia-session) usage, and editor usage by describing the same concrete exercise in both interfaces.

What users can do

• Instantiate installed standard/contrib prefabs or named presets, override parameters, add compatible components, reorder entities/components, inspect references and duplicate an edited definition.
• Validate and explicitly save a local draft; undo/redo, export/open project JSON, and identify invalid fields. Each browser or CLI owns its draft and selection. Server revisions protect against overwriting another client's save.
• Run a saved design for a requested number of engine steps bounded by its saved maximum; pause, step, resume and reset. The actual engine is displayed. Component-advertised dynamic fields support initial overrides or paused runtime edits, with validation owned by the component setter.
• Read command results, errors and action narratives in one Simulation log, or use the standard log-analysis commands. The terminal shares scrollback with its prompt. Panels resize with pointer/touch or keyboard controls.
• Switch the central panel between the standard visualization and registered HTML/URL viewers or a locally selected HTML file. The sandboxed viewer retains the surrounding draft and controls; refresh is explicit.

Review map and contracts

• prefab_catalog.discover discovers concrete entity prefab classes under installed standard/contrib namespaces without building them. Module/class-qualified keys remain stable; optional dependency failures are visible. Prefab declares extra-component capability and validates actual dependency keys and insertion indices. Editor-authored additions reject key collisions; direct Python configurations retain supported replacement/shared-component bindings. Unsupported additions raise NotImplementedError before construction. Application-owned non-scalar defaults remain Python configuration; discovery does not guarantee every prefab default fits every engine.
• project_config.Template/Registry: trusted Config factories, prefab creation keys, registered component recipes, field/reference validation and Config conversion. JSON selects registered objects, not Python imports. Prefab creation reads standard Prefab.params; named presets identify starting settings and Duplicate copies the edited definition. The input contract explains rejected-file recovery.
• project_view, session_commands, session_draft: shared command parsing and draft actions. Node runs the same helpers for external CLI authoring. Browser file pickers and layout stay browser-local; CLI files require explicit paths.
• OperationService, ProjectEditor, SimulationServer: argument/audience validation, serialized dispatch, session/revision/retry checks, saved/runtime snapshots and event transport. Host-approved audiences and origin checks constrain attached clients; the developer service belongs on a local or access-controlled connection.
• StepController and generic.Simulation: track active/waiting workers and acknowledge a pause only after in-flight work finishes. Engine implementations use the standard callbacks. Runtime edits require this acknowledged boundary. Engine implementations are outside this PR's editing scope.
• SceneTracker: optional component-owned literal configuration, JSON roundtrip, atomic schedule validation and memory-cursor preservation. Scheduling is edited through generic component fields. Callable configuration stays host-owned. HumanActComponent supplies a standard acting component for host-connected human input.

Reviewer regression entry points in this library checkout:

python -m pytest -q -n 0 concordia/utils/operation_service_test.py concordia/utils/session_commands_test.py concordia/utils/project_prefab_catalog_test.py
python -m pytest -q -n 0 concordia/utils/project_dynamic_browser_test.py concordia/components/game_master/scene_tracker_dynamic_test.py concordia/utils/project_layout_browser_test.py
python -m pytest -q -n 0 concordia/utils/project_engine_integration_test.py

Focused catalog/component/GUI/CLI verification: 194 affected tests passed, with 38 catalog tests rerun after final discovery assertions. These include new installed module discovery without central registration, standard/contrib construction with authored components, unsupported-addition errors, reference conversion, saved-state preservation on rejected Save, intercepted Chromium, and the copied discovery tutorial through the CLI and OperationService. Scoped pyrefly, pylint, isort and formatting checks pass. The seven Social Deception/State Formation regressions also pass with their mock/no-model engine runs. No external provider or listener was launched for this verification.

python -m pytest -q -n 0 concordia/utils/prefab_catalog_test.py concordia/utils/project_components_test.py concordia/utils/project_prefab_catalog_test.py concordia/utils/project_structure_test.py concordia/utils/project_config_test.py concordia/utils/project_view_test.py concordia/utils/session_commands_test.py

[jzleibo]

Closing this pull request as the changes have already been merged into main via commit 80d9dab.