@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

package/website/scripts/sync-wiki.ts

@@ -8,9 +8,15 @@
 
 import fs from 'fs';
 import path from 'path';
+import os from 'os';
 
-const GITLAB_HOST = process.env.GITLAB_HOST || 'gitlab.bluefly.io';
-const PROJECT_PATH = 'llm/openstandardagents';
+// Load .env.local first to get project path
+loadEnvLocal();
+
+// Get GITLAB_HOST from env or CI variables, with fallback
+const GITLAB_HOST = process.env.GITLAB_HOST || process.env.CI_SERVER_HOST || 'gitlab.com';
+// Get project path from env (GITLAB_PROJECT_PATH) or fallback to default
+const PROJECT_PATH = process.env.GITLAB_PROJECT_PATH || 'blueflyio/openstandardagents';
 const DOCS_DIR = path.join(process.cwd(), 'content/docs');
 const BLOG_DIR = path.join(process.cwd(), 'content/blog');
 
@@ -21,11 +27,66 @@ interface WikiPage {
   format: string;
 }
 
+function loadEnvLocal(): void {
+  // Check multiple common locations for .env.local
+  const envPaths: string[] = [];
+  
+  // If ENV_FILE is set, use that first
+  if (process.env.ENV_FILE) {
+    envPaths.push(process.env.ENV_FILE);
+  }
+  
+  // Current directory and parent directories (walk up to 5 levels)
+  let currentDir = process.cwd();
+  for (let i = 0; i < 5; i++) {
+    envPaths.push(path.join(currentDir, '.env.local'));
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) break; // Reached filesystem root
+    currentDir = parentDir;
+  }
+  
+  // User home directory
+  envPaths.push(path.join(os.homedir(), '.env.local'));
+
+  for (const envLocalPath of envPaths) {
+    if (fs.existsSync(envLocalPath)) {
+      try {
+        const envContent = fs.readFileSync(envLocalPath, 'utf-8');
+        envContent.split('\n').forEach(line => {
+          const trimmed = line.trim();
+          if (trimmed && !trimmed.startsWith('#')) {
+            const [key, ...valueParts] = trimmed.split('=');
+            if (key && valueParts.length > 0) {
+              const value = valueParts.join('=').replace(/^["']|["']$/g, '').trim();
+              if (!process.env[key] && value) {
+                process.env[key] = value;
+              }
+            }
+          }
+        });
+        // Load from first found file only
+        return;
+      } catch (error) {
+        // Continue to next location if this one fails
+        continue;
+      }
+    }
+  }
+}
+
 async function getGitLabToken(): Promise<string | null> {
-  // Try environment variable first
+  // .env.local already loaded at top level
+
+  // Try environment variables (check multiple possible names)
   if (process.env.GITLAB_TOKEN) {
     return process.env.GITLAB_TOKEN;
   }
+  if (process.env.GITLAB_PUSH_TOKEN) {
+    return process.env.GITLAB_PUSH_TOKEN;
+  }
+  if (process.env.CI_JOB_TOKEN) {
+    return process.env.CI_JOB_TOKEN;
+  }
 
   // Try reading from ~/.tokens/gitlab
   const tokenPath = path.join(process.env.HOME || '', '.tokens', 'gitlab');

package/website/scripts/upload-wiki.ts

@@ -0,0 +1,199 @@
+#!/usr/bin/env npx tsx
+/**
+ * Upload Wiki Export to GitLab
+ *
+ * Uploads prepared wiki files from .wiki-export to GitLab wiki via API
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+// Load .env.local first to get project path
+loadEnvLocal();
+
+const GITLAB_HOST = process.env.GITLAB_HOST || process.env.CI_SERVER_HOST || 'gitlab.com';
+// Get project path from env (GITLAB_PROJECT_PATH) or fallback to default
+const PROJECT_PATH = process.env.GITLAB_PROJECT_PATH || 'blueflyio/openstandardagents';
+const EXPORT_DIR = path.join(process.cwd(), '.wiki-export');
+
+function loadEnvLocal(): void {
+  // Check multiple common locations for .env.local
+  const envPaths: string[] = [];
+  
+  // If ENV_FILE is set, use that first
+  if (process.env.ENV_FILE) {
+    envPaths.push(process.env.ENV_FILE);
+  }
+  
+  // Current directory and parent directories (walk up to 5 levels)
+  let currentDir = process.cwd();
+  for (let i = 0; i < 5; i++) {
+    envPaths.push(path.join(currentDir, '.env.local'));
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) break; // Reached filesystem root
+    currentDir = parentDir;
+  }
+  
+  // User home directory
+  envPaths.push(path.join(os.homedir(), '.env.local'));
+
+  for (const envLocalPath of envPaths) {
+    if (fs.existsSync(envLocalPath)) {
+      try {
+        const envContent = fs.readFileSync(envLocalPath, 'utf-8');
+        envContent.split('\n').forEach(line => {
+          const trimmed = line.trim();
+          if (trimmed && !trimmed.startsWith('#')) {
+            const [key, ...valueParts] = trimmed.split('=');
+            if (key && valueParts.length > 0) {
+              const value = valueParts.join('=').replace(/^["']|["']$/g, '').trim();
+              if (!process.env[key] && value) {
+                process.env[key] = value;
+              }
+            }
+          }
+        });
+        // Load from first found file only
+        return;
+      } catch (error) {
+        // Continue to next location if this one fails
+        continue;
+      }
+    }
+  }
+}
+
+async function getGitLabToken(): Promise<string | null> {
+  // .env.local already loaded at top level
+
+  // Try environment variables (check multiple possible names)
+  if (process.env.GITLAB_TOKEN) {
+    return process.env.GITLAB_TOKEN;
+  }
+  if (process.env.GITLAB_PUSH_TOKEN) {
+    return process.env.GITLAB_PUSH_TOKEN;
+  }
+  if (process.env.CI_JOB_TOKEN) {
+    return process.env.CI_JOB_TOKEN;
+  }
+
+  const tokenPath = path.join(process.env.HOME || '', '.tokens', 'gitlab');
+  if (fs.existsSync(tokenPath)) {
+    return fs.readFileSync(tokenPath, 'utf-8').trim();
+  }
+
+  return null;
+}
+
+async function uploadWikiPage(slug: string, content: string): Promise<boolean> {
+  const token = await getGitLabToken();
+  if (!token) {
+    console.error('❌ No GitLab token found');
+    console.error('   Set GITLAB_TOKEN env var or create ~/.tokens/gitlab');
+    return false;
+  }
+
+  const encodedPath = encodeURIComponent(PROJECT_PATH);
+  const url = `https://${GITLAB_HOST}/api/v4/projects/${encodedPath}/wikis`;
+
+  try {
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'PRIVATE-TOKEN': token,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        title: slug,
+        content: content,
+        format: 'markdown',
+      }),
+    });
+
+    if (response.ok) {
+      return true;
+    } else if (response.status === 409 || response.status === 400) {
+      // Page already exists, try to update it
+      const updateUrl = `${url}/${encodeURIComponent(slug)}`;
+      const updateResponse = await fetch(updateUrl, {
+        method: 'PUT',
+        headers: {
+          'PRIVATE-TOKEN': token,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          content: content,
+          format: 'markdown',
+        }),
+      });
+      if (updateResponse.ok) {
+        return true;
+      } else {
+        const errorText = await updateResponse.text();
+        console.error(`   Update error: ${updateResponse.status} ${updateResponse.statusText}`);
+        console.error(`   ${errorText.substring(0, 200)}`);
+        return false;
+      }
+    } else {
+      const errorText = await response.text();
+      console.error(`   API error: ${response.status} ${response.statusText}`);
+      console.error(`   ${errorText.substring(0, 200)}`);
+      return false;
+    }
+  } catch (error: any) {
+    console.error(`   Network error: ${error.message}`);
+    return false;
+  }
+}
+
+async function uploadWikiFiles(): Promise<void> {
+  console.log('🔄 Uploading wiki files to GitLab...\n');
+
+  if (!fs.existsSync(EXPORT_DIR)) {
+    console.error('❌ .wiki-export directory not found');
+    console.error('   Run: npm run merge-docs-to-wiki first');
+    return;
+  }
+
+  const manifestPath = path.join(EXPORT_DIR, 'MANIFEST.json');
+  if (!fs.existsSync(manifestPath)) {
+    console.error('❌ MANIFEST.json not found');
+    return;
+  }
+
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+  console.log(`📚 Found ${manifest.length} files to upload\n`);
+
+  let successCount = 0;
+  let failCount = 0;
+
+  for (const item of manifest) {
+    const filePath = path.join(EXPORT_DIR, `${item.slug}.md`);
+    if (!fs.existsSync(filePath)) {
+      console.log(`⚠️  ${item.slug} - file not found, skipping`);
+      failCount++;
+      continue;
+    }
+
+    const content = fs.readFileSync(filePath, 'utf-8');
+    console.log(`📤 Uploading ${item.slug}...`);
+
+    const success = await uploadWikiPage(item.slug, content);
+    if (success) {
+      console.log(`✅ ${item.slug} - uploaded successfully`);
+      successCount++;
+    } else {
+      console.log(`❌ ${item.slug} - upload failed`);
+      failCount++;
+    }
+  }
+
+  console.log(`\n✨ Upload complete: ${successCount} succeeded, ${failCount} failed`);
+}
+
+uploadWikiFiles().catch((error) => {
+  console.error('❌ Upload failed:', error.message);
+  process.exit(1);
+});
+

package/website/styles/_variables.scss

@@ -0,0 +1,36 @@
+// OSSA Design System - Centralized Color Variables
+// Update colors here to change them site-wide
+
+// Brand Colors
+$ossa-primary: #4A3ECD;        // Main blue-purple - OSSA hub/standard
+$ossa-secondary: #1CB9ED;     // Cyan-blue - Agent nodes
+$ossa-accent: #9060EA;        // Purple accent
+
+// Semantic Colors - Muted for better visual harmony
+$ossa-success: #10b981;        // Muted green
+$ossa-warning: #f59e0b;        // Muted amber
+$ossa-error: #ef4444;          // Muted red
+$ossa-info: #06b6d4;           // Muted cyan
+
+// Neutral Colors
+$ossa-dark: #212529;
+$ossa-gray-900: #343a40;
+$ossa-gray-700: #495057;
+$ossa-gray-500: #6c757d;
+$ossa-gray-300: #dee2e6;
+$ossa-gray-100: #f8f9fa;
+$ossa-white: #ffffff;
+
+// Gradients - Lightest blue to darkest purple, blue spans more
+// Order: secondary (lightest blue #1CB9ED) -> primary (blue-purple #4A3ECD) -> accent (darkest purple #9060EA)
+$gradient-brand: linear-gradient(135deg, $ossa-secondary 0%, $ossa-secondary 40%, $ossa-primary 70%, $ossa-accent 100%);
+$gradient-hero: linear-gradient(135deg, $ossa-secondary 0%, $ossa-secondary 35%, $ossa-primary 65%, $ossa-accent 100%);
+$gradient-button: linear-gradient(135deg, $ossa-secondary 0%, $ossa-secondary 45%, $ossa-primary 75%, $ossa-accent 100%);
+
+// Code Colors
+$code-bg: #1e1e1e;
+$code-text: #d4d4d4;
+$code-keyword: #569cd6;
+$code-string: #ce9178;
+$code-comment: #6a9955;
+

package/website/tailwind.config.ts

@@ -10,30 +10,101 @@ const config: Config = {
     extend: {
       colors: {
         primary: {
-          50: '#f0f9ff',
-          100: '#e0f2fe',
-          200: '#bae6fd',
-          300: '#7dd3fc',
-          400: '#38bdf8',
-          500: '#0ea5e9',
-          600: '#0284c7',
-          700: '#0369a1',
-          800: '#075985',
-          900: '#0c4a6e',
-          950: '#082f49',
+          DEFAULT: 'var(--ossa-primary)', // From SCSS variables - #4A3ECD
+          50: '#f5f4fd',
+          100: '#e8e5fa',
+          200: '#d4cff5',
+          300: '#b5abee',
+          400: '#8f7ee4',
+          500: 'var(--ossa-primary)', // #4A3ECD - from SCSS
+          600: '#3d2fb8',
+          700: '#322598',
+          800: '#2a1f7a',
+          900: '#241f65',
+          950: '#15113a',
+        },
+        secondary: {
+          DEFAULT: 'var(--ossa-secondary)', // From SCSS variables - #1CB9ED
+          50: '#ecfbff',
+          100: '#d1f5fe',
+          200: '#a8e9fd',
+          300: '#6fd8fa',
+          400: '#2ec0f5',
+          500: 'var(--ossa-secondary)', // #1CB9ED - from SCSS
+          600: '#0a9dd1',
+          700: '#087da9',
+          800: '#0c6688',
+          900: '#105570',
+          950: '#08374a',
         },
         accent: {
-          50: '#faf5ff',
-          100: '#f3e8ff',
-          200: '#e9d5ff',
-          300: '#d8b4fe',
-          400: '#c084fc',
-          500: '#a855f7',
-          600: '#9333ea',
-          700: '#7e22ce',
-          800: '#6b21a8',
-          900: '#581c87',
-          950: '#3b0764',
+          DEFAULT: 'var(--ossa-accent)', // From SCSS variables - #9060EA
+          50: '#f7f4fe',
+          100: '#ede9fd',
+          200: '#ddd4fb',
+          300: '#c5b3f8',
+          400: '#a887f3',
+          500: 'var(--ossa-accent)', // #9060EA - from SCSS
+          600: '#7c3aed',
+          700: '#6b28d9',
+          800: '#5923b8',
+          900: '#4b1f97',
+          950: '#2d0f5c',
+        },
+        // Semantic colors - centralized and muted
+        // These reference CSS variables which come from SCSS variables in styles/_variables.scss
+        // Update colors in ONE place: styles/_variables.scss
+        success: {
+          DEFAULT: 'var(--ossa-success)',
+          50: '#ecfdf5',
+          100: '#d1fae5',
+          200: '#a7f3d0',
+          300: '#6ee7b7',
+          400: '#34d399',
+          500: 'var(--ossa-success)', // #10b981 - from SCSS
+          600: '#059669',
+          700: '#047857',
+          800: '#065f46',
+          900: '#064e3b',
+        },
+        warning: {
+          DEFAULT: 'var(--ossa-warning)',
+          50: '#fffbeb',
+          100: '#fef3c7',
+          200: '#fde68a',
+          300: '#fcd34d',
+          400: '#fbbf24',
+          500: 'var(--ossa-warning)', // #f59e0b - from SCSS
+          600: '#d97706',
+          700: '#b45309',
+          800: '#92400e',
+          900: '#78350f',
+        },
+        error: {
+          DEFAULT: 'var(--ossa-error)',
+          50: '#fef2f2',
+          100: '#fee2e2',
+          200: '#fecaca',
+          300: '#fca5a5',
+          400: '#f87171',
+          500: 'var(--ossa-error)', // #ef4444 - from SCSS
+          600: '#dc2626',
+          700: '#b91c1c',
+          800: '#991b1b',
+          900: '#7f1d1d',
+        },
+        info: {
+          DEFAULT: 'var(--ossa-info)',
+          50: '#ecfeff',
+          100: '#cffafe',
+          200: '#a5f3fc',
+          300: '#67e8f9',
+          400: '#22d3ee',
+          500: 'var(--ossa-info)', // #06b6d4 - from SCSS
+          600: '#0891b2',
+          700: '#0e7490',
+          800: '#155e75',
+          900: '#164e63',
         },
       },
       fontFamily: {

package/.releaserc.json.disabled

@@ -1,81 +0,0 @@
-{
-  "branches": [
-    "main",
-    {
-      "name": "development",
-      "prerelease": "dev",
-      "channel": "development"
-    }
-  ],
-  "repositoryUrl": "https://gitlab.bluefly.io/llm/openapi-ai-agents-standard.git",
-  "plugins": [
-    [
-      "@semantic-release/commit-analyzer",
-      {
-      "preset": "angular",
-        "releaseRules": [
-          { "type": "docs", "scope": "README", "release": "patch" },
-          { "type": "refactor", "scope": "core-*", "release": "minor" },
-          { "type": "refactor", "release": "patch" },
-          { "type": "chore", "scope": "deps", "release": "patch" }
-        ],
-        "parserOpts": {
-          "noteKeywords": ["BREAKING CHANGE", "BREAKING CHANGES"]
-        }
-      }
-    ],
-    [
-      "@semantic-release/release-notes-generator",
-      {
-        "preset": "angular",
-        "parserOpts": {
-          "noteKeywords": ["BREAKING CHANGE", "BREAKING CHANGES"]
-        },
-        "writerOpts": {
-          "commitsSort": ["subject", "scope"]
-        }
-      }
-    ],
-    [
-      "@semantic-release/changelog",
-      {
-        "changelogFile": "CHANGELOG.md",
-        "changelogTitle": "# Changelog\n\nAll notable changes to OSSA (Open Standard for Scalable Agents) will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)."
-      }
-    ],
-    [
-      "@semantic-release/npm",
-      {
-        "npmPublish": false,
-        "tarballDir": "dist"
-      }
-    ],
-    [
-      "@semantic-release/gitlab",
-      {
-        "gitlabUrl": "https://gitlab.bluefly.io",
-        "assets": [
-          {
-            "path": "dist/*.tgz",
-            "label": "OSSA npm package (${nextRelease.gitTag})"
-          },
-          {
-            "path": "spec/v${nextRelease.version.split('.')[0]}.${nextRelease.version.split('.')[1]}.${nextRelease.version.split('.')[2]}/ossa-${nextRelease.version.split('.')[0]}.${nextRelease.version.split('.')[1]}.${nextRelease.version.split('.')[2]}.schema.json",
-            "label": "OSSA ${nextRelease.version} JSON Schema"
-          }
-        ]
-      }
-    ],
-    [
-      "@semantic-release/git",
-      {
-        "assets": [
-          "package.json",
-          "package-lock.json",
-          "CHANGELOG.md"
-        ],
-        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-      }
-    ]
-  ]
-}

package/dist/spec/v0.2.5-dev/CHANGELOG.md

@@ -1,171 +0,0 @@
-# Changelog - OSSA v0.2.5-dev
-
-All notable changes to the OSSA specification are documented in this file.
-
-## [0.2.5-dev] - 2024-11-18
-
-### Status: DEVELOPMENT/UNSTABLE
-
-This is a development version. The API may change without notice.
-
-### Added
-
-#### New Resource Type: AgentGraph
-- Introduced `AgentGraph` kind for multi-agent composition
-- Support for defining complex agent workflows and orchestration patterns
-- Shared state management across agent graphs
-
-#### AgentGraphSpec Properties
-- `agents`: Array of agent references with role assignments
-- `edges`: Graph connections with conditions and priorities
-- `process`: Execution pattern (sequential, parallel, hierarchical, conditional, loop)
-- `entry_point`: Starting agent for graph execution
-- `exit_points`: Agents that can terminate execution
-- `state`: Shared state configuration with persistence options
-
-#### Execution Patterns
-- **sequential**: Agents execute one after another
-- **parallel**: Agents execute simultaneously
-- **hierarchical**: Manager delegates to workers (CrewAI style)
-- **conditional**: Branching based on conditions
-- **loop**: Iterative execution until termination
-
-#### New Framework Extensions
-- `google_adk`: Google Agent Development Kit integration
-  - Support for SequentialAgent, ParallelAgent, LoopAgent
-  - Gemini model configuration
-  - Session service options
-- `microsoft_af`: Microsoft AutoGen 0.4+ / Magentic-One
-  - Team types: round_robin, selector, swarm, magentic_one
-  - Agent types: assistant, orchestrator, web_surfer, coder
-  - Termination conditions
-- `metagpt`: MetaGPT software development teams
-  - Role types: product_manager, architect, engineer, qa_engineer
-  - SOP (Standard Operating Procedure) configuration
-  - Action definitions
-
-#### Enhanced Existing Extensions
-- `crewai`: Added `crew` property for Process configuration
-  - Process type (sequential/hierarchical)
-  - Manager LLM configuration
-  - Verbose mode
-
-### Changed
-
-#### Schema Updates
-- `kind` enum now includes: `Agent`, `AgentGraph`
-- `spec` uses `oneOf` to support AgentSpec or AgentGraphSpec
-- `apiVersion` pattern updated to support v0.2.5-dev
-
-#### API Version Pattern
-```regex
-^ossa/v(0\.2\.[2-5]|1)(\.[0-9]+)?(-[a-zA-Z0-9]+)?$
-```
-
-### Framework Mapping Examples
-
-#### CrewAI Crews
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: research-crew
-spec:
-  process: hierarchical
-  agents:
-    - ref: researcher
-      role: worker
-    - ref: writer
-      role: worker
-extensions:
-  crewai:
-    enabled: true
-    crew:
-      process: hierarchical
-      manager_llm: gpt-4
-```
-
-#### Google ADK Sequential
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: processing-pipeline
-spec:
-  process: sequential
-  agents:
-    - ref: intake
-    - ref: process
-    - ref: output
-extensions:
-  google_adk:
-    enabled: true
-    agent_type: sequential_agent
-```
-
-#### Microsoft AutoGen Team
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: dev-team
-spec:
-  process: conditional
-  agents:
-    - ref: orchestrator
-    - ref: coder
-    - ref: web-surfer
-extensions:
-  microsoft_af:
-    enabled: true
-    framework: magentic_one
-    team_type: magentic_one
-```
-
-#### MetaGPT SOP
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: software-team
-spec:
-  process: hierarchical
-  agents:
-    - ref: product-manager
-    - ref: architect
-    - ref: engineer
-extensions:
-  metagpt:
-    enabled: true
-    sop:
-      name: software_development
-      phases:
-        - requirements
-        - design
-        - implementation
-        - testing
-```
-
-### Migration Notes
-
-See `migrations/v0.2.4-to-v0.2.5.md` for detailed migration guidance.
-
-#### Quick Migration
-1. Update `apiVersion` to `ossa/v0.2.5-dev`
-2. Existing Agent manifests remain unchanged
-3. New AgentGraph manifests use `kind: AgentGraph`
-
-### Known Limitations
-- Graph validation is not fully implemented
-- Some framework mappings may require manual configuration
-- State persistence options are runtime-dependent
-
-### Roadmap
-- v0.2.5: Stabilize AgentGraph API based on feedback
-- v0.2.6: Add resource dependencies and imports
-- v0.3.0: Multi-file manifest support
-- v1.0.0: Stable release
-
-### Feedback
-Report issues and feedback at:
-https://gitlab.bluefly.io/llm/ossa/-/issues