@bluefly/openstandardagents 0.2.9 → 0.3.0

package/docs/brand-guide/04-typography.md

@@ -1,82 +0,0 @@
-# OSSA Typography Guidelines
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Font Families
-
-### Primary: Inter (Sans-serif)
-**Usage:** UI, headings, body text, marketing
-**Weights:** 400 (Regular), 500 (Medium), 600 (Semi-Bold), 700 (Bold), 800 (Extra-Bold)
-**Why:** Exceptional legibility, optimized for screens, 200+ languages
-
-### Monospace: JetBrains Mono
-**Usage:** Code blocks, inline code, technical content
-**Weights:** 400 (Regular), 500 (Medium), 600 (Semi-Bold)
-**Why:** Developer-focused, excellent ligatures, clear character distinction
-
-## Type Scale
-
-| Element | Size | Line Height | Weight | Color |
-|---------|------|-------------|--------|-------|
-| **Display** | 72px (4.5rem) | 1.1 | 800 | Gray-900 or Gradient |
-| **H1** | 56px (3.5rem) | 1.2 | 700 | Gray-900 or Primary-500 |
-| **H2** | 40px (2.5rem) | 1.3 | 700 | Gray-900 |
-| **H3** | 32px (2rem) | 1.4 | 600 | Gray-900 |
-| **H4** | 24px (1.5rem) | 1.5 | 600 | Gray-800 |
-| **H5** | 20px (1.25rem) | 1.5 | 600 | Gray-800 |
-| **H6** | 18px (1.125rem) | 1.5 | 600 | Gray-700 |
-| **Body** | 16px (1rem) | 1.6 | 400 | Gray-700 |
-| **Body Large** | 18px (1.125rem) | 1.6 | 400 | Gray-700 |
-| **Small** | 14px (0.875rem) | 1.5 | 400 | Gray-600 |
-| **Extra Small** | 12px (0.75rem) | 1.5 | 400 | Gray-500 |
-
-## Letter Spacing
-
-- **Display:** -0.02em (tighter for large sizes)
-- **H1:** -0.01em (slightly tighter)
-- **H2-H6, Body:** 0 (normal)
-- **All Caps:** 0.05em (improve readability)
-
-## Code Typography
-
-### Inline Code
-- Font: JetBrains Mono, 0.875em
-- Color: Primary-700 (#322598)
-- Background: Primary-50 (#F5F4FD)
-- Padding: 0.2em 0.4em
-- Border Radius: 4px
-
-### Code Blocks
-- Font: JetBrains Mono, 14px (0.875rem)
-- Color: #D4D4D4 (light gray on dark)
-- Background: #1E1E1E (dark gray)
-- Line Height: 1.6
-- Padding: 16px
-- Border Radius: 8px
-
-## Responsive Typography
-
-**Mobile (< 768px):**
-- Display: 40px
-- H1: 36px
-- H2: 28px
-
-**Tablet (768-1279px):**
-- Display: 56px
-- H1: 48px
-- H2: 32px
-
-**Desktop (1280px+):**
-- Use full scale (above)
-
-## Accessibility
-
-✅ Line height: 1.5 minimum for body (we use 1.6)
-✅ Contrast: All text meets WCAG AA minimum (AAA preferred)
-✅ Font size: Never below 12px (prefer 14px minimum)
-✅ Zoom: Support up to 200% without loss of functionality
-
-**Text Contrast:**
-- Primary text: Gray-700 on white (10.5:1 AAA)
-- Secondary text: Gray-600 on white (7.4:1 AAA)
-- Links: Primary-500 on white (6.1:1 AA)

package/docs/brand-guide/05-voice-and-tone.md

@@ -1,108 +0,0 @@
-# OSSA Voice & Tone Guidelines
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Brand Voice
-
-OSSA's voice is consistent across all communications:
-
-### 1. Professional
-Enterprise-grade standard with technical authority
-- Use precise technical language
-- Cite specifications and standards
-- Maintain formal structure in documentation
-
-### 2. Clear
-Technical but accessible
-- Define acronyms on first use
-- Use analogies ("The OpenAPI for AI agents")
-- Break complex topics into chunks
-
-### 3. Confident
-Proven and production-ready
-- Use active voice
-- Make definitive statements when true
-- Reference real-world deployments
-
-### 4. Inclusive
-Community-driven and open to everyone
-- Use "we" for community
-- Welcome all skill levels
-- Use gender-neutral language
-
-### 5. Practical
-Real-world solutions, not theory
-- Provide working code examples
-- Link to reference implementations
-- Give step-by-step instructions
-
-## Tone Variations
-
-### Technical Documentation
-**Audience:** Developers, architects, engineers
-**Tone:** Precise, formal, comprehensive
-- Formal structure
-- Technical precision
-- Complete information
-- Reference links
-
-### Marketing & Website
-**Audience:** Decision-makers, evaluators
-**Tone:** Confident, clear, persuasive
-- Benefit-focused
-- Clear value propositions
-- Social proof
-- Strong CTAs
-
-### Community & Support
-**Audience:** Contributors, users
-**Tone:** Helpful, encouraging, collaborative
-- Welcoming and supportive
-- Providing guidance
-- Encouraging participation
-
-### Error Messages
-**Audience:** Users encountering issues
-**Tone:** Clear, helpful, solution-oriented
-- State problem clearly
-- Explain why it happened
-- Provide actionable solutions
-- Link to documentation
-
-## Writing Guidelines
-
-**Active vs. Passive:**
-✅ Prefer active voice for clarity
-❌ Avoid passive unless actor unknown
-
-**Pronouns:**
-- We = OSSA project, community
-- You = Reader, user, developer
-- They/Them = Generic third-party
-
-**Contractions:**
-- Technical Docs: Avoid contractions
-- Marketing: Acceptable for approachability
-
-**Numbers:**
-- Spell out 1-9
-- Use numerals for 10+
-- Always numerals for technical specs
-
-## Prohibited Language
-
-❌ Ableist language (crazy, insane, lame)
-❌ Violent metaphors (killer, crushed, decimated)
-❌ Gendered language (guys, manpower, he/she)
-❌ Exclusive language (obviously, clearly, simply, just)
-❌ Vague intensifiers (very, really, extremely)
-
-## 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. We provide the contract, you provide the innovation."

package/docs/brand-guide/06-visual-elements.md

@@ -1,137 +0,0 @@
-# OSSA Visual Elements
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Gradients
-
-### Brand Gradient (Primary)
-```css
-background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 40%, #4A3ECD 70%, #9060EA 100%);
-```
-**Usage:** Headers, hero sections, primary emphasis
-
-### Hero Gradient
-```css
-background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 35%, #4A3ECD 65%, #9060EA 100%);
-```
-
-### Button Gradient
-```css
-background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 45%, #4A3ECD 75%, #9060EA 100%);
-```
-
-## Icons
-
-**Style:** Outline/Stroke icons (Heroicons style)
-**Stroke Width:** 1.5px (default), 2px (emphasis)
-**Sizes:** 16px, 20px, 24px, 32px, 48px, 64px
-**Library:** Heroicons or Lucide React
-
-**Usage:**
-- Navigation: 24px
-- Actions: 20px
-- Status: 24px
-- External links: 16px
-
-## Shadows
-
-```css
---shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.04);
---shadow-md: 0 2px 8px rgba(0, 0, 0, 0.04);
---shadow-lg: 0 8px 24px rgba(0, 0, 0, 0.08);
---shadow-xl: 0 16px 48px rgba(0, 0, 0, 0.12);
---shadow-brand: 0 8px 16px rgba(74, 62, 205, 0.3);
-```
-
-## Border Radius
-
-```css
---radius-sm: 4px;    /* Badges */
---radius-md: 8px;    /* Buttons, inputs */
---radius-lg: 12px;   /* Cards */
---radius-xl: 16px;   /* Modals */
---radius-2xl: 24px;  /* Hero elements */
---radius-full: 9999px; /* Avatars, pills */
-```
-
-## Spacing
-
-**Base Grid:** 4px
-
-```css
---space-1: 4px    --space-6: 24px
---space-2: 8px    --space-8: 32px
---space-3: 12px   --space-10: 40px
---space-4: 16px   --space-12: 48px
---space-5: 20px   --space-16: 64px
-```
-
-## Buttons
-
-### Primary Button
-- Background: Primary-500 or Gradient
-- Text: White
-- Padding: 12px 24px
-- Border Radius: 8px
-- Hover: Primary-600 + shadow-lg + translateY(-1px)
-- Focus: Ring (3px, Primary-300)
-
-### Secondary Button
-- Background: Secondary-500
-- Text: White
-- Hover: Secondary-600
-
-### Outline Button
-- Border: 2px Primary-500
-- Text: Primary-500
-- Hover: Background Primary-500, text white
-
-### Ghost Button
-- Text: Primary-500
-- Hover: Background Primary-50
-
-## Cards
-
-**Default Card:**
-- Background: White
-- Border: 1px Gray-200
-- Border Radius: 12px
-- Padding: 24px
-- Shadow: shadow-sm
-
-**Interactive Card (Hover):**
-- Border: Primary
-- Shadow: shadow-xl
-- Transform: translateY(-4px)
-
-**Featured Card:**
-- Background: Gradient (subtle, low opacity)
-- Border: 2px Primary-200
-
-## Badges
-
-**Style:**
-- Padding: 4px 12px
-- Border Radius: 9999px
-- Font Size: 12px
-- Font Weight: 600
-- Text Transform: Uppercase
-- Letter Spacing: 0.05em
-
-**Variants:** Primary, Success, Warning, Error, Neutral
-
-## Animations
-
-**Timing:**
-- Fast: 150ms ease (hover, color changes)
-- Base: 200ms ease (default)
-- Slow: 300ms ease (page transitions, modals)
-
-**Respect:** `prefers-reduced-motion`
-
-## Accessibility
-
-✅ Contrast: WCAG AA minimum (4.5:1 text, 3:1 UI)
-✅ Focus: Visible 3px rings, 3:1 contrast
-✅ Touch Targets: 44×44px minimum (48×48px preferred)
-✅ Alt Text: All logos and images

package/docs/brand-guide/07-application-examples.md

@@ -1,153 +0,0 @@
-# OSSA Brand Application Examples
-
-> Version 1.0.0 | Last Updated: November 2025
-
-## Website Hero
-
-```html
-<section class="hero bg-gradient-hero py-24 text-center">
-  <img src="/brand/ossa-logo.svg" alt="OSSA Logo" class="h-32 mx-auto mb-8">
-  <h1 class="text-display font-extrabold text-gray-900 mb-6">
-    The <span class="gradient-text">OpenAPI</span> for AI Agents
-  </h1>
-  <p class="text-body-large text-gray-700 max-w-3xl mx-auto mb-12">
-    Universal specification standard for interoperable AI agents
-  </p>
-  <div class="flex gap-4 justify-center">
-    <a href="#start" class="btn-primary">Get Started</a>
-    <a href="/docs" class="btn-outline">Documentation</a>
-  </div>
-</section>
-```
-
-## Feature Cards
-
-```html
-<div class="card card-interactive">
-  <div class="icon-container bg-primary-100 rounded-lg p-3 mb-4">
-    <svg class="icon-24 text-primary-600"><!-- Icon --></svg>
-  </div>
-  <h3 class="text-h4 font-semibold mb-3">Vendor-Neutral</h3>
-  <p class="text-body text-gray-700">
-    No vendor lock-in. Deploy anywhere, switch frameworks anytime.
-  </p>
-</div>
-```
-
-## Navigation Header
-
-```html
-<header class="sticky top-0 bg-white/95 backdrop-blur border-b border-gray-200">
-  <div class="container flex items-center justify-between h-16">
-    <a href="/" class="flex items-center gap-3">
-      <img src="/brand/ossa-logo.svg" alt="OSSA" class="h-8">
-      <div>
-        <div class="font-bold text-lg text-primary-600">OSSA</div>
-        <div class="text-xs text-gray-500">AI Agent Standard</div>
-      </div>
-    </a>
-    <nav class="flex gap-8">
-      <a href="/docs" class="nav-link active">Docs</a>
-      <a href="/examples" class="nav-link">Examples</a>
-    </nav>
-    <a href="#start" class="btn-primary">Get Started</a>
-  </div>
-</header>
-```
-
-## Documentation Page
-
-```html
-<div class="docs-layout flex">
-  <aside class="sidebar w-64 border-r p-6">
-    <a href="#" class="sidebar-link active">Installation</a>
-    <a href="#" class="sidebar-link">Quick Start</a>
-  </aside>
-  <main class="flex-1 max-w-4xl p-12">
-    <h1 class="text-h1 mb-6">Installation</h1>
-    <p class="text-body mb-4">Install OSSA using npm:</p>
-    <pre class="code-block"><code>npm install -g @bluefly/openstandardagents</code></pre>
-  </main>
-</div>
-```
-
-## Social Media
-
-**Twitter Card (1200×675px):**
-- Background: Gradient or white
-- Logo: 200px centered
-- Title: H2, bold
-- Description: Body text
-- CTA button
-- URL at bottom
-
-**GitHub Preview (1280×640px):**
-- Logo + "OSSA" + tagline
-- Large headline
-- Key features (checkmarks)
-- Repository URL
-
-## Email Template
-
-```html
-<table width="600" cellpadding="0" cellspacing="0">
-  <!-- Header with gradient background -->
-  <tr><td style="padding: 32px; background: linear-gradient(135deg, #1CB9ED, #4A3ECD, #9060EA);">
-    <img src="logo-white.svg" alt="OSSA" width="120">
-  </td></tr>
-  
-  <!-- Content -->
-  <tr><td style="padding: 32px; background: white;">
-    <h2 style="color: #4A3ECD;">What's New</h2>
-    <p style="color: #374151;">OSSA v0.2.5 released...</p>
-    <a href="..." style="display: inline-block; padding: 12px 32px; 
-       background: #4A3ECD; color: white; border-radius: 8px;">
-      Get Started
-    </a>
-  </td></tr>
-  
-  <!-- Footer -->
-  <tr><td style="padding: 24px; background: #F3F4F6; text-align: center;">
-    <p style="color: #6B7280;">openstandardagents.org</p>
-  </td></tr>
-</table>
-```
-
-## Presentation Slides
-
-**Title Slide:**
-- Centered logo (180px)
-- Title: Display size, gradient text option
-- Subtitle: H3 size, gray
-- Metadata: Small text at bottom
-
-**Content Slide:**
-- Small logo + title in header
-- Bulleted list with icons
-- Code/diagram boxes
-- Footer: URL + social
-
-## README Badges
-
-```markdown
-![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-4A3ECD)
-![Version](https://img.shields.io/badge/OSSA-v0.2.5--RC-1CB9ED)
-![Vendor Neutral](https://img.shields.io/badge/Vendor-Neutral-10B981)
-```
-
-## Brand Assets
-
-**Request full package:**
-- Email: design@openstandardagents.org
-- Includes: Logos (all variants), color swatches, templates
-- Formats: SVG, PNG, AI, Figma
-
-## Checklist
-
-✅ Logo: Correct variant, minimum size
-✅ Colors: Approved palette, contrast requirements
-✅ Typography: Inter/JetBrains Mono, correct weights
-✅ Spacing: 4px grid system
-✅ Accessibility: WCAG AA minimum (AAA preferred)
-✅ Responsive: Mobile, tablet, desktop
-✅ Tone: Professional, clear, confident

package/docs/brand-guide/OssaLogo/OssA_Logo.svg

@@ -1,21 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 284 180" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
-    <g id="Layer3">
-    </g>
-    <g id="Artboard1" transform="matrix(0.959459,0,0,0.967742,-85.391892,-77.419355)">
-        <rect x="89" y="80" width="296" height="186" style="fill:none;"/>
-        <g id="Layer2" transform="matrix(1.042254,0,0,1.033333,-98.605634,44.866667)">
-            <g transform="matrix(1,0,0,1,-4,3)">
-                <path d="M360.304,111.534C363.113,108.192 389.309,70.107 418.113,69.792C455.004,69.388 453.98,85.001 454,85C411.09,80.447 406.306,113.749 391,127C376.213,128.875 359.884,111.957 360.304,111.534Z" style="fill:url(#_Linear1);"/>
-            </g>
-            <path d="M387,130C363.955,129.387 356.634,111.656 343.218,92.638C330.132,74.086 315.144,42 265,42C248.667,42 218,47 196,79C177.551,105.835 180.795,160.269 198,181C212.195,198.104 235.087,219.856 272.671,207.843C285.88,203.621 300.902,195.229 318,181C308.173,174.775 295,164 295,164C295,164 280.632,185.275 257,185C187.717,184.194 202.028,62.709 261,62C318.068,61.314 316.755,172.294 387,130Z" style="fill:url(#_Linear2);"/>
-            <path d="M237,121C298.486,85.797 306.507,159.426 345.704,159.426C369.233,159.426 379.051,151.385 430,113C433.734,111.659 461,183 461,183C455.02,189.367 449.324,189.969 444,183C440.77,151.879 425.801,136.49 421,139C421,139 382.667,187.667 338,186C287.813,183.443 267.695,115.583 237,121Z" style="fill:url(#_Linear3);"/>
-        </g>
-    </g>
-    <defs>
-        <linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-38,11,-11,-38,440,80)"><stop offset="0" style="stop-color:rgb(74,62,205);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(116,82,222);stop-opacity:1"/></linearGradient>
-        <linearGradient id="_Linear2" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-104,82,-82,-104,296,85)"><stop offset="0" style="stop-color:rgb(144,96,234);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(74,62,205);stop-opacity:1"/></linearGradient>
-        <linearGradient id="_Linear3" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(-222,-64,64,-222,461,183)"><stop offset="0" style="stop-color:rgb(26,188,237);stop-opacity:1"/><stop offset="1" style="stop-color:rgb(101,78,217);stop-opacity:1"/></linearGradient>
-    </defs>
-</svg>

