@bluefly/openstandardagents 0.2.5-RC → 0.2.7

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

@@ -0,0 +1,108 @@
+# 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

@@ -0,0 +1,137 @@
+# 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

@@ -0,0 +1,153 @@
+# 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

@@ -0,0 +1,21 @@
+<?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

@@ -0,0 +1,107 @@
+# 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!