Hooks

View as Markdown

This reference lists the public filters, actions, and PHP APIs Onumia supports for site-specific code and integrations. It is generated from PHPDoc annotations in the app src/ tree; regenerate it with npm run docs:hooks after changing documented surfaces.

Reference Contents

Section	Entries	Categories
Public Filters	24	Access (1), Admin (3), Agent Code (2), Data (5), Database (6), Guidance (1), Runtime (1), Sandbox (4), WordPress (1)

Public Filters

Hook	Category	Since	Summary
`onumia/access/role_capabilities`	Access	0.1.0	Filters effective Onumia role capability mappings.
`onumia/admin/menu_location`	Admin	0.1.0	Filters where Onumia appears in the WordPress admin menu.
`onumia/admin/app_entrypoint`	Admin	0.1.0	Filters the Vite entrypoint used for the Onumia admin app.
`onumia/admin/app_asset_directory`	Admin	0.1.0	Filters the built asset directory used for the Onumia admin app.
`onumia/agent_code/repository_path`	Agent Code	0.1.0	Filters the canonical Onumia Agent Code repository path.
`onumia/agent_code/live_branch`	Agent Code	0.1.0	Filters the live branch used for Onumia Agent Code promotion.
`onumia/data/merql_pdo`	Data	0.1.0	Filters the PDO connection used for MerQL database promotion.
`onumia/data/merql_capture_snapshot`	Data	0.1.0	Filters whether an integration captured a MerQL snapshot itself.
`onumia/data/merql_snapshot_dir`	Data	0.1.0	Filters the directory used for MerQL database snapshots.
`onumia/data/merql_tables`	Data	0.1.0	Filters the database tables included in MerQL promotion snapshots.
`onumia/data/merql_identity_rules`	Data	0.1.0	Filters the MerQL row identity rules used for Onumia database merge snapshots.
`onumia/database/local_clone_max_bytes`	Database	0.1.0	Filters the maximum copied database payload allowed for local clones.
`onumia/database/allow_unknown_size_local_clone`	Database	0.1.0	Filters whether local clones may proceed when database size is unknown.
`onumia/database/size_table_exclusions`	Database	0.1.0	Filters database tables excluded from local clone size and cloning.
`onumia/database/schema_only_table_patterns`	Database	0.1.0	Filters table-name patterns copied as schema-only local clone tables.
`onumia/database/schema_only_tables`	Database	0.1.0	Filters explicit full table names copied as schema-only local clone tables.
`onumia/database/redacted_columns`	Database	0.1.0	Filters column names whose source content is redacted during local clones.
`onumia/guidance/enabled`	Guidance	0.1.0	Filters whether Onumia surfaces per-plugin agent guidance.
`onumia/runtime/headers_sent`	Runtime	0.1.0	Filters whether Onumia should treat HTTP headers as already sent.
`onumia/sandbox/base_dir`	Sandbox	0.1.0	Filters the base directory used for Onumia sandbox files.
`onumia/sandbox/default_ttl_seconds`	Sandbox	0.1.0	Filters the default sandbox preview TTL used when create_sandbox omits ttl.
`onumia/sandbox/max_active_per_user`	Sandbox	0.1.0	Filters the maximum number of active sandboxes each user may own.
`onumia/sandbox/inactive_retention_days`	Sandbox	0.1.0	Filters how long promoted/discarded sandboxes are retained.
`onumia/wp/bin`	WordPress	0.1.0	Filters the wp-cli binary used by Onumia’s native WordPress command.