strray-ai 1.7.3 → 1.7.6

package/.opencode/codex.codex

@@ -1,7 +1,7 @@
 {
-  "version": "1.2.25",
+  "version": "1.7.5",
   "terms": [
-    1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 24, 29, 32, 38, 42, 43
+    1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60
   ],
   "framework": "StringRay Universal Development Codex",
   "compliance": "99.6% Error Prevention"

package/.opencode/commands/mode-switch.md

@@ -1,6 +1,6 @@
 ---
 name: mode-switch
-description: Switch between full (8 agents) and lite (4 agents) modes dynamically
+description: Switch between full (27 agents) and lite (27 agents) modes dynamically
 ---
 
 #!/bin/bash
@@ -20,7 +20,7 @@ DISABLED_COUNT=$(jq '.agent | map(select(.disable == true)) | length' opencode.j
         if [ "$DISABLED_COUNT" -eq 0 ] || [ -z "$DISABLED_COUNT" ]; then
 CURRENT_MODE="full"
 echo "🎯 Current Mode: $CURRENT_MODE"
-            echo "📝 Description: All 8 agents active for comprehensive development support"
+            echo "📝 Description: All 27 agents active for comprehensive development support"
             echo "🤖 Active Agents: 8"
             echo "   enforcer architect orchestrator bug-triage-specialist code-reviewer security-auditor refactorer testing-lead"
         elif [ "$DISABLED_COUNT" -eq 4 ]; then
@@ -62,7 +62,7 @@ local new_mode="$1"
             jq '.disabled_agents = []' "$ENFORCER_CONFIG_FILE" > "${ENFORCER_CONFIG_FILE}.tmp" && mv "${ENFORCER_CONFIG_FILE}.tmp" "$ENFORCER_CONFIG_FILE"
         fi
     else
-        # Set disabled_agents for lite mode (4 agents disabled)
+        # Set disabled_agents for lite mode (27 agents disabled)
         jq '.disabled_agents = ["security-auditor", "refactorer", "testing-lead", "bug-triage-specialist"]' "$CONFIG_FILE" > "${CONFIG_FILE}.tmp" && mv "${CONFIG_FILE}.tmp" "$CONFIG_FILE"
         if [ -f "$ENFORCER_CONFIG_FILE" ]; then
             jq '.disabled_agents = ["security-auditor", "refactorer", "testing-lead", "bug-triage-specialist"]' "$ENFORCER_CONFIG_FILE" > "${ENFORCER_CONFIG_FILE}.tmp" && mv "${ENFORCER_CONFIG_FILE}.tmp" "$ENFORCER_CONFIG_FILE"
@@ -81,7 +81,7 @@ case "$1" in
 "")
 show_current_mode
 echo "Usage: mode-switch [full|lite]"
-echo " full - All 8 agents active"
+echo " full - All 27 agents active"
 echo " lite - 4 core agents active"
 ;;
 "full"|"lite")

package/.opencode/enforcer-config.json

