fix: gate AGENTS sections on core setting

Author: homeboy-ci[bot]

inc/Runtime/AgentsMdSections.php

@@ -17,6 +17,10 @@ final class AgentsMdSections {
 	 * Register AGENTS.md as a composable memory file and add DMC-owned sections.
 	 */
 	public static function register(): void {
+		if ( ! function_exists('datamachine_agents_md_enabled') || ! datamachine_agents_md_enabled() ) {
+			return;
+		}
+
 		if ( ! class_exists('\DataMachine\Engine\AI\MemoryFileRegistry') ) {
 			return;
 		}
@@ -58,6 +62,10 @@ public static function register(): void {
 	 * Register workspace change hooks that invalidate composable AGENTS.md.
 	 */
 	public static function register_invalidation_hooks( array $hooks ): array {
+		if ( ! function_exists('datamachine_agents_md_enabled') || ! datamachine_agents_md_enabled() ) {
+			return $hooks;
+		}
+
 		$hooks[] = 'datamachine_code_workspace_changed';
 		return $hooks;
 	}

tests/smoke-agents-md-marker.php

@@ -42,8 +42,6 @@
 $expected_generated_at      = '<!-- generated at: {$generated_at} -->';
 $expected_description       = 'Regenerate via: wp datamachine memory compose AGENTS.md';
 $stale_marker               = 'datamachine agent compose AGENTS.md';
-$expected_memory_agent_note = 'On multi-agent installs, pass `--agent=<slug>` to memory commands when auto-resolution is ambiguous.';
-$expected_agent_cli         = 'datamachine agent list|create|access|token|installed|install|diff';
 $stale_agent_cli            = 'datamachine agents list|create|access|tokens';
 // Workspace / GitHub subcommand lists are now generated from the
 // command classes via CommandIntrospector (see #671) instead of hardcoded
@@ -54,7 +52,7 @@
 $expected_github_token       = 'datamachine-code github {$github_subcmds}';
 $expected_introspect_wiring  = 'CommandIntrospector::pipe_list(';
 $stale_hardcoded_workspace   = 'workspace adopt|clone|list|show|path|hygiene|remove|worktree';
-$expected_worktree_cli      = 'datamachine-code workspace worktree add|list|remove|prune|cleanup|cleanup-artifacts|reconcile-metadata|refresh-context|finalize|mark-cleanup-eligible';
+$expected_worktree_token   = 'datamachine-code workspace worktree {$worktree_subcmds}';
 $expected_inventory_time    = 'Generated {$generated_at} from cloned repos';
 $expected_inventory_truth   = 'workspace list` is the source of truth';
 $expected_inventory_refresh = 'datamachine memory compose AGENTS.md{$agent_suffix}';
@@ -65,6 +63,7 @@
 $expected_static_fresh      = "'freshness'   => 'static'";
 $expected_generated_fresh   = "'freshness'   => 'generated'";
 $expected_multisite_cond    = "'conditions'  => 'Only registered on multisite installs.'";
+$expected_core_gate         = 'datamachine_agents_md_enabled';
 
 $assert(
     'auto-generated marker uses memory compose command',
@@ -79,16 +78,12 @@
     str_contains($source, $expected_description)
 );
 $assert(
-    'stale agent compose command is absent',
-    ! str_contains($source, $stale_marker)
-);
-$assert(
-    'agent CLI guidance uses current singular command surface',
-    str_contains($source, $expected_agent_cli)
+    'AGENTS.md registration depends on Data Machine core gate',
+    str_contains($source, $expected_core_gate)
 );
 $assert(
-    'memory guidance covers explicit agent slug on ambiguous installs',
-    str_contains($source, $expected_memory_agent_note)
+    'stale agent compose command is absent',
+    ! str_contains($source, $stale_marker)
 );
 $assert(
     'stale plural agent token guidance is absent',
@@ -108,7 +103,7 @@
 );
 $assert(
     'worktree guidance includes current maintenance surfaces',
-    str_contains($source, $expected_worktree_cli)
+    str_contains($source, $expected_worktree_token)
 );
 $assert(
     'workspace inventory renders generation time',
@@ -152,7 +147,7 @@
 );
 $assert(
     'plugin entrypoint no longer contains AGENTS.md heredoc sections',
-    ! str_contains($entrypoint, $expected_agent_cli)
+    ! str_contains($entrypoint, '## Data Machine Code')
 );
 
 /*
@@ -211,6 +206,11 @@ function is_wp_error( $value ): bool {
         return false;
     }
 }
+if (! function_exists('datamachine_agents_md_enabled') ) {
+    function datamachine_agents_md_enabled(): bool {
+        return true;
+    }
+}
 if (! class_exists('DataMachine\\Engine\\AI\\MemoryFileRegistry') ) {
     eval('namespace DataMachine\\Engine\\AI; class MemoryFileRegistry { public const LAYER_SHARED = "shared"; public static array $files = array(); public static function register(...$args): void { self::$files[] = $args; } }');
 }
@@ -221,10 +221,10 @@ function is_wp_error( $value ): bool {
 require_once __DIR__ . '/../inc/Runtime/AgentsMdSections.php';
 \DataMachineCode\Runtime\AgentsMdSections::register();
 
-$datamachine_section = '';
+$datamachine_code_section = '';
 foreach ( \DataMachine\Engine\AI\SectionRegistry::$sections as $registered_section ) {
-    if ( isset($registered_section[1]) && 'datamachine' === $registered_section[1] && is_callable($registered_section[3] ?? null) ) {
-        $datamachine_section = (string) call_user_func($registered_section[3]);
+    if ( isset($registered_section[1]) && 'datamachine-code' === $registered_section[1] && is_callable($registered_section[3] ?? null) ) {
+        $datamachine_code_section = (string) call_user_func($registered_section[3]);
         break;
     }
 }
@@ -245,8 +245,8 @@ function is_wp_error( $value ): bool {
     false === $command_autoloaded
 );
 $assert(
-    'Data Machine AGENTS.md section composes without WP_CLI_Command',
-    str_contains($datamachine_section, 'datamachine-code workspace adopt|clone|list|show|path|hygiene|remove|worktree|read|write|grep|edit|git|patch|ls')
+    'Data Machine Code AGENTS.md section composes without WP_CLI_Command',
+    str_contains($datamachine_code_section, 'datamachine-code workspace adopt|clone|list|show|path|hygiene|remove|worktree|read|write|grep|edit|git|patch|ls')
 );
 
 echo "\nCommandIntrospector against real command classes:\n";