@bluefly/openstandardagents 0.2.5-RC → 0.2.7

package/website/components/ui/Textarea.tsx

@@ -0,0 +1,195 @@
+'use client';
+
+import React, { TextareaHTMLAttributes, forwardRef, useState } from 'react';
+
+// Simple className merger utility
+function cn(...classes: (string | undefined | null | false)[]): string {
+  return classes.filter(Boolean).join(' ');
+}
+
+// ============================================================================
+// TEXTAREA COMPONENT
+// ============================================================================
+// Textarea with label, error states, character count, and accessibility
+// ============================================================================
+
+export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+  label?: string;
+  error?: string;
+  helperText?: string;
+  fullWidth?: boolean;
+  showCharCount?: boolean;
+  resize?: 'none' | 'vertical' | 'horizontal' | 'both';
+}
+
+const Textarea = forwardRef<HTMLTextAreaElement, TextareaProps>(
+  (
+    {
+      className,
+      label,
+      error,
+      helperText,
+      fullWidth = false,
+      showCharCount = false,
+      resize = 'vertical',
+      id,
+      disabled,
+      required,
+      maxLength,
+      value,
+      defaultValue,
+      onChange,
+      ...props
+    },
+    ref
+  ) => {
+    // Track character count
+    const [charCount, setCharCount] = useState(
+      (value?.toString() || defaultValue?.toString() || '').length
+    );
+
+    // Generate ID if not provided
+    const textareaId = id || `textarea-${Math.random().toString(36).substr(2, 9)}`;
+    const errorId = `${textareaId}-error`;
+    const helperId = `${textareaId}-helper`;
+
+    // Handle change to update character count
+    const handleChange = (e: React.ChangeEvent<HTMLTextAreaElement>) => {
+      setCharCount(e.target.value.length);
+      onChange?.(e);
+    };
+
+    // Base textarea styles
+    const baseStyles = [
+      'block',
+      'w-full',
+      'rounded-lg',
+      'border',
+      'px-4',
+      'py-2',
+      'text-base',
+      'transition-colors',
+      'duration-200',
+      'focus:outline-none',
+      'focus:ring-2',
+      'focus:ring-offset-1',
+      'disabled:opacity-50',
+      'disabled:cursor-not-allowed',
+      'disabled:bg-gray-100',
+      'min-h-[100px]',
+    ];
+
+    // Resize styles
+    const resizeStyles = {
+      none: 'resize-none',
+      vertical: 'resize-y',
+      horizontal: 'resize-x',
+      both: 'resize',
+    };
+
+    // State-based styles
+    const stateStyles = error
+      ? [
+          'border-error-500',
+          'text-error-900',
+          'focus:border-error-500',
+          'focus:ring-error-500',
+        ]
+      : [
+          'border-gray-300',
+          'text-gray-900',
+          'focus:border-primary-500',
+          'focus:ring-primary-500',
+        ];
+
+    return (
+      <div className={cn(fullWidth ? 'w-full' : 'w-auto')}>
+        {/* Label */}
+        {label && (
+          <label
+            htmlFor={textareaId}
+            className={cn(
+              'block',
+              'text-sm',
+              'font-medium',
+              'mb-1',
+              error ? 'text-error-700' : 'text-gray-700'
+            )}
+          >
+            {label}
+            {required && <span className="text-error-500 ml-1">*</span>}
+          </label>
+        )}
+
+        {/* Textarea */}
+        <textarea
+          ref={ref}
+          id={textareaId}
+          className={cn(
+            ...baseStyles,
+            resizeStyles[resize],
+            ...stateStyles,
+            className
+          )}
+          disabled={disabled}
+          required={required}
+          maxLength={maxLength}
+          value={value}
+          defaultValue={defaultValue}
+          onChange={handleChange}
+          aria-invalid={error ? 'true' : 'false'}
+          aria-describedby={cn(
+            error ? errorId : undefined,
+            helperText ? helperId : undefined
+          )}
+          {...props}
+        />
+
+        {/* Character count and helper text row */}
+        <div className="flex items-center justify-between mt-1">
+          <div className="flex-1">
+            {/* Error message */}
+            {error && (
+              <p
+                id={errorId}
+                className="text-sm text-error-600"
+                role="alert"
+              >
+                {error}
+              </p>
+            )}
+
+            {/* Helper text */}
+            {helperText && !error && (
+              <p
+                id={helperId}
+                className="text-sm text-gray-500"
+              >
+                {helperText}
+              </p>
+            )}
+          </div>
+
+          {/* Character count */}
+          {showCharCount && maxLength && (
+            <p
+              className={cn(
+                'text-sm',
+                'ml-2',
+                'flex-shrink-0',
+                charCount > maxLength ? 'text-error-600' : 'text-gray-500'
+              )}
+              aria-live="polite"
+            >
+              {charCount} / {maxLength}
+            </p>
+          )}
+        </div>
+      </div>
+    );
+  }
+);
+
+Textarea.displayName = 'Textarea';
+
+export { Textarea };