@@ -1,6 +1,6 @@
 {
   "framework": "StringRay 1.0.0",
-  "version": "1.7.1",
+  "version": "1.7.5",
   "description": "Codex-compliant framework configuration for Credible UI project",
   "thresholds": {
     "bundleSize": {
@@ -174,7 +174,7 @@
       }
     },
     "codex": {
-      "version": "1.7.1",
+      "version": "1.7.5",
       "terms": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 24, 29, 32, 38, 42, 43],
       "principles": [
         "progressive-prod-ready-code",

package/.opencode/integrations/claude-seo/README.md

@@ -0,0 +1,77 @@
+# Claude SEO Integration
+
+This directory contains the Claude SEO skill integrated into StringRay.
+
+## Source
+
+- **Original**: [https://github.com/AgriciDaniel/claude-seo](https://github.com/AgriciDaniel/claude-seo)
+- **License**: MIT
+- **Version**: Installed 2026-03-09T07:40:30.001Z
+
+## Features
+
+### Core Skills (8)
+- `seo-audit/` - Full website audit with parallel subagents
+- `seo-page/` - Deep single-page analysis
+- `seo-sitemap/` - XML sitemap analysis and generation
+- `seo-schema/` - Schema markup detection and generation
+- `seo-technical/` - Technical SEO audit (8 categories)
+- `seo-content/` - E-E-A-T and content quality analysis
+- `seo-geo/` - AI Search / GEO optimization
+- `seo-plan/` - Strategic SEO planning
+
+### Advanced Skills (4, --full only)
+- `seo-programmatic/` - Programmatic SEO with quality gates
+- `seo-competitor-pages/` - "X vs Y" comparison generator
+- `seo-hreflang/` - Multi-language SEO validation
+- `seo-images/` - Image optimization analysis
+
+### Subagents (5, --full only)
+- seo-ai-visibility
+- seo-platform-analysis  
+- seo-technical-agent
+- seo-content-agent
+- seo-schema-agent
+
+## Usage
+
+After installation, use these commands in Claude Code:
+
+```
+/seo audit <url>         - Full website audit
+/seo page <url>          - Single page analysis
+/seo technical <url>     - Technical SEO audit
+/seo content <url>       - E-E-A-T analysis
+/seo geo <url>           - AI search optimization
+/seo schema <url>        - Schema markup
+/seo sitemap generate    - Generate sitemap
+```
+
+## Integration with StringRay
+
+This integration works alongside StringRay's built-in SEO tools:
+
+| Feature | StringRay | Claude SEO |
+|---------|-----------|------------|
+| Technical SEO | Basic | Advanced (8 cats) |
+| Schema | 6 types | 10+ types |
+| AI Search | Basic | Advanced |
+| E-E-A-T | ❌ | ✅ |
+| PDF Reports | ❌ | ✅ |
+| Programmatic | ❌ | ✅ |
+
+## Commands
+
+```bash
+# Install core skills
+node scripts/integrations/install-claude-seo.js
+
+# Install everything
+node scripts/integrations/install-claude-seo.js --full
+
+# Re-install
+node scripts/integrations/install-claude-seo.js --full
+```
+
+---
+*Integrated into StringRay v1.7.5*

package/.opencode/integrations/claude-seo/routing.json

@@ -0,0 +1,103 @@
+{
+  "name": "claude-seo-routing",
+  "description": "SEO routing configuration for Claude SEO integration",
+  "routes": [
+    {
+      "pattern": "/seo audit",
+      "skill": "seo-audit",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo page",
+      "skill": "seo-page",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo sitemap",
+      "skill": "seo-sitemap",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo schema",
+      "skill": "seo-schema",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo technical",
+      "skill": "seo-technical",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo content",
+      "skill": "seo-content",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo geo",
+      "skill": "seo-geo",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo plan",
+      "skill": "seo-plan",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo programmatic",
+      "skill": "seo-programmatic",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo competitor",
+      "skill": "seo-competitor-pages",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo hreflang",
+      "skill": "seo-hreflang",
+      "agents": [
+        "seo-consultant"
+      ]
+    },
+    {
+      "pattern": "/seo images",
+      "skill": "seo-images",
+      "agents": [
+        "seo-consultant"
+      ]
+    }
+  ],
+  "keywords": [
+    "seo audit",
+    "seo analysis",
+    "technical seo",
+    "on-page seo",
+    "schema markup",
+    "sitemap",
+    "core web vitals",
+    "e-e-a-t",
+    "ai search",
+    "geo optimization",
+    "programmatic seo"
+  ]
+}

package/.opencode/integrations/claude-seo/seo-audit/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: seo-audit
+source: claude-seo
+attribution: |
+  Originally from https://github.com/AgriciDaniel/claude-seo
+  License: MIT (see LICENSE.claude-seo)
+converted: 2026-03-09T07:40:29.995Z
+framework: StringRay v1.7.5
+---
+
+---
+name: seo-audit
+description: >
+  Full website SEO audit with parallel subagent delegation. Crawls up to 500
+  pages, detects business type, delegates to 6 specialists, generates health
+  score. Use when user says "audit", "full SEO check", "analyze my site",
+  or "website health check".
+---
+
+# Full Website SEO Audit
+
+## Process
+
+1. **Fetch homepage** — use `scripts/fetch_page.py` to retrieve HTML
+2. **Detect business type** — analyze homepage signals per seo orchestrator
+3. **Crawl site** — follow internal links up to 500 pages, respect robots.txt
+4. **Delegate to subagents** (if available, otherwise run inline sequentially):
+   - `seo-technical` — robots.txt, sitemaps, canonicals, Core Web Vitals, security headers
+   - `seo-content` — E-E-A-T, readability, thin content, AI citation readiness
+   - `seo-schema` — detection, validation, generation recommendations
+   - `seo-sitemap` — structure analysis, quality gates, missing pages
+   - `seo-performance` — LCP, INP, CLS measurements
+   - `seo-visual` — screenshots, mobile testing, above-fold analysis
+5. **Score** — aggregate into SEO Health Score (0-100)
+6. **Report** — generate prioritized action plan
+
+## Crawl Configuration
+
+```
+Max pages: 500
+Respect robots.txt: Yes
+Follow redirects: Yes (max 3 hops)
+Timeout per page: 30 seconds
+Concurrent requests: 5
+Delay between requests: 1 second
+```
+
+## Output Files
+
+- `FULL-AUDIT-REPORT.md` — Comprehensive findings
+- `ACTION-PLAN.md` — Prioritized recommendations (Critical → High → Medium → Low)
+- `screenshots/` — Desktop + mobile captures (if Playwright available)
+
+## Scoring Weights
+
+| Category | Weight |
+|----------|--------|
+| Technical SEO | 25% |
+| Content Quality | 25% |
+| On-Page SEO | 20% |
+| Schema / Structured Data | 10% |
+| Performance (CWV) | 10% |
+| Images | 5% |
+| AI Search Readiness | 5% |
+
+## Report Structure
+
+### Executive Summary
+- Overall SEO Health Score (0-100)
+- Business type detected
+- Top 5 critical issues
+- Top 5 quick wins
+
+### Technical SEO
+- Crawlability issues
+- Indexability problems
+- Security concerns
+- Core Web Vitals status
+
+### Content Quality
+- E-E-A-T assessment
+- Thin content pages
+- Duplicate content issues
+- Readability scores
+
+### On-Page SEO
+- Title tag issues
+- Meta description problems
+- Heading structure
+- Internal linking gaps
+
+### Schema & Structured Data
+- Current implementation
+- Validation errors
+- Missing opportunities
+
+### Performance
+- LCP, INP, CLS scores
+- Resource optimization needs
+- Third-party script impact
+
+### Images
+- Missing alt text
+- Oversized images
+- Format recommendations
+
+### AI Search Readiness
+- Citability score
+- Structural improvements
+- Authority signals
+
+## Priority Definitions
+
+- **Critical**: Blocks indexing or causes penalties (fix immediately)
+- **High**: Significantly impacts rankings (fix within 1 week)
+- **Medium**: Optimization opportunity (fix within 1 month)
+- **Low**: Nice to have (backlog)
+
+## DataForSEO Integration (Optional)
+
+If DataForSEO MCP tools are available, spawn the `seo-dataforseo` agent alongside existing subagents to enrich the audit with live data: real SERP positions, backlink profiles with spam scores, on-page analysis (Lighthouse), business listings, and AI visibility checks (ChatGPT scraper, LLM mentions).
+
+
+---
+
+*This skill was integrated into StringRay via the claude-seo integration script.*
+*Original source: https://github.com/AgriciDaniel/claude-seo*

package/.opencode/integrations/claude-seo/seo-competitor-pages/SKILL.md

@@ -0,0 +1,220 @@
+---
+name: seo-competitor-pages
+source: claude-seo
+attribution: |
+  Originally from https://github.com/AgriciDaniel/claude-seo
+  License: MIT (see LICENSE.claude-seo)
+converted: 2026-03-09T07:40:30.000Z
+framework: StringRay v1.7.5
+---
+
+---
+name: seo-competitor-pages
+description: >
+  Generate SEO-optimized competitor comparison and alternatives pages. Covers
+  "X vs Y" layouts, "alternatives to X" pages, feature matrices, schema markup,
+  and conversion optimization. Use when user says "comparison page", "vs page",
+  "alternatives page", "competitor comparison", or "X vs Y".
+---
+
+# Competitor Comparison & Alternatives Pages
+
+Create high-converting comparison and alternatives pages that target
+competitive intent keywords with accurate, structured content.
+
+## Page Types
+
+### 1. "X vs Y" Comparison Pages
+- Direct head-to-head comparison between two products/services
+- Balanced feature-by-feature analysis
+- Clear verdict or recommendation with justification
+- Target keyword: `[Product A] vs [Product B]`
+
+### 2. "Alternatives to X" Pages
+- List of alternatives to a specific product/service
+- Each alternative with brief summary, pros/cons, best-for use case
+- Target keyword: `[Product] alternatives`, `best alternatives to [Product]`
+
+### 3. "Best [Category] Tools" Roundup Pages
+- Curated list of top tools/services in a category
+- Ranking criteria clearly stated
+- Target keyword: `best [category] tools [year]`, `top [category] software`
+
+### 4. Comparison Table Pages
+- Feature matrix with multiple products in columns
+- Sortable/filterable if interactive
+- Target keyword: `[category] comparison`, `[category] comparison chart`
+
+## Comparison Table Generation
+
+### Feature Matrix Layout
+```
+| Feature          | Your Product | Competitor A | Competitor B |
+|------------------|:------------:|:------------:|:------------:|
+| Feature 1        | ✅           | ✅           | ❌           |
+| Feature 2        | ✅           | ⚠️ Partial   | ✅           |
+| Feature 3        | ✅           | ❌           | ❌           |
+| Pricing (from)   | $X/mo        | $Y/mo        | $Z/mo        |
+| Free Tier        | ✅           | ❌           | ✅           |
+```
+
+### Data Accuracy Requirements
+- All feature claims must be verifiable from public sources
+- Pricing must be current (include "as of [date]" note)
+- Update frequency: review quarterly or when competitors ship major changes
+- Link to source for each competitor data point where possible
+
+## Schema Markup Recommendations
+
+### Product Schema with AggregateRating
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Product",
+  "name": "[Product Name]",
+  "description": "[Product Description]",
+  "brand": {
+    "@type": "Brand",
+    "name": "[Brand Name]"
+  },
+  "aggregateRating": {
+    "@type": "AggregateRating",
+    "ratingValue": "[Rating]",
+    "reviewCount": "[Count]",
+    "bestRating": "5",
+    "worstRating": "1"
+  }
+}
+```
+
+### SoftwareApplication (for software comparisons)
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "SoftwareApplication",
+  "name": "[Software Name]",
+  "applicationCategory": "[Category]",
+  "operatingSystem": "[OS]",
+  "offers": {
+    "@type": "Offer",
+    "price": "[Price]",
+    "priceCurrency": "USD"
+  }
+}
+```
+
+### ItemList (for roundup pages)
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "ItemList",
+  "name": "Best [Category] Tools [Year]",
+  "itemListOrder": "https://schema.org/ItemListOrderDescending",
+  "numberOfItems": "[Count]",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "[Product Name]",
+      "url": "[Product URL]"
+    }
+  ]
+}
+```
+
+## Keyword Targeting
+
+### Comparison Intent Patterns
+| Pattern | Example | Search Volume Signal |
+|---------|---------|---------------------|
+| `[A] vs [B]` | "Slack vs Teams" | High |
+| `[A] alternative` | "Figma alternatives" | High |
+| `[A] alternatives [year]` | "Notion alternatives 2026" | High |
+| `best [category] tools` | "best project management tools" | High |
+| `[A] vs [B] for [use case]` | "AWS vs Azure for startups" | Medium |
+| `[A] review [year]` | "Monday.com review 2026" | Medium |
+| `[A] vs [B] pricing` | "HubSpot vs Salesforce pricing" | Medium |
+| `is [A] better than [B]` | "is Notion better than Confluence" | Medium |
+
+### Title Tag Formulas
+- X vs Y: `[A] vs [B]: [Key Differentiator] ([Year])`
+- Alternatives: `[N] Best [A] Alternatives in [Year] (Free & Paid)`
+- Roundup: `[N] Best [Category] Tools in [Year] — Compared & Ranked`
+
+### H1 Patterns
+- Match title tag intent
+- Include primary keyword naturally
+- Keep under 70 characters
+
+## Conversion-Optimized Layouts
+
+### CTA Placement
+- **Above fold**: Brief comparison summary with primary CTA
+- **After comparison table**: "Try [Your Product] free" CTA
+- **Bottom of page**: Final recommendation with CTA
+- Avoid aggressive CTAs in competitor description sections (reduces trust)
+
+### Social Proof Sections
+- Customer testimonials relevant to comparison criteria
+- G2/Capterra/TrustPilot ratings (with source links)
+- Case studies showing migration from competitor
+- "Switched from [Competitor]" stories
+
+### Pricing Highlights
+- Clear pricing comparison table
+- Highlight value advantages (not just lowest price)
+- Include hidden costs (setup fees, per-user pricing, overage charges)
+- Link to full pricing page
+
+### Trust Signals
+- "Last updated [date]" timestamp
+- Author with relevant expertise
+- Methodology disclosure (how comparisons were conducted)
+- Disclosure of own product affiliation
+
+## Fairness Guidelines
+
+- **Accuracy**: All competitor information must be verifiable from public sources
+- **No defamation**: Never make false or misleading claims about competitors
+- **Cite sources**: Link to competitor websites, review sites, or documentation
+- **Timely updates**: Review and update when competitors release major changes
+- **Disclose affiliation**: Clearly state which product is yours
+- **Balanced presentation**: Acknowledge competitor strengths honestly
+- **Pricing accuracy**: Include "as of [date]" disclaimers on all pricing data
+- **Feature verification**: Test competitor features where possible, cite documentation otherwise
+
+## Internal Linking
+
+- Link to your own product/service pages from comparison sections
+- Cross-link between related comparison pages (e.g., "A vs B" links to "A vs C")
+- Link to feature-specific pages when discussing individual features
+- Breadcrumb: Home > Comparisons > [This Page]
+- Related comparisons section at bottom of page
+- Link to case studies and testimonials mentioned in the comparison
+
+## Output
+
+### Comparison Page Template
+- `COMPARISON-PAGE.md` — Ready-to-implement page structure with sections
+- Feature matrix table
+- Content outline with word count targets (minimum 1,500 words)
+
+### Schema Markup
+- `comparison-schema.json` — Product/SoftwareApplication/ItemList JSON-LD
+
+### Keyword Strategy
+- Primary and secondary keywords
+- Related long-tail opportunities
+- Content gaps vs existing competitor pages
+
+### Recommendations
+- Content improvements for existing comparison pages
+- New comparison page opportunities
+- Schema markup additions
+- Conversion optimization suggestions
+
+
+---
+
+*This skill was integrated into StringRay via the claude-seo integration script.*
+*Original source: https://github.com/AgriciDaniel/claude-seo*