ppcos 0.3.0

package/lib/utils/validation.js

@@ -0,0 +1,176 @@
+/**
+ * Input validation utilities
+ */
+
+// Regex patterns per spec
+const CLIENT_NAME_REGEX = /^[a-z][a-z0-9-]{0,49}$/;
+const GOOGLE_ADS_ID_REGEX = /^\d{3}-\d{3}-\d{4}$/;
+
+/**
+ * Validate a client name
+ * Rules:
+ * - Lowercase letters, numbers, hyphens only
+ * - Must start with letter
+ * - 1-50 characters
+ * - No spaces or special characters
+ *
+ * @param {string} name - Client name to validate
+ * @returns {{ valid: boolean, error?: string }} Validation result
+ */
+export function validateClientName(name) {
+  if (!name || typeof name !== 'string') {
+    return { valid: false, error: 'Client name is required' };
+  }
+
+  if (name.length < 1) {
+    return { valid: false, error: 'Client name is required' };
+  }
+
+  if (name.length > 50) {
+    return { valid: false, error: 'Client name must be 1-50 characters' };
+  }
+
+  if (!/^[a-z]/.test(name)) {
+    return { valid: false, error: 'Client name must start with a lowercase letter' };
+  }
+
+  if (!CLIENT_NAME_REGEX.test(name)) {
+    return {
+      valid: false,
+      error: 'Client name can only contain lowercase letters, numbers, and hyphens'
+    };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * Validate a Google Ads customer ID
+ * Format: XXX-XXX-XXXX (3 digits, 3 digits, 4 digits)
+ *
+ * @param {string} id - Customer ID to validate
+ * @returns {{ valid: boolean, error?: string }} Validation result
+ */
+export function validateGoogleAdsId(id) {
+  if (!id) {
+    return { valid: true }; // Optional field
+  }
+
+  if (!GOOGLE_ADS_ID_REGEX.test(id)) {
+    return {
+      valid: false,
+      error: 'Google Ads Customer ID must be in format XXX-XXX-XXXX'
+    };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * Validate main-config.json structure
+ *
+ * @param {object} config - Config object to validate
+ * @returns {{ valid: boolean, errors: string[] }} Validation result
+ */
+export function validateConfig(config) {
+  const errors = [];
+
+  if (!config || typeof config !== 'object') {
+    return { valid: false, errors: ['Config must be an object'] };
+  }
+
+  // Version check
+  if (config.version !== '1.0') {
+    errors.push('Unsupported config version (expected "1.0")');
+  }
+
+  // Clients array check
+  if (!Array.isArray(config.clients)) {
+    errors.push('clients must be an array');
+    return { valid: false, errors };
+  }
+
+  // Validate each client
+  const seenNames = new Set();
+
+  for (let i = 0; i < config.clients.length; i++) {
+    const client = config.clients[i];
+    const prefix = `clients[${i}]`;
+
+    if (!client || typeof client !== 'object') {
+      errors.push(`${prefix}: must be an object`);
+      continue;
+    }
+
+    // Name validation
+    const nameResult = validateClientName(client.name);
+    if (!nameResult.valid) {
+      errors.push(`${prefix}.name: ${nameResult.error}`);
+    } else if (seenNames.has(client.name)) {
+      errors.push(`${prefix}.name: duplicate client name "${client.name}"`);
+    } else {
+      seenNames.add(client.name);
+    }
+
+    // Enabled field
+    if (typeof client.enabled !== 'boolean') {
+      errors.push(`${prefix}.enabled: must be a boolean`);
+    }
+
+    // Optional Google Ads ID
+    if (client.googleAdsCustomerId) {
+      const idResult = validateGoogleAdsId(client.googleAdsCustomerId);
+      if (!idResult.valid) {
+        errors.push(`${prefix}.googleAdsCustomerId: ${idResult.error}`);
+      }
+    }
+
+    // Optional displayName
+    if (client.displayName !== undefined) {
+      if (typeof client.displayName !== 'string') {
+        errors.push(`${prefix}.displayName: must be a string`);
+      } else if (client.displayName.length > 100) {
+        errors.push(`${prefix}.displayName: must be 1-100 characters`);
+      }
+    }
+
+    // Optional website
+    if (client.website !== undefined && typeof client.website !== 'string') {
+      errors.push(`${prefix}.website: must be a string`);
+    }
+  }
+
+  // Optional settings validation
+  if (config.settings !== undefined) {
+    if (typeof config.settings !== 'object' || config.settings === null) {
+      errors.push('settings: must be an object');
+    } else if (config.settings.clientsDirectory !== undefined) {
+      if (typeof config.settings.clientsDirectory !== 'string') {
+        errors.push('settings.clientsDirectory: must be a string');
+      }
+    }
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+/**
+ * Validate a manifest checksum format
+ * @param {string} checksum
+ * @returns {boolean}
+ */
+export function isValidChecksum(checksum) {
+  return typeof checksum === 'string' && /^sha256:[a-f0-9]{64}$/.test(checksum);
+}
+
+/**
+ * Validate a semver version string
+ * @param {string} version
+ * @returns {boolean}
+ */
+export function isValidVersion(version) {
+  return typeof version === 'string' && /^\d+\.\d+\.\d+$/.test(version);
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "ppcos",
+  "version": "0.3.0",
+  "description": "CLI tool to manage Google Ads AI workflow skills and agents for Claude Code",
+  "type": "module",
+  "bin": {
+    "ppcos": "./bin/ppcos.js"
+  },
+  "scripts": {
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "keywords": [],
+  "author": "Alfred Simon, Bob Meijer and Miles McNair",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pitcocy/ppcos.git"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "unzipper": "^0.12.3"
+  },
+  "devDependencies": {
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ]
+}