LorenEteval_Furious/Furious/Extensions/AGENTS.md

Bundled extension guidance

Inherit the root and package guides; consult Plugins for capability and registration contracts. This scope covers host-shipped non-runtime plugins and must not gain private authority merely because the code is bundled.

• Extensions contains host-shipped plugins that are not proxy runtimes. They register through the same public API and lifecycle as entry-point plugins. New extension contracts must be usable without private repository/controller/UI access; bundled location is not permission to bypass the public boundary.
• StandardSubscriptionPlugin owns format recognition and decoding only. A decoder returns an immutable neutral SubscriptionResult envelope; nested mappings are not necessarily deeply immutable. Profile construction/metadata belongs to SubscriptionImportService, and group reconciliation, request generations, timers, persistence, and post-commit effects belong to the subscription service/repository path.
• Decoder probing is priority-ordered and failure-isolated. Return None when a format does not match, validate the declared result shape, preserve useful names/upstream IDs, and never log a complete payload or link. Current standard formats are linear plain/Base64 share-link envelopes; introduce explicit size/depth/work limits before adding richer recursive or nested formats. Standard decoders opt into worker execution; that declaration covers all shared parser state and caches, not merely absence of widgets in the immediate method. Worker preparation also requires the selected protocol handlers to opt in; a safe envelope decoder cannot authorize an unsafe downstream parser. Preserve the GUI compatibility fallback for unclassified capabilities.
• Decoder output is descriptive, not a repository transaction. It cannot assign live profile identity, mutate a subscription group, cancel tests, reconnect, or publish UI state; those decisions remain at the import/manager commit boundaries.
• Keep bundled registration deterministic, side-effect-light, and discoverable in source, wheel, and Nuitka builds. Test format selection/fallback, malformed and secret-bearing input, duplicate occurrence identity, unsupported subscription protocols, registration rollback, and absence of repository/UI mutation during decoding. Evolve this guide with the decoder contract rather than giving bundled formats permanent special treatment. Use tests/test_plugin_architecture.py and tests/test_subscription_scalability.py; decoder success is not authorization to import a protocol whose descriptor excludes subscriptions, such as local executables.