@bluefly/openstandardagents 0.2.9 → 0.3.0

package/bin/validate-ossa-0.2.2.ts

@@ -1,244 +0,0 @@
-#!/usr/bin/env node
-/**
- * OSSA 0.2.2 Validation Tool
- * Validates power-suite modules' ossa.yaml files against OSSA 0.2.2 schema
- */
-
-import { readFileSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { parse as parseYaml } from 'yaml';
-import Ajv from 'ajv';
-import addFormats from 'ajv-formats';
-import chalk from 'chalk';
-
-// ES module __dirname equivalent
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Load OSSA 0.2.2 schema
-const schemaPath = resolve(__dirname, '../spec/v0.2.2/ossa-0.2.2.schema.json');
-const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));
-
-// Initialize AJV validator
-const ajv = new Ajv({
-  allErrors: true,
-  strict: false,
-  validateFormats: true,
-  verbose: true,
-});
-
-addFormats(ajv);
-
-// Note: The power-suite ossa.yaml files use a different format (project config)
-// than full agent manifests. This validator checks for OSSA 0.2.2 compliance
-// in the project configuration format.
-
-interface PowerSuiteOssaConfig {
-  ossa?: {
-    version: string;
-    project?: {
-      name: string;
-      type: string;
-      version: string;
-      description: string;
-    };
-    metadata?: {
-      reasoning?: boolean;
-      compliance?: {
-        frameworks?: string[];
-      };
-    };
-    ecosystem?: {
-      mesh_enabled?: boolean;
-      protocol_enabled?: boolean;
-      router_enabled?: boolean;
-      tracer_enabled?: boolean;
-      brain_enabled?: boolean;
-      flows_enabled?: boolean;
-      [key: string]: unknown;
-    };
-    [key: string]: unknown;
-  };
-}
-
-/**
- * Validate OSSA 0.2.2 configuration format
- */
-function validatePowerSuiteConfig(config: PowerSuiteOssaConfig): {
-  valid: boolean;
-  errors: string[];
-  warnings: string[];
-} {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  if (!config.ossa) {
-    errors.push('Missing top-level "ossa" key');
-    return { valid: false, errors, warnings };
-  }
-
-  const { ossa } = config;
-
-  // Check version
-  if (!ossa.version) {
-    errors.push('Missing ossa.version');
-  } else if (!ossa.version.startsWith('0.2.2')) {
-    errors.push(
-      `Invalid ossa.version: expected "0.2.2" or "0.2.2.x", got "${ossa.version}"`
-    );
-  }
-
-  // Check project
-  if (!ossa.project) {
-    warnings.push('Missing ossa.project (recommended for identification)');
-  } else {
-    if (!ossa.project.name) {
-      errors.push('Missing ossa.project.name');
-    }
-    if (!ossa.project.type) {
-      warnings.push('Missing ossa.project.type');
-    }
-  }
-
-  // Check metadata (OSSA 0.2.2 requirement)
-  if (!ossa.metadata) {
-    warnings.push(
-      'Missing ossa.metadata (OSSA 0.2.2 recommends metadata.reasoning)'
-    );
-  } else {
-    if (ossa.metadata.reasoning === undefined) {
-      warnings.push(
-        'OSSA 0.2.2 recommends metadata.reasoning: true for AI agents'
-      );
-    }
-    if (!ossa.metadata.compliance?.frameworks) {
-      warnings.push(
-        'OSSA 0.2.2 recommends metadata.compliance.frameworks array'
-      );
-    }
-  }
-
-  // Check ecosystem (power-suite integration)
-  if (!ossa.ecosystem) {
-    warnings.push(
-      'Missing ossa.ecosystem (power-suite integration configuration)'
-    );
-  } else {
-    const ecosystem = ossa.ecosystem;
-    const requiredModules = [
-      'mesh_enabled',
-      'protocol_enabled',
-      'router_enabled',
-      'tracer_enabled',
-      'brain_enabled',
-      'flows_enabled',
-    ];
-
-    for (const module of requiredModules) {
-      if (ecosystem[module] === undefined) {
-        warnings.push(
-          `Consider setting ossa.ecosystem.${module} for power-suite integration`
-        );
-      }
-    }
-  }
-
-  // Check compliance standards array
-  if (ossa.compliance?.standards) {
-    const standards = Array.isArray(ossa.compliance.standards)
-      ? ossa.compliance.standards
-      : Object.values(ossa.compliance.standards);
-
-    if (!standards.includes('OSSA-0.2.2')) {
-      errors.push(
-        'compliance.standards must include "OSSA-0.2.2" for v0.2.2 compliance'
-      );
-    }
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-    warnings,
-  };
-}
-
-/**
- * Validate a single ossa.yaml file
- */
-function validateFile(filePath: string): boolean {
-  try {
-    const content = readFileSync(filePath, 'utf-8');
-    const config = parseYaml(content) as PowerSuiteOssaConfig;
-
-    console.log(chalk.blue(`\nValidating: ${filePath}`));
-    console.log(chalk.gray('─'.repeat(80)));
-
-    const result = validatePowerSuiteConfig(config);
-
-    if (result.valid) {
-      console.log(chalk.green('✓ Valid OSSA 0.2.2 configuration'));
-    } else {
-      console.log(chalk.red('✗ Invalid OSSA 0.2.2 configuration'));
-      result.errors.forEach((error) => {
-        console.log(chalk.red(`  ERROR: ${error}`));
-      });
-    }
-
-    if (result.warnings.length > 0) {
-      result.warnings.forEach((warning) => {
-        console.log(chalk.yellow(`  WARNING: ${warning}`));
-      });
-    }
-
-    return result.valid;
-  } catch (error) {
-    console.error(chalk.red(`Failed to validate ${filePath}:`));
-    console.error(error);
-    return false;
-  }
-}
-
-/**
- * Main validation function
- */
-function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0) {
-    console.log(chalk.blue('OSSA 0.2.2 Power-Suite Validation Tool\n'));
-    console.log('Usage:');
-    console.log('  validate-ossa-0.2.2.ts <file1.yaml> [file2.yaml] ...\n');
-    console.log('Or validate all power-suite modules:');
-    console.log(
-      '  find ../common_npm -name "ossa.yaml" -o -path "*/config/ossa.yaml" | xargs validate-ossa-0.2.2.ts'
-    );
-    process.exit(1);
-  }
-
-  let allValid = true;
-  for (const filePath of args) {
-    const valid = validateFile(resolve(filePath));
-    if (!valid) {
-      allValid = false;
-    }
-  }
-
-  console.log(chalk.gray('\n' + '─'.repeat(80)));
-  if (allValid) {
-    console.log(chalk.green('\n✓ All files are OSSA 0.2.2 compliant'));
-    process.exit(0);
-  } else {
-    console.log(chalk.red('\n✗ Some files failed validation'));
-    process.exit(1);
-  }
-}
-
-// Run if executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  main();
-}
-
-export { validatePowerSuiteConfig, validateFile };
-

