@amrhas82/agentic-kit 1.0.0 → 1.2.0

package/validate-package.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+
+/**
+ * Package Validation Script for Agentic Kit v1.2.0+
+ *
+ * Validates the multi-tool installer structure with:
+ * - Multiple tool packages (claude, opencode, ampcode, droid)
+ * - Variant configurations (variants.json)
+ * - Installer system components
+ * - Documentation
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ANSI color codes for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m'
+};
+
+let errorCount = 0;
+let warningCount = 0;
+
+function error(message) {
+  console.error(`${colors.red}✗ ERROR:${colors.reset} ${message}`);
+  errorCount++;
+}
+
+function warn(message) {
+  console.warn(`${colors.yellow}⚠ WARNING:${colors.reset} ${message}`);
+  warningCount++;
+}
+
+function success(message) {
+  console.log(`${colors.green}✓${colors.reset} ${message}`);
+}
+
+function info(message) {
+  console.log(`${colors.cyan}ℹ${colors.reset} ${message}`);
+}
+
+function fileExists(filePath) {
+  return fs.existsSync(filePath);
+}
+
+function validateJsonFile(filePath, label) {
+  if (!fileExists(filePath)) {
+    error(`${label} not found: ${filePath}`);
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const parsed = JSON.parse(content);
+    success(`${label} is valid`);
+    return parsed;
+  } catch (err) {
+    error(`${label} has invalid JSON: ${err.message}`);
+    return null;
+  }
+}
+
+function validatePackageJson() {
+  info('\nValidating package.json...');
+
+  const pkg = validateJsonFile('./package.json', 'package.json');
+  if (!pkg) {
+    return null;
+  }
+
+  // Check required fields
+  const requiredFields = ['name', 'version', 'description'];
+  requiredFields.forEach(field => {
+    if (!pkg[field]) {
+      error(`Missing required field '${field}' in package.json`);
+    } else {
+      success(`package.json has '${field}' field`);
+    }
+  });
+
+  // Check version format
+  if (pkg.version && !/^\d+\.\d+\.\d+$/.test(pkg.version)) {
+    warn(`Version format should be semver (x.y.z): ${pkg.version}`);
+  }
+
+  // Validate files field includes critical paths
+  if (pkg.files) {
+    const criticalPaths = ['packages/', 'installer/', 'README.md'];
+    const missing = criticalPaths.filter(p => !pkg.files.some(f => f.includes(p) || p.includes(f)));
+    if (missing.length > 0) {
+      warn(`package.json files field may be missing: ${missing.join(', ')}`);
+    } else {
+      success('package.json files field includes critical paths');
+    }
+  }
+
+  // Check for repository URL
+  if (pkg.repository && pkg.repository.url) {
+    success('repository URL is configured');
+  } else {
+    warn('Missing repository URL in package.json');
+  }
+
+  // Check for author
+  if (pkg.author) {
+    success('author field is configured');
+  } else {
+    warn('Missing author in package.json');
+  }
+
+  return pkg;
+}
+
+function validateRequiredFiles() {
+  info('\nValidating required files...');
+
+  const requiredFiles = [
+    { path: './README.md', label: 'README' },
+    { path: './CHANGELOG.md', label: 'CHANGELOG' },
+    { path: './package.json', label: 'package.json' }
+  ];
+
+  requiredFiles.forEach(({ path: filePath, label }) => {
+    if (!fileExists(filePath)) {
+      error(`${label} not found: ${filePath}`);
+    } else {
+      success(`${label} exists`);
+    }
+  });
+}
+
+function validateInstallerSystem() {
+  info('\nValidating installer system...');
+
+  const installerFiles = [
+    'installer/cli.js',
+    'installer/package-manager.js',
+    'installer/installation-engine.js',
+    'installer/path-manager.js',
+    'installer/verification-system.js',
+    'installer/state-manager.js',
+    'installer/report-template.js',
+    'installer/telemetry.js'
+  ];
+
+  installerFiles.forEach(file => {
+    if (!fileExists(file)) {
+      error(`Installer component missing: ${file}`);
+    } else {
+      success(`${path.basename(file)} exists`);
+    }
+  });
+
+  // Check if cli.js has shebang
+  if (fileExists('installer/cli.js')) {
+    const content = fs.readFileSync('installer/cli.js', 'utf8');
+    if (content.startsWith('#!/usr/bin/env node')) {
+      success('installer/cli.js has correct shebang');
+    } else {
+      error('installer/cli.js missing shebang');
+    }
+  }
+}
+
+function validateToolPackages() {
+  info('\nValidating tool packages...');
+
+  const tools = ['claude', 'opencode', 'ampcode', 'droid'];
+  const packagesDir = './packages';
+
+  if (!fileExists(packagesDir)) {
+    error('packages/ directory not found');
+    return;
+  }
+
+  tools.forEach(tool => {
+    const toolDir = path.join(packagesDir, tool);
+
+    if (!fileExists(toolDir)) {
+      error(`Tool package missing: ${tool}`);
+      return;
+    }
+
+    // Check for variants.json
+    const variantsPath = path.join(toolDir, 'variants.json');
+    const variants = validateJsonFile(variantsPath, `${tool} variants.json`);
+
+    if (variants) {
+      // Validate variant structure
+      const requiredVariants = ['lite', 'standard', 'pro'];
+      requiredVariants.forEach(variant => {
+        if (!variants[variant]) {
+          error(`${tool}: Missing '${variant}' variant configuration`);
+        } else {
+          // Validate variant has required fields
+          const v = variants[variant];
+          const requiredFields = ['name', 'description', 'agents', 'skills'];
+          requiredFields.forEach(field => {
+            if (v[field] === undefined) {
+              error(`${tool}/${variant}: Missing field '${field}'`);
+            }
+          });
+        }
+      });
+
+      if (requiredVariants.every(v => variants[v])) {
+        success(`${tool} has all required variants`);
+      }
+    }
+
+    // Check for core directories
+    const coreDirs = ['agents', 'skills', 'resources', 'hooks'];
+    coreDirs.forEach(dir => {
+      const dirPath = path.join(toolDir, dir);
+      if (!fileExists(dirPath)) {
+        warn(`${tool}: Missing ${dir}/ directory`);
+      }
+    });
+  });
+
+  success(`Validated ${tools.length} tool packages`);
+}
+
+function validateDocumentation() {
+  info('\nValidating documentation...');
+
+  const docs = [
+    'docs/INSTALLER_GUIDE.md',
+    'docs/VARIANT_CONFIGURATION.md',
+    'docs/PRIVACY.md',
+    'docs/SECURITY.md',
+    'docs/MIGRATION.md'
+  ];
+
+  docs.forEach(doc => {
+    if (!fileExists(doc)) {
+      warn(`Documentation missing: ${doc}`);
+    } else {
+      success(`${path.basename(doc)} exists`);
+    }
+  });
+}
+
+function validateTests() {
+  info('\nValidating tests...');
+
+  const testDirs = [
+    'tests/installer',
+    'tests/validation-test.js'
+  ];
+
+  let testCount = 0;
+  testDirs.forEach(testPath => {
+    if (fileExists(testPath)) {
+      success(`Tests exist: ${testPath}`);
+      testCount++;
+    }
+  });
+
+  if (testCount === 0) {
+    warn('No test files found');
+  }
+}
+
+function main() {
+  console.log(`\n${colors.bright}${colors.cyan}=== Agentic Kit Package Validation ===${colors.reset}\n`);
+  console.log(`${colors.cyan}Multi-Tool Installer Structure (v1.2.0+)${colors.reset}\n`);
+
+  // Run all validations
+  const pkg = validatePackageJson();
+  validateRequiredFiles();
+  validateInstallerSystem();
+  validateToolPackages();
+  validateDocumentation();
+  validateTests();
+
+  // Print summary
+  console.log(`\n${colors.bright}${colors.cyan}=== Validation Summary ===${colors.reset}\n`);
+
+  if (pkg) {
+    console.log(`${colors.cyan}Package:${colors.reset} ${pkg.name}@${pkg.version}`);
+  }
+
+  if (errorCount === 0 && warningCount === 0) {
+    console.log(`${colors.green}${colors.bright}✓ All validations passed!${colors.reset}`);
+    console.log(`${colors.green}Package is ready for publication.${colors.reset}\n`);
+    process.exit(0);
+  } else {
+    if (errorCount > 0) {
+      console.log(`${colors.red}${colors.bright}✗ ${errorCount} error(s) found${colors.reset}`);
+    }
+    if (warningCount > 0) {
+      console.log(`${colors.yellow}⚠ ${warningCount} warning(s) found${colors.reset}`);
+    }
+
+    if (errorCount > 0) {
+      console.log(`\n${colors.red}${colors.bright}Package validation failed. Please fix errors before publishing.${colors.reset}\n`);
+      process.exit(1);
+    } else {
+      console.log(`\n${colors.yellow}Package has warnings but can be published. Consider addressing warnings.${colors.reset}\n`);
+      process.exit(0);
+    }
+  }
+}
+
+// Run validation
+main();

package/.claude-plugin/plugin-lite.json

@@ -1,38 +0,0 @@
-{
-  "name": "Agentic Toolkit - Lite",
-  "version": "1.0.0",
-  "description": "Lightweight variant with 3 core agents and no skills for minimal dependencies",
-  "variant": "lite",
-  "agents": [
-    {
-      "id": "master",
-      "name": "Master",
-      "description": "Central orchestration agent",
-      "path": "agents/master.md"
-    },
-    {
-      "id": "orchestrator",
-      "name": "Orchestrator",
-      "description": "Task orchestration and workflow management",
-      "path": "agents/orchestrator.md"
-    },
-    {
-      "id": "scrum-master",
-      "name": "Scrum Master",
-      "description": "Project management and team coordination",
-      "path": "agents/scrum-master.md"
-    }
-  ],
-  "skills": [],
-  "hooks": [
-    {
-      "name": "register-agents",
-      "path": "hooks/register-agents.js",
-      "event": "plugin-load"
-    }
-  ],
-  "resources": {
-    "path": "resources/",
-    "types": ["templates", "data", "utils"]
-  }
-}

package/.claude-plugin/plugin-pro.json

@@ -1,183 +0,0 @@
-{
-  "name": "Agentic Toolkit - Pro",
-  "version": "1.0.0",
-  "description": "Pro variant with all 13 agents and all 14 skills for maximum capabilities",
-  "variant": "pro",
-  "agents": [
-    {
-      "id": "master",
-      "name": "Master",
-      "description": "Central orchestration agent",
-      "path": "agents/master.md"
-    },
-    {
-      "id": "orchestrator",
-      "name": "Orchestrator",
-      "description": "Task orchestration and workflow management",
-      "path": "agents/orchestrator.md"
-    },
-    {
-      "id": "product-manager",
-      "name": "Product Manager",
-      "description": "Product strategy and vision",
-      "path": "agents/product-manager.md"
-    },
-    {
-      "id": "product-owner",
-      "name": "Product Owner",
-      "description": "Requirements and backlog management",
-      "path": "agents/product-owner.md"
-    },
-    {
-      "id": "business-analyst",
-      "name": "Business Analyst",
-      "description": "Business requirements analysis",
-      "path": "agents/business-analyst.md"
-    },
-    {
-      "id": "full-stack-dev",
-      "name": "Full-Stack Developer",
-      "description": "Full-stack development implementation",
-      "path": "agents/full-stack-dev.md"
-    },
-    {
-      "id": "holistic-architect",
-      "name": "Holistic Architect",
-      "description": "System architecture and design",
-      "path": "agents/holistic-architect.md"
-    },
-    {
-      "id": "ux-expert",
-      "name": "UX Expert",
-      "description": "User experience and interface design",
-      "path": "agents/ux-expert.md"
-    },
-    {
-      "id": "qa-test-architect",
-      "name": "QA Test Architect",
-      "description": "Quality assurance and testing strategy",
-      "path": "agents/qa-test-architect.md"
-    },
-    {
-      "id": "scrum-master",
-      "name": "Scrum Master",
-      "description": "Project management and team coordination",
-      "path": "agents/scrum-master.md"
-    },
-    {
-      "id": "1-create-prd",
-      "name": "Create PRD",
-      "description": "Product Requirements Document generation",
-      "path": "agents/1-create-prd.md"
-    },
-    {
-      "id": "2-generate-tasks",
-      "name": "Generate Tasks",
-      "description": "Task generation and decomposition",
-      "path": "agents/2-generate-tasks.md"
-    },
-    {
-      "id": "3-process-task-list",
-      "name": "Process Task List",
-      "description": "Task list processing and tracking",
-      "path": "agents/3-process-task-list.md"
-    }
-  ],
-  "skills": [
-    {
-      "id": "pdf",
-      "name": "PDF",
-      "description": "PDF manipulation and document processing",
-      "path": "skills/pdf/"
-    },
-    {
-      "id": "docx",
-      "name": "DOCX",
-      "description": "Word document creation and editing",
-      "path": "skills/docx/"
-    },
-    {
-      "id": "xlsx",
-      "name": "XLSX",
-      "description": "Spreadsheet creation and analysis",
-      "path": "skills/xlsx/"
-    },
-    {
-      "id": "pptx",
-      "name": "PPTX",
-      "description": "Presentation creation and management",
-      "path": "skills/pptx/"
-    },
-    {
-      "id": "canvas-design",
-      "name": "Canvas Design",
-      "description": "Visual design and artwork creation",
-      "path": "skills/canvas-design/"
-    },
-    {
-      "id": "algorithmic-art",
-      "name": "Algorithmic Art",
-      "description": "Generative art and algorithmic design",
-      "path": "skills/algorithmic-art/"
-    },
-    {
-      "id": "artifacts-builder",
-      "name": "Artifacts Builder",
-      "description": "Complex HTML artifact creation",
-      "path": "skills/artifacts-builder/"
-    },
-    {
-      "id": "theme-factory",
-      "name": "Theme Factory",
-      "description": "Theme and styling application",
-      "path": "skills/theme-factory/"
-    },
-    {
-      "id": "brand-guidelines",
-      "name": "Brand Guidelines",
-      "description": "Brand compliance and styling",
-      "path": "skills/brand-guidelines/"
-    },
-    {
-      "id": "internal-comms",
-      "name": "Internal Communications",
-      "description": "Internal document and communication templates",
-      "path": "skills/internal-comms/"
-    },
-    {
-      "id": "mcp-builder",
-      "name": "MCP Builder",
-      "description": "Model Context Protocol server creation",
-      "path": "skills/mcp-builder/"
-    },
-    {
-      "id": "skill-creator",
-      "name": "Skill Creator",
-      "description": "Custom skill creation and development",
-      "path": "skills/skill-creator/"
-    },
-    {
-      "id": "webapp-testing",
-      "name": "Web App Testing",
-      "description": "Web application testing toolkit",
-      "path": "skills/webapp-testing/"
-    },
-    {
-      "id": "slack-gif-creator",
-      "name": "Slack GIF Creator",
-      "description": "Animated GIF creation for Slack",
-      "path": "skills/slack-gif-creator/"
-    }
-  ],
-  "hooks": [
-    {
-      "name": "register-agents",
-      "path": "hooks/register-agents.js",
-      "event": "plugin-load"
-    }
-  ],
-  "resources": {
-    "path": "resources/",
-    "types": ["templates", "data", "utils"]
-  }
-}

package/.claude-plugin/plugin-standard.json

@@ -1,147 +0,0 @@
-{
-  "name": "Agentic Toolkit - Standard",
-  "version": "1.0.0",
-  "description": "Standard variant with all 13 agents and 8 core production skills",
-  "variant": "standard",
-  "agents": [
-    {
-      "id": "master",
-      "name": "Master",
-      "description": "Central orchestration agent",
-      "path": "agents/master.md"
-    },
-    {
-      "id": "orchestrator",
-      "name": "Orchestrator",
-      "description": "Task orchestration and workflow management",
-      "path": "agents/orchestrator.md"
-    },
-    {
-      "id": "product-manager",
-      "name": "Product Manager",
-      "description": "Product strategy and vision",
-      "path": "agents/product-manager.md"
-    },
-    {
-      "id": "product-owner",
-      "name": "Product Owner",
-      "description": "Requirements and backlog management",
-      "path": "agents/product-owner.md"
-    },
-    {
-      "id": "business-analyst",
-      "name": "Business Analyst",
-      "description": "Business requirements analysis",
-      "path": "agents/business-analyst.md"
-    },
-    {
-      "id": "full-stack-dev",
-      "name": "Full-Stack Developer",
-      "description": "Full-stack development implementation",
-      "path": "agents/full-stack-dev.md"
-    },
-    {
-      "id": "holistic-architect",
-      "name": "Holistic Architect",
-      "description": "System architecture and design",
-      "path": "agents/holistic-architect.md"
-    },
-    {
-      "id": "ux-expert",
-      "name": "UX Expert",
-      "description": "User experience and interface design",
-      "path": "agents/ux-expert.md"
-    },
-    {
-      "id": "qa-test-architect",
-      "name": "QA Test Architect",
-      "description": "Quality assurance and testing strategy",
-      "path": "agents/qa-test-architect.md"
-    },
-    {
-      "id": "scrum-master",
-      "name": "Scrum Master",
-      "description": "Project management and team coordination",
-      "path": "agents/scrum-master.md"
-    },
-    {
-      "id": "1-create-prd",
-      "name": "Create PRD",
-      "description": "Product Requirements Document generation",
-      "path": "agents/1-create-prd.md"
-    },
-    {
-      "id": "2-generate-tasks",
-      "name": "Generate Tasks",
-      "description": "Task generation and decomposition",
-      "path": "agents/2-generate-tasks.md"
-    },
-    {
-      "id": "3-process-task-list",
-      "name": "Process Task List",
-      "description": "Task list processing and tracking",
-      "path": "agents/3-process-task-list.md"
-    }
-  ],
-  "skills": [
-    {
-      "id": "pdf",
-      "name": "PDF",
-      "description": "PDF manipulation and document processing",
-      "path": "skills/pdf/"
-    },
-    {
-      "id": "docx",
-      "name": "DOCX",
-      "description": "Word document creation and editing",
-      "path": "skills/docx/"
-    },
-    {
-      "id": "xlsx",
-      "name": "XLSX",
-      "description": "Spreadsheet creation and analysis",
-      "path": "skills/xlsx/"
-    },
-    {
-      "id": "pptx",
-      "name": "PPTX",
-      "description": "Presentation creation and management",
-      "path": "skills/pptx/"
-    },
-    {
-      "id": "canvas-design",
-      "name": "Canvas Design",
-      "description": "Visual design and artwork creation",
-      "path": "skills/canvas-design/"
-    },
-    {
-      "id": "theme-factory",
-      "name": "Theme Factory",
-      "description": "Theme and styling application",
-      "path": "skills/theme-factory/"
-    },
-    {
-      "id": "brand-guidelines",
-      "name": "Brand Guidelines",
-      "description": "Brand compliance and styling",
-      "path": "skills/brand-guidelines/"
-    },
-    {
-      "id": "internal-comms",
-      "name": "Internal Communications",
-      "description": "Internal document and communication templates",
-      "path": "skills/internal-comms/"
-    }
-  ],
-  "hooks": [
-    {
-      "name": "register-agents",
-      "path": "hooks/register-agents.js",
-      "event": "plugin-load"
-    }
-  ],
-  "resources": {
-    "path": "resources/",
-    "types": ["templates", "data", "utils"]
-  }
-}