phpcs.xml.dist

<?xml version="1.0"?>
<ruleset name="Agent Builder">
	<description>Coding standards for the Agent Builder WordPress plugin.</description>

	<file>.</file>

	<exclude-pattern>*/vendor/*</exclude-pattern>
	<exclude-pattern>*/node_modules/*</exclude-pattern>
	<exclude-pattern>*/build/*</exclude-pattern>
	<exclude-pattern>*/tests/*</exclude-pattern>
	<exclude-pattern>*/languages/*</exclude-pattern>

	<arg value="sp"/>
	<arg name="basepath" value="."/>
	<arg name="colors"/>
	<arg name="extensions" value="php"/>

	<rule ref="WordPress-Extra">
		<!-- Namespaced code (Agentic\...) doesn't need file-based class naming. -->
		<exclude name="WordPress.Files.FileName"/>
	</rule>

	<rule ref="WordPress.NamingConventions.PrefixAllGlobals">
		<properties>
			<!--
				This plugin's public prefix is agent_builder_ / AGENT_BUILDER_,
				matching the agent-builder slug/text domain. The Agentic_ prefix
				is also registered: it's used only by the small set of classes
				that must live in the global namespace (loaded before the
				autoloader) rather than under the Agentic\ PHP namespace — those
				are still consistently prefixed, just not namespaced, so they
				don't "leak" unprefixed globals either.
			-->
			<property name="prefixes" type="array">
				<element value="agent_builder"/>
				<element value="Agentic"/>
			</property>
		</properties>
	</rule>

	<rule ref="WordPress.WP.Capabilities">
		<properties>
			<!--
				The plugin's custom capabilities. They are virtual: never
				registered with add_cap(), but granted at runtime by
				User_Roles::filter_user_has_cap() from the stored role settings
				(User_Roles::CAP_PREFIX + privilege key). Listing them here is
				what tells the Capabilities sniff they are real.
			-->
			<property name="custom_capabilities" type="array">
				<element value="agent_builder_view_dashboard"/>
				<element value="agent_builder_manage_agents"/>
				<element value="agent_builder_view_audit_log"/>
				<element value="agent_builder_manage_tools"/>
				<element value="agent_builder_run_tasks_manually"/>
				<element value="agent_builder_manage_settings"/>
				<element value="agent_builder_chat_frontend"/>
				<element value="agent_builder_chat_admin_bar"/>
				<element value="agent_builder_view_agent_list"/>
				<element value="agent_builder_use_uploaded_agents"/>
			</property>
		</properties>
	</rule>

	<rule ref="WordPress.Security.EscapeOutput"/>
	<rule ref="WordPress.Security.NonceVerification"/>
</ruleset>