package/bin/validate-ossa-0.2.4.ts

@@ -1,244 +0,0 @@
-#!/usr/bin/env node
-/**
- * OSSA 0.2.4 Validation Tool
- * Validates power-suite modules' ossa.yaml files against OSSA 0.2.4 schema
- */
-
-import { readFileSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { parse as parseYaml } from 'yaml';
-import Ajv from 'ajv';
-import addFormats from 'ajv-formats';
-import chalk from 'chalk';
-
-// ES module __dirname equivalent
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Load OSSA 0.2.4 schema
-const schemaPath = resolve(__dirname, '../spec/v0.2.4/ossa-0.2.4.schema.json');
-const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));
-
-// Initialize AJV validator
-const ajv = new Ajv({
-  allErrors: true,
-  strict: false,
-  validateFormats: true,
-  verbose: true,
-});
-
-addFormats(ajv);
-
-// Note: The power-suite ossa.yaml files use a different format (project config)
-// than full agent manifests. This validator checks for OSSA 0.2.4 compliance
-// in the project configuration format.
-
-interface PowerSuiteOssaConfig {
-  ossa?: {
-    version: string;
-    project?: {
-      name: string;
-      type: string;
-      version: string;
-      description: string;
-    };
-    metadata?: {
-      reasoning?: boolean;
-      compliance?: {
-        frameworks?: string[];
-      };
-    };
-    ecosystem?: {
-      mesh_enabled?: boolean;
-      protocol_enabled?: boolean;
-      router_enabled?: boolean;
-      tracer_enabled?: boolean;
-      brain_enabled?: boolean;
-      flows_enabled?: boolean;
-      [key: string]: unknown;
-    };
-    [key: string]: unknown;
-  };
-}
-
-/**
- * Validate OSSA 0.2.4 configuration format
- */
-function validatePowerSuiteConfig(config: PowerSuiteOssaConfig): {
-  valid: boolean;
-  errors: string[];
-  warnings: string[];
-} {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  if (!config.ossa) {
-    errors.push('Missing top-level "ossa" key');
-    return { valid: false, errors, warnings };
-  }
-
-  const { ossa } = config;
-
-  // Check version
-  if (!ossa.version) {
-    errors.push('Missing ossa.version');
-  } else if (!ossa.version.startsWith('0.2.4')) {
-    errors.push(
-      `Invalid ossa.version: expected "0.2.4" or "0.2.4.x", got "${ossa.version}"`
-    );
-  }
-
-  // Check project
-  if (!ossa.project) {
-    warnings.push('Missing ossa.project (recommended for identification)');
-  } else {
-    if (!ossa.project.name) {
-      errors.push('Missing ossa.project.name');
-    }
-    if (!ossa.project.type) {
-      warnings.push('Missing ossa.project.type');
-    }
-  }
-
-  // Check metadata (OSSA 0.2.4 requirement)
-  if (!ossa.metadata) {
-    warnings.push(
-      'Missing ossa.metadata (OSSA 0.2.4 recommends metadata.reasoning)'
-    );
-  } else {
-    if (ossa.metadata.reasoning === undefined) {
-      warnings.push(
-        'OSSA 0.2.4 recommends metadata.reasoning: true for AI agents'
-      );
-    }
-    if (!ossa.metadata.compliance?.frameworks) {
-      warnings.push(
-        'OSSA 0.2.4 recommends metadata.compliance.frameworks array'
-      );
-    }
-  }
-
-  // Check ecosystem (power-suite integration)
-  if (!ossa.ecosystem) {
-    warnings.push(
-      'Missing ossa.ecosystem (power-suite integration configuration)'
-    );
-  } else {
-    const ecosystem = ossa.ecosystem;
-    const requiredModules = [
-      'mesh_enabled',
-      'protocol_enabled',
-      'router_enabled',
-      'tracer_enabled',
-      'brain_enabled',
-      'flows_enabled',
-    ];
-
-    for (const module of requiredModules) {
-      if (ecosystem[module] === undefined) {
-        warnings.push(
-          `Consider setting ossa.ecosystem.${module} for power-suite integration`
-        );
-      }
-    }
-  }
-
-  // Check compliance standards array
-  if (ossa.compliance?.standards) {
-    const standards = Array.isArray(ossa.compliance.standards)
-      ? ossa.compliance.standards
-      : Object.values(ossa.compliance.standards);
-
-    if (!standards.includes('OSSA-0.2.4')) {
-      errors.push(
-        'compliance.standards must include "OSSA-0.2.4" for v0.2.4 compliance'
-      );
-    }
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-    warnings,
-  };
-}
-
-/**
- * Validate a single ossa.yaml file
- */
-function validateFile(filePath: string): boolean {
-  try {
-    const content = readFileSync(filePath, 'utf-8');
-    const config = parseYaml(content) as PowerSuiteOssaConfig;
-
-    console.log(chalk.blue(`\nValidating: ${filePath}`));
-    console.log(chalk.gray('─'.repeat(80)));
-
-    const result = validatePowerSuiteConfig(config);
-
-    if (result.valid) {
-      console.log(chalk.green('✓ Valid OSSA 0.2.4 configuration'));
-    } else {
-      console.log(chalk.red('✗ Invalid OSSA 0.2.4 configuration'));
-      result.errors.forEach((error) => {
-        console.log(chalk.red(`  ERROR: ${error}`));
-      });
-    }
-
-    if (result.warnings.length > 0) {
-      result.warnings.forEach((warning) => {
-        console.log(chalk.yellow(`  WARNING: ${warning}`));
-      });
-    }
-
-    return result.valid;
-  } catch (error) {
-    console.error(chalk.red(`Failed to validate ${filePath}:`));
-    console.error(error);
-    return false;
-  }
-}
-
-/**
- * Main validation function
- */
-function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0) {
-    console.log(chalk.blue('OSSA 0.2.4 Power-Suite Validation Tool\n'));
-    console.log('Usage:');
-    console.log('  validate-ossa-0.2.4.ts <file1.yaml> [file2.yaml] ...\n');
-    console.log('Or validate all power-suite modules:');
-    console.log(
-      '  find ../common_npm -name "ossa.yaml" -o -path "*/config/ossa.yaml" | xargs validate-ossa-0.2.4.ts'
-    );
-    process.exit(1);
-  }
-
-  let allValid = true;
-  for (const filePath of args) {
-    const valid = validateFile(resolve(filePath));
-    if (!valid) {
-      allValid = false;
-    }
-  }
-
-  console.log(chalk.gray('\n' + '─'.repeat(80)));
-  if (allValid) {
-    console.log(chalk.green('\n✓ All files are OSSA 0.2.4 compliant'));
-    process.exit(0);
-  } else {
-    console.log(chalk.red('\n✗ Some files failed validation'));
-    process.exit(1);
-  }
-}
-
-// Run if executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  main();
-}
-
-export { validatePowerSuiteConfig, validateFile };
-

