Initial commit

skills/wordpress-ability-api/scripts/scaffold-category.php

@@ -0,0 +1,97 @@
+#!/usr/bin/env php
+<?php
+/**
+ * WordPress Ability Category Scaffolding Script
+ *
+ * Generates category registration code from templates based on command-line arguments.
+ * Designed to be called by AI agents to quickly scaffold categories.
+ *
+ * Usage:
+ *   php scaffold-category.php --name="category-slug" --label="Category Label" --description="Description" --type="server"
+ *
+ * Required Arguments:
+ *   --name          Category slug (kebab-case, e.g., "data-retrieval")
+ *   --label         Human-readable label
+ *   --description   Detailed description of what abilities belong in this category
+ *   --type          Type: "server" (PHP) or "client" (JavaScript)
+ *
+ * Output:
+ *   Complete category registration code printed to stdout
+ *
+ * Exit Codes:
+ *   0 - Success
+ *   1 - Missing required arguments
+ *   2 - Invalid argument values
+ */
+
+// Parse command-line arguments
+$options = getopt('', [
+	'name:',
+	'label:',
+	'description:',
+	'type:',
+]);
+
+// Validate required arguments
+$required = ['name', 'label', 'description', 'type'];
+$missing = array_diff($required, array_keys($options));
+
+if (!empty($missing)) {
+	fwrite(STDERR, "Error: Missing required arguments: " . implode(', ', $missing) . "\n");
+	fwrite(STDERR, "Usage: php scaffold-category.php --name=\"category-slug\" --label=\"Label\" --description=\"Description\" --type=\"server\"\n");
+	exit(1);
+}
+
+// Extract and validate arguments
+$name = $options['name'];
+$label = $options['label'];
+$description = $options['description'];
+$type = strtolower($options['type']);
+
+// Validate category name format (kebab-case)
+if (!preg_match('/^[a-z0-9-]+$/', $name)) {
+	fwrite(STDERR, "Error: Invalid category name format. Must be kebab-case (lowercase, hyphens allowed, e.g., 'data-retrieval')\n");
+	exit(2);
+}
+
+// Validate type
+if (!in_array($type, ['server', 'client'])) {
+	fwrite(STDERR, "Error: Invalid type. Must be 'server' or 'client'\n");
+	exit(2);
+}
+
+// Load the appropriate template
+$template_file = $type === 'server'
+	? __DIR__ . '/../assets/category-template.php'
+	: __DIR__ . '/../assets/client-category-template.js';
+
+if (!file_exists($template_file)) {
+	fwrite(STDERR, "Error: Template file not found: {$template_file}\n");
+	exit(2);
+}
+
+$template = file_get_contents($template_file);
+if ($template === false) {
+	fwrite(STDERR, "Error: Unable to read template file: {$template_file}\n");
+	exit(2);
+}
+
+// Prepare placeholder replacements
+$register_function = str_replace('-', '_', $name) . '_category_register';
+$namespace = 'text-domain'; // Generic text domain for templates
+
+$placeholders = [
+	'{{CATEGORY_NAME}}' => $name,
+	'{{LABEL}}' => $label,
+	'{{DESCRIPTION}}' => $description,
+	'{{REGISTER_FUNCTION}}' => $register_function,
+	'{{NAMESPACE}}' => $namespace,
+];
+
+// Replace placeholders
+$output = str_replace(array_keys($placeholders), array_values($placeholders), $template);
+
+// Output the result
+echo $output;
+
+exit(0);