📝 Document services.git API in plugin example

- Add git.detect() demo to check-services command
- Document Services API in plugin README

Author: Robdel12

examples/custom-plugin/README.md

@@ -71,8 +71,28 @@ The `register` function receives:
 1. **`program`** - Commander.js program instance for adding commands
 2. **`context`** - Object containing:
    - `config` - Merged Vizzly configuration
-   - `logger` - Component logger for consistent output
-   - `services` - Service container with API client, uploader, etc.
+   - `output` - Output utilities for consistent CLI output
+   - `services` - Service container (see below)
+
+### Services API
+
+The `services` object provides stable APIs for plugins:
+
+```javascript
+let { git, testRunner, serverManager } = services;
+
+// Git detection (v0.25.0+) - handles CI environments correctly
+let gitInfo = await git.detect({ buildPrefix: 'MyPlugin' });
+// Returns: { branch, commit, message, prNumber, buildName }
+
+// Build lifecycle
+let buildId = await testRunner.createBuild(options);
+await testRunner.finalizeBuild(buildId, wait, success, executionTime);
+
+// Server control
+await serverManager.start(buildId, tddMode, setBaseline);
+await serverManager.stop();
+```
 
 ## Creating Your Own Plugin
 

examples/custom-plugin/plugin.js

@@ -53,7 +53,18 @@ export default {
           output.info('Checking Vizzly services...');
 
           // Access services from the stable API
-          let { testRunner, serverManager } = services;
+          let { git, testRunner, serverManager } = services;
+
+          // Verify git detection is available (v0.25.0+)
+          if (git?.detect) {
+            output.success('git.detect is available');
+            let gitInfo = await git.detect({ buildPrefix: 'Example' });
+            output.info(`  Branch: ${gitInfo.branch}`);
+            output.info(`  Commit: ${gitInfo.commit?.slice(0, 7) || 'unknown'}`);
+            output.info(`  PR: ${gitInfo.prNumber || 'none'}`);
+          } else {
+            output.warn('git.detect not available (requires CLI v0.25.0+)');
+          }
 
           // Verify testRunner is available
           if (typeof testRunner.createBuild === 'function') {