stringray-ai 1.0.14 → 1.0.16

package/README.md

@@ -61,7 +61,13 @@
 
 ### Installation
 
+First, ensure you have a `package.json` file in your project:
+
 ```bash
+# If you don't have package.json yet
+npm init -y
+
+# Then install StringRay AI
 npm install stringray-ai
 ```
 
@@ -70,10 +76,10 @@ npm install stringray-ai
 **Important:** After installation, you must run the setup command manually:
 
 ```bash
-npx stringray-ai init
+npx stringray-ai install
 ```
 
-**Note:** npm does not run postinstall scripts automatically for local package installations (file paths or tar.gz files) for security reasons. The setup must be run manually.
+**Note:** The setup command is required because npm's postinstall scripts have security restrictions that prevent automatic configuration. This ensures you have full control over the installation process.
 
 This will automatically:
 
@@ -81,6 +87,28 @@ This will automatically:
 - ✅ Enable multi-agent orchestration settings
 - ✅ Set up configuration for AI development workflows
 
+### Validation & Testing
+
+After installation, validate that StringRay is working correctly:
+
+```bash
+# Test CLI functionality
+npx stringray-ai --help
+npx stringray-ai doctor
+
+# Run comprehensive plugin validation
+node node_modules/stringray-ai/scripts/test-stringray-plugin.mjs
+
+# Check system status
+npx stringray-ai status
+```
+
+The plugin test will verify:
+- ✅ Plugin loads successfully
+- ✅ Codex injection works
+- ✅ System hooks are functional
+- ✅ Framework is ready for oh-my-opencode integration
+
 ### Manual Installation
 
 If automatic setup fails:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stringray-ai",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "⚡ StringRay ⚡: Bulletproof AI orchestration with systematic error prevention. Zero dead ends. Ship clean, tested, optimized code — every time.",
   "type": "module",
   "main": "./dist/plugin/index.js",

package/scripts/test-stringray-plugin.mjs

@@ -58,14 +58,17 @@ console.log('=====================================\n');
       console.log(`📚 Codex context injected: ${hasCodex ? '✅' : '❌'}`);
       console.log(`📋 Codex terms included: ${hasTerms ? '✅' : '❌'}`);
 
-       if (hasCodex && hasTerms) {
+      if (hasCodex && hasTerms) {
          console.log('\n🎉 StringRay Framework Plugin Test: PASSED');
          console.log('✨ Framework is ready for oh-my-opencode integration');
-         process.exit(0);
+
+         // Run comprehensive deployment tests
+         console.log('\n🔬 Running comprehensive deployment validation...');
+         await runComprehensiveTests();
        } else {
-        console.log('\n❌ StringRay Framework Plugin Test: FAILED');
-        process.exit(1);
-      }
+         console.log('\n❌ StringRay Framework Plugin Test: FAILED');
+         process.exit(1);
+       }
     } else {
       console.log('❌ No system messages generated');
       process.exit(1);
@@ -75,4 +78,100 @@ console.log('=====================================\n');
     console.error('❌ Plugin loading failed:', error);
     process.exit(1);
   }
-})();
+})();
+
+// Comprehensive deployment validation function
+async function runComprehensiveTests() {
+  console.log('\n🔬 Running comprehensive deployment validation...\n');
+
+  const tests = [
+    {
+      name: 'Core functionality test',
+      command: 'npm run test:architect --prefix ..',
+      description: 'Tests core StringRay functionality'
+    },
+    {
+      name: 'MCP server connectivity test',
+      command: 'npm run test:mcp-connectivity --prefix ..',
+      description: 'Tests MCP server connections'
+    },
+    {
+      name: 'oh-my-opencode integration test',
+      command: 'npm run test:oh-my-opencode-integration --prefix ..',
+      description: 'Tests oh-my-opencode integration'
+    },
+    {
+      name: 'External process communication test',
+      command: 'npm run test:external-processes --prefix ..',
+      description: 'Tests external process communication'
+    }
+  ];
+
+  let passed = 0;
+  let failed = 0;
+
+  for (const test of tests) {
+    console.log(`🧪 Running ${test.name}...`);
+    console.log(`   ${test.description}`);
+
+    try {
+      const { spawn } = await import('child_process');
+      const [cmd, ...args] = test.command.split(' ');
+
+      await new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, {
+          stdio: ['pipe', 'pipe', 'pipe'],
+          cwd: process.cwd()
+        });
+
+        let stdout = '';
+        let stderr = '';
+
+        child.stdout.on('data', (data) => {
+          stdout += data.toString();
+        });
+
+        child.stderr.on('data', (data) => {
+          stderr += data.toString();
+        });
+
+        child.on('close', (code) => {
+          if (code === 0) {
+            console.log(`   ✅ PASSED\n`);
+            passed++;
+            resolve();
+          } else {
+            console.log(`   ❌ FAILED (exit code: ${code})`);
+            if (stderr) console.log(`   Error: ${stderr.slice(0, 200)}...`);
+            console.log('');
+            failed++;
+            resolve(); // Continue with other tests
+          }
+        });
+
+        child.on('error', (error) => {
+          console.log(`   ❌ FAILED (spawn error: ${error.message})`);
+          console.log('');
+          failed++;
+          resolve();
+        });
+      });
+    } catch (error) {
+      console.log(`   ❌ FAILED (exception: ${error.message})`);
+      console.log('');
+      failed++;
+    }
+  }
+
+  console.log('📊 Comprehensive Test Results:');
+  console.log(`   ✅ Passed: ${passed}`);
+  console.log(`   ❌ Failed: ${failed}`);
+  console.log(`   📈 Success Rate: ${Math.round((passed / (passed + failed)) * 100)}%`);
+
+  if (failed === 0) {
+    console.log('\n🎉 ALL COMPREHENSIVE TESTS PASSED!');
+    console.log('✨ StringRay Framework is fully operational and ready for production use.');
+  } else {
+    console.log(`\n⚠️  ${failed} test(s) failed. Please check the framework configuration.`);
+  }
+}