package/docs/brand-guide/README.md

@@ -1,107 +0,0 @@
-# OSSA Brand Guide
-
-> **Version 1.0.0** | Last Updated: November 2025
-
-Official brand guidelines for the Open Standard for Scalable AI Agents (OSSA).
-
-## Table of Contents
-
-| Section | Description |
-|---------|-------------|
-| [01. Brand Overview](./01-brand-overview.md) | Mission, vision, values, positioning |
-| [02. Logo Usage](./02-logo-usage.md) | Logo variants, sizing, usage rules |
-| [03. Color Palette](./03-color-palette.md) | Brand colors, semantic colors, gradients |
-| [04. Typography](./04-typography.md) | Font families, type scale, usage guidelines |
-| [05. Voice & Tone](./05-voice-and-tone.md) | Writing style, tone variations, messaging |
-| [06. Visual Elements](./06-visual-elements.md) | Icons, buttons, spacing, animations |
-| [07. Application Examples](./07-application-examples.md) | Real-world implementation examples |
-
-## Brand at a Glance
-
-**Name:** OSSA (Open Standard for Scalable AI Agents)
-**Tagline:** "The OpenAPI for AI Agents"
-**Domain:** https://openstandardagents.org
-
-### Colors
-
-- **Primary:** Deep Purple (#4A3ECD)
-- **Secondary:** Cyan Blue (#1CB9ED)
-- **Accent:** Light Purple (#9060EA)
-- **Neutrals:** Gray scale (#F9FAFB - #111827)
-
-### Typography
-
-- **Primary:** Inter (Sans-serif)
-- **Monospace:** JetBrains Mono
-
-### Logo
-
-**Location:** `/website/public/brand/ossa-logo.svg`
-**Minimum Size:** 120px width (digital), 1 inch (print)
-
-## Core Principles
-
-1. **Open & Vendor-Neutral** - Community-driven, no vendor lock-in
-2. **Interoperable** - Common language across all frameworks
-3. **Trustworthy** - Compliance-ready, enterprise-grade
-4. **Simple & Practical** - Clear specification, production-ready
-
-## Voice
-
-**Professional, Clear, Confident, Inclusive, Practical**
-
-## Key Message
-
-**"The OpenAPI for AI Agents"**
-
-OSSA provides a universal specification standard that makes AI agents interoperable across all platforms, frameworks, and runtimes.
-
-## Quick Reference
-
-### Dos
-
-✅ Use approved color palette and gradients
-✅ Follow typography hierarchy and sizing
-✅ Respect logo clear space and minimum sizes
-✅ Write in active voice with clear language
-✅ Maintain WCAG AA accessibility (AAA preferred)
-✅ Provide working code examples
-
-### Don'ts
-
-❌ Modify logo colors or proportions
-❌ Use colors outside approved palette
-❌ Mix font families
-❌ Use exclusive language ("obviously," "simply")
-❌ Make unsubstantiated claims
-❌ Violate accessibility guidelines
-
-## Resources
-
-### Design Assets
-
-**Logo:** `/website/public/brand/ossa-logo.svg`
-**Colors:** `website/styles/_variables.scss`
-**Website:** https://openstandardagents.org
-
-### Request Full Package
-
-**Contact:** design@openstandardagents.org
-**Includes:** All logo variants, color swatches, templates
-**Formats:** SVG, PNG, AI, Figma
-
-## Support
-
-**Questions:** design@openstandardagents.org
-**Documentation:** https://openstandardagents.org/brand
-**Issues:** https://github.com/blueflyio/openstandardagents/issues
-
-## License
-
-Creative Commons Attribution 4.0 International (CC BY 4.0)
-
-**Trademark:** "OSSA" and the OSSA logo are trademarks of the OSSA project.
-
----
-
-**Ready to get started?** Pick a section above and dive in!