package/docs/brand-guide/01-brand-overview.md

@@ -1,37 +0,0 @@
-# OSSA Brand Overview
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Mission
-
-**Make AI agents interoperable across all platforms and frameworks.**
-
-OSSA (Open Standard for Scalable AI Agents) provides a vendor-neutral specification standard that enables AI agents to communicate and collaborate seamlessly.
-
-## Vision
-
-**Become the OpenAPI for AI agents** - the universally adopted standard for defining, deploying, and connecting autonomous AI systems.
-
-## Core Values
-
-### 1. Open & Vendor-Neutral
-Community-driven, no vendor lock-in, Apache 2.0 license
-
-### 2. Interoperable  
-Common language across frameworks, runtime-independent
-
-### 3. Trustworthy
-Compliance-ready, security built-in, enterprise-grade
-
-### 4. Simple & Practical
-Clear specification, production-ready implementations
-
-## Key Messages
-
-**Primary:** "The OpenAPI for AI Agents"
-
-**For Enterprises:** Deploy anywhere, switch frameworks anytime, maintain compliance always
-
-**For Developers:** Write once, deploy anywhere - portable and future-proof
-
-**For Framework Builders:** Build on an open standard

package/docs/brand-guide/02-logo-usage.md

@@ -1,43 +0,0 @@
-# OSSA Logo Usage Guidelines
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Primary Logo
-
-Dynamic gradient-based mark representing interconnected AI agents.
-
-**Location:** `/website/public/brand/ossa-logo.svg`
-
-**Colors:** Gradient from Cyan Blue (#1CB9ED) → Deep Purple (#4A3ECD) → Light Purple (#9060EA)
-
-## Logo Variations
-
-- **Full Color:** White/light backgrounds
-- **Monochrome White:** Dark backgrounds (#FFFFFF)
-- **Monochrome Dark:** Light backgrounds, print (#2D1B69)
-- **Grayscale:** Print only (#374151)
-
-## Minimum Sizes
-
-- **Digital:** 120px width min (180px recommended)
-- **Print:** 1 inch min (1.5 inches recommended)
-- **Icon:** 16px, 32px, 64px, 128px
-
-## Clear Space
-
-Maintain clear space = **0.5× logo height** on all sides
-
-## Incorrect Usage
-
-❌ Don't change colors
-❌ Don't distort/stretch
-❌ Don't add effects
-❌ Don't modify
-❌ Don't use low-quality
-
-## Background Guidelines
-
-✅ White, light gray, light blue, dark purple, black
-❌ Bright colors, busy patterns, low-contrast
-
-**Rule:** 4.5:1 minimum contrast ratio

package/docs/brand-guide/03-color-palette.md

@@ -1,70 +0,0 @@
-# OSSA Color Palette
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Primary Brand Colors
-
-### Deep Purple (Primary)
-**Base:** `#4A3ECD`
-**Usage:** Primary actions, branding, emphasis
-**Scale:** 50-950 (see full guide)
-
-### Cyan Blue (Secondary)  
-**Base:** `#1CB9ED`
-**Usage:** Secondary actions, accents, gradients
-**Scale:** 50-950
-
-### Light Purple (Accent)
-**Base:** `#9060EA`  
-**Usage:** Decorative accents, gradient endpoints
-**Scale:** 50-950
-
-### Dark Purple (Depth)
-**Base:** `#2D1B69`
-**Usage:** Dark backgrounds, dark mode, contrast
-**Scale:** 50-950
-
-## Semantic Colors
-
-- **Success:** `#10B981` (Green)
-- **Warning:** `#F59E0B` (Amber)
-- **Error:** `#EF4444` (Red)
-- **Info:** `#06B6D4` (Cyan)
-
-## Neutrals (Grays)
-
-**Scale:** `#F9FAFB` (50) to `#111827` (900)
-
-**Common Uses:**
-- Primary text: Gray-700 (#374151) or Gray-900
-- Secondary text: Gray-600 (#4B5563)
-- Borders: Gray-200 (#E5E7EB) or Gray-300
-- Backgrounds: White, Gray-50, Gray-100
-
-## Gradients
-
-### Brand Gradient
-```css
-background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 40%, #4A3ECD 70%, #9060EA 100%);
-```
-
-### Hero Gradient
-```css
-background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 35%, #4A3ECD 65%, #9060EA 100%);
-```
-
-## Accessibility
-
-All combinations meet WCAG AA minimum (AAA preferred):
-- Normal text: 4.5:1 minimum (7:1 target)
-- Large text: 3:1 minimum (4.5:1 target)
-- UI components: 3:1 minimum
-
-**White text on:**
-- Primary-500+: ✅ AAA (7.5:1)
-- Secondary-600+: ✅ AA (4.7:1)
-- Dark Purple-700+: ✅ AAA (10:1+)
-
-**Black text on:**
-- Gray-50 to Gray-300: ✅ AAA (8:1+)
-- Primary-50 to Primary-400: ✅ AAA (7:1+)