package/website/components/ui/index.ts

@@ -0,0 +1,11 @@
+export { Button, type ButtonProps } from './Button';
+export {
+  Card,
+  CardHeader,
+  CardTitle,
+  CardDescription,
+  CardContent,
+  CardFooter,
+  type CardProps,
+} from './Card';
+export { Badge, type BadgeProps } from './Badge';

package/website/content/docs/{00-HOME.md → 00-home.md}

@@ -4,7 +4,7 @@
 
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![npm version](https://img.shields.io/npm/v/@bluefly/openstandardagents.svg)](https://www.npmjs.com/package/@bluefly/openstandardagents)
-[![Specification](https://img.shields.io/badge/Spec-v0.2.x-blue)](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json)
+[![Specification](https://img.shields.io/badge/Spec-v0.2.x-blue)](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.6/ossa-0.2.6.schema.json)
 
 ---
 

package/website/content/docs/agents/catalog.md

@@ -0,0 +1,28 @@
+# GitLab Agents Catalog
+
+OSSA-compliant agents for GitLab CI/CD automation.
+
+**Total Agents**: 1
+
+## Documentation Agent
+
+**ID**: `doc-agent`  
+**Role**: `worker`
+
+Automated documentation generation and validation agent
+
+### Capabilities
+
+- **generate_api_docs**: Generate API documentation from OpenAPI specifications
+- **generate_cli_docs**: Generate CLI documentation from command source files
+- **generate_schema_docs**: Generate schema documentation from JSON Schema
+- **validate_docs**: Validate documentation completeness and quality
+- **sync_wiki**: Sync documentation to GitLab wiki
+
+**Manifest**: [`.gitlab/agents/doc-agent/manifest.ossa.yaml`](https://github.com/blueflyio/openstandardagents/blob/main/.gitlab/agents/doc-agent/manifest.ossa.yaml)
+
+```bash
+# Deploy agent
+kubectl apply -f .gitlab/agents/doc-agent/manifest.ossa.yaml
+```
+

package/website/content/docs/{AIFlow-Framework-Integration-with-OSSA.md → aiflow-framework-integration-with-ossa.md}

@@ -38,7 +38,7 @@ The OpenAPI 3.1 specification defines the REST API interface for the AIFlow agen
 
 ### OSSA Schema
 
-**Location**: [OSSA/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json)
+**Location**: [OSSA/spec/v0.2.6/ossa-0.2.6.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.6/ossa-0.2.6.schema.json)
 
 JSON Schema definition for OSSA 1.0 manifest validation. All agent manifests must conform to this schema.
 
@@ -102,6 +102,6 @@ This generates Kubernetes manifests and deploys the agent with:
 - **AIFlow Repository**: https://github.com/AIFlow-agent/AIFlow-Agent
 - **OSSA Project**: [openapi-ai-agents-standard](https://github.com/blueflyio/openstandardagents)
 - **Integration Guide**: [agent-buildkit Wiki](https://github.com/blueflyio/agent-buildkit/-/wikis/AIFlow-Integration-with-OSSA-BuildKit-and-K-Agent)
-- **OSSA Specification Schema**: [OSSA 1.0 Schema](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json)
+- **OSSA Specification Schema**: [OSSA 1.0 Schema](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.6/ossa-0.2.6.schema.json)
 - **Example Manifest**: [social-agent-aiflow.ossa.yaml](https://github.com/blueflyio/agent-buildkit/-/blob/development/examples/aiflow-integration/social-agent-aiflow.ossa.yaml)
 - **OpenAPI Spec**: [aiflow-agent.openapi.yml](https://github.com/blueflyio/agent-buildkit/-/blob/development/openapi/aiflow-agent.openapi.yml)

package/website/content/docs/api-reference/index.md

@@ -0,0 +1,38 @@
+# API Reference
+
+Welcome to the OSSA API Reference documentation.
+
+## Core APIs
+
+- [Ossa Core Api](ossa-core-api.md)
+- [Ossa Registry Api](ossa-registry-api.md)
+- [Ossa Registry](ossa-registry.md)
+- [Unified Agent Gateway](unified-agent-gateway.md)
+
+## Authentication
+
+All API endpoints require authentication. See the [Authentication Guide](./authentication.md) for details.
+
+## Rate Limiting
+
+- 100 requests per minute per API key
+- 1000 requests per hour per API key
+
+## Error Responses
+
+All APIs use standard HTTP status codes and return errors in the following format:
+
+```json
+{
+  "error": "error_code",
+  "message": "Human-readable error message",
+  "details": []
+}
+```
+
+## Support
+
+For API support, please:
+- Check the [Troubleshooting Guide](../guides/troubleshooting.md)
+- Open an issue on [GitLab](https://gitlab.com/blueflyio/openstandardagents/-/issues)
+- Join our [Discord community](https://discord.gg/ossa)