@bluefly/openstandardagents 0.2.7 → 0.2.8

package/website/content/docs/versioning.md

@@ -1,288 +0,0 @@
----
-title: "VERSIONING"
----
-
-# OSSA Versioning Strategy
-
-## Semantic Versioning with Semantic-Release
-
-OSSA uses **semantic versioning** (semver 2.0.0) with **automated releases** via semantic-release.
-
-### Version Format
-
-```
-MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
-```
-
-Examples:
-- `0.2.2` - Stable patch release
-- `0.3.0` - Minor feature release
-- `1.0.0` - Major release with breaking changes
-- `0.3.0-dev.1` - Development pre-release
-- `1.0.0-beta.2` - Beta pre-release
-
----
-
-## Branching Strategy
-
-### `development` Branch
-- **Purpose**: Active development and testing
-- **Releases**: Pre-release versions with `-dev` tag
-- **Version bumps**: Automatic via semantic-release
-- **Example versions**: `0.2.3-dev.0`, `0.2.3-dev.1`
-
-### `main` Branch
-- **Purpose**: Stable production releases
-- **Releases**: Stable versions (no pre-release tag)
-- **Version bumps**: Automatic via semantic-release
-- **Example versions**: `0.2.3`, `0.3.0`, `1.0.0`
-
----
-
-## Commit Message Convention
-
-OSSA uses **Angular commit message format** for semantic-release:
-
-### Commit Types
-
-| Type | Description | Version Bump | Example |
-|------|-------------|--------------|---------|
-| `feat` | New feature | MINOR (0.x.0) | `feat: add MCP bridge support` |
-| `fix` | Bug fix | PATCH (0.0.x) | `fix: resolve schema validation error` |
-| `docs` | Documentation | PATCH* (0.0.x) | `docs: update README with examples` |
-| `refactor` | Code refactoring | PATCH (0.0.x) | `refactor: simplify validation service` |
-| `perf` | Performance improvement | PATCH (0.0.x) | `perf: optimize schema caching` |
-| `test` | Test changes | No release | `test: add kagent bridge tests` |
-| `chore` | Maintenance | PATCH* (0.0.x) | `chore(deps): update dependencies` |
-| `ci` | CI/CD changes | No release | `ci: add semantic-release job` |
-| `build` | Build system | No release | `build: update tsconfig` |
-| `style` | Code style | No release | `style: format with prettier` |
-
-\* Only triggers release with specific scopes (e.g., `docs(README)`, `chore(deps)`)
-
-### Breaking Changes
-
-**MAJOR version bump (x.0.0)**
-
-Add `BREAKING CHANGE:` in commit body or footer:
-
-```
-feat: redesign agent schema structure
-
-BREAKING CHANGE: Renamed `spec` to `agent` in manifest structure.
-Migration guide available at docs/migration-v1.md
-```
-
----
-
-## How Versions are Determined
-
-### Automatic Version Calculation
-
-Semantic-release analyzes commits since the last release:
-
-```
-Last release: v0.2.2
-New commits:
-  - fix: resolve validation error      → PATCH
-  - feat: add KAgent bridge support    → MINOR (overrides PATCH)
-  - docs: update README                 → No change
-
-Next version: v0.3.0
-```
-
-### Development Pre-releases
-
-On `development` branch:
-```
-Current: v0.2.2
-Commits: feat, fix, docs
-Result: v0.3.0-dev.0 (first dev release)
-        v0.3.0-dev.1 (second dev release)
-        ...
-        v0.3.0 (when merged to main)
-```
-
----
-
-## Release Process
-
-### Automated (Recommended)
-
-1. **Commit with conventional format**:
-   ```bash
-   git commit -m "feat: add semantic-release automation"
-   ```
-
-2. **Push to branch**:
-   ```bash
-   git push origin development  # Creates v0.3.0-dev.0
-   # OR
-   git push origin main          # Creates v0.3.0
-   ```
-
-3. **Semantic-release automatically**:
-   - Analyzes commits
-   - Determines version bump
-   - Updates `package.json`
-   - Updates `CHANGELOG.md`
-   - Creates git tag
-   - Creates GitLab release
-   - Publishes to GitLab Packages
-
-### Manual Release (Not Recommended)
-
-Only use for emergency hotfixes:
-
-```bash
-npm version patch  # or minor, major
-git push --follow-tags
-```
-
----
-
-## Schema Versioning
-
-OSSA schema versions follow specification versions:
-
-```
-Package Version  → Schema Directory
------------------------------------------
-v0.2.2          → spec/v0.2.6/
-v0.3.0          → spec/v0.2.6/
-v1.0.0          → spec/v0.2.6/
-```
-
-### Schema Compatibility
-
-- **MAJOR**: Breaking schema changes (incompatible agents)
-- **MINOR**: Backward-compatible additions (new optional fields)
-- **PATCH**: Bug fixes, clarifications (no schema changes)
-
----
-
-## Publishing Workflow
-
-### Development Branch
-
-```mermaid
-graph LR
-A[Commit to development] --> B[CI runs tests]
-B --> C[semantic-release runs]
-C --> D[Creates v0.3.0-dev.0]
-D --> E[Publishes to GitLab Packages with 'development' tag]
-```
-
-### Main Branch
-
-```mermaid
-graph LR
-A[Merge to main] --> B[CI runs tests]
-B --> C[semantic-release runs]
-C --> D[Creates v0.3.0]
-D --> E[Publishes to GitLab Packages with 'latest' tag]
-E --> F[Manual trigger to publish to npmjs.com]
-```
-
----
-
-## Version History
-
-| Version | Release Date | Type | Highlights |
-|---------|--------------|------|------------|
-| 0.2.2 | 2025-10-28 | Patch | Schema fixes, CI improvements |
-| 0.2.0 | 2025-10-27 | Minor | Added KAgent bridge, MCP tools |
-| 0.1.9 | 2024-XX-XX | Minor | Extensions, taxonomy, observability |
-| 0.1.8 | 2024-XX-XX | Minor | Initial stable release |
-
----
-
-## Configuration Files
-
-### `.releaserc.json`
-Semantic-release configuration:
-- Commit analysis rules
-- Changelog generation
-- GitLab release creation
-- npm publishing settings
-
-### `.gitlab-ci.yml`
-CI/CD pipeline:
-- `semantic-release:development` job
-- `semantic-release:main` job
-- `publish:gitlab-packages` job
-- `publish:npmjs:manual` job
-
----
-
-## FAQ
-
-### Q: How do I create a pre-release?
-
-**A**: Commit to `development` branch with conventional commits:
-```bash
-git checkout development
-git commit -m "feat: experimental MCP bridge"
-git push origin development
-# Creates v0.3.0-dev.0
-```
-
-### Q: How do I create a stable release?
-
-**A**: Merge `development` to `main`:
-```bash
-git checkout main
-git merge development --no-ff
-git push origin main
-# Creates v0.3.0
-```
-
-### Q: How do I force a specific version?
-
-**A**: Use commit message with `BREAKING CHANGE:` for major, or scope for minor:
-```bash
-# Force major version
-git commit -m "feat: new schema format
-
-BREAKING CHANGE: Incompatible with v0.x agents"
-
-# Force minor version
-git commit -m "feat: add new optional field"
-```
-
-### Q: Can I skip a release?
-
-**A**: Yes, add `[skip ci]` to commit message:
-```bash
-git commit -m "chore: update docs [skip ci]"
-```
-
-### Q: How do I publish to npmjs.com?
-
-**A**: Semantic-release creates the tag and GitLab release. Then manually trigger the `publish:npmjs:manual` job in GitLab CI.
-
----
-
-## Best Practices
-
-1. ✅ **Always use conventional commits** - Enables automation
-2. ✅ **Write clear commit messages** - Appears in CHANGELOG
-3. ✅ **One feature per commit** - Easier to track changes
-4. ✅ **Test on development first** - Use pre-releases
-5. ✅ **Review CHANGELOG** - Before merging to main
-6. ❌ **Don't manually edit package.json version** - Let semantic-release handle it
-7. ❌ **Don't create tags manually** - Semantic-release does this
-8. ❌ **Don't skip tests** - CI must pass for release
-
----
-
-## Support
-
-- **Documentation**: [docs/](../docs/)
-- **Issues**: https://github.com/blueflyio/openstandardagents/issues
-- **Releases**: https://github.com/blueflyio/openstandardagents/releases
-
----
-
-**Last Updated**: 2025-10-28
-**Version**: 0.2.2

package/website/dev.sh

@@ -1,53 +0,0 @@
-#!/bin/bash
-# OSSA Website - Dev Server with OrbStack
-# Auto-detects worktree and sets unique domain
-#
-# Usage:
-#   cd website && ./dev.sh           # Start dev server
-#   cd website && ./dev.sh down      # Stop dev server
-#   cd website && ./dev.sh logs      # View logs
-
-set -e
-
-# Detect if we're in a worktree or main repo
-# Structure: /worktrees/<worktree-name>/website or /openstandardagents/website
-REPO_DIR=$(dirname "$PWD")
-REPO_NAME=$(basename "$REPO_DIR")
-PARENT_OF_REPO=$(basename "$(dirname "$REPO_DIR")")
-
-# Determine domain based on location
-if [ "$PARENT_OF_REPO" = "worktrees" ]; then
-  # In a worktree: use worktree name
-  DOMAIN="$REPO_NAME"
-elif [ "$REPO_NAME" = "openstandardagents" ]; then
-  # In main repo: ossa.orb.local
-  DOMAIN="ossa"
-else
-  DOMAIN="$REPO_NAME"
-fi
-
-export OSSA_DOMAIN="$DOMAIN"
-
-echo "🌐 Domain: https://${DOMAIN}.orb.local"
-echo ""
-
-case "${1:-up}" in
-  up|start)
-    docker compose -f docker-compose.dev.yml up -d
-    echo ""
-    echo "✅ Dev server starting at https://${DOMAIN}.orb.local"
-    echo "   Run './dev.sh logs' to view output"
-    ;;
-  down|stop)
-    docker compose -f docker-compose.dev.yml down
-    ;;
-  logs)
-    docker compose -f docker-compose.dev.yml logs -f
-    ;;
-  restart)
-    docker compose -f docker-compose.dev.yml restart
-    ;;
-  *)
-    echo "Usage: ./dev.sh [up|down|logs|restart]"
-    ;;
-esac

package/website/docker-compose.dev.yml

@@ -1,36 +0,0 @@
-# OSSA Website - Development with OrbStack
-# Works from any worktree - domain derived from parent directory name
-#
-# Usage:
-#   cd website && docker compose -f docker-compose.dev.yml up
-#
-# Domains:
-#   /openstandardagents/website     → ossa.orb.local (main repo)
-#   /worktrees/website-design       → website-design.orb.local
-#   /worktrees/ossa-97-sync-cli     → ossa-97-sync-cli.orb.local
-
-services:
-  ossa-dev:
-    image: node:22-alpine
-    working_dir: /app
-    command: sh -c "npm install --legacy-peer-deps && npm run dev"
-    ports:
-      - "3000"
-    volumes:
-      - .:/app
-      - node_modules:/app/node_modules
-      - ../examples:/examples:ro
-    environment:
-      - NODE_ENV=development
-      - WATCHPACK_POLLING=true
-    labels:
-      # OrbStack auto-domain: uses parent directory name
-      - "dev.orbstack.domains=${OSSA_DOMAIN:-ossa}.orb.local"
-    healthcheck:
-      test: ["CMD", "wget", "-q", "--spider", "http://localhost:3000"]
-      interval: 10s
-      timeout: 5s
-      retries: 3
-
-volumes:
-  node_modules:

package/website/lib/version.ts

@@ -1,35 +0,0 @@
-// OSSA version constants
-// AUTO-GENERATED - DO NOT EDIT DIRECTLY
-// Update package.json version instead, then run: npm run sync-version
-
-import versionsData from './versions.json';
-
-export const OSSA_VERSION = "0.2.6";
-export const OSSA_VERSION_TAG = `v${OSSA_VERSION}`;
-export const OSSA_API_VERSION = `ossa/v${OSSA_VERSION}`;
-export const OSSA_SCHEMA_VERSION = OSSA_VERSION;
-
-// Aliases for backward compatibility
-export const STABLE_VERSION = OSSA_VERSION;
-export const STABLE_VERSION_TAG = OSSA_VERSION_TAG;
-
-// Version data from versions.json
-export const STABLE_VERSIONS = versionsData.all.filter((v: any) => v.type === 'stable');
-export const DEV_VERSIONS = versionsData.all.filter((v: any) => v.type === 'dev' || v.type === 'prerelease');
-export const ALL_VERSIONS = versionsData.all;
-export const DEV_VERSION_TAG = versionsData.dev ? `v${versionsData.dev}` : undefined;
-
-// Utility to get version info
-export function getVersionInfo(version: string): any {
-  return versionsData.all.find((v: any) => v.version === version);
-}
-
-// Utility to get schema path
-export function getSchemaPath(ver = OSSA_VERSION): string {
-  return `/schemas/ossa-${ver}.schema.json`;
-}
-
-// Utility to get spec path
-export function getSpecPath(ver = OSSA_VERSION): string {
-  return `/spec/v${ver}/ossa-${ver}.schema.json`;
-}

package/website/lib/versions.json

@@ -1,103 +0,0 @@
-{
-  "stable": "0.2.5-RC",
-  "latest": "0.2.5-RC",
-  "dev": "0.2.6-dev",
-  "all": [
-    {
-      "version": "0.2.4",
-      "tag": "v0.2.4",
-      "apiVersion": "ossa/v0.2.4",
-      "type": "stable",
-      "published": true,
-      "available": true
-    },
-    {
-      "version": "0.2.5-RC",
-      "tag": "v0.2.5-RC",
-      "apiVersion": "ossa/v0.2.5-RC",
-      "type": "stable",
-      "published": true,
-      "available": true
-    },
-    {
-      "version": "0.2.7",
-      "tag": "v0.2.7",
-      "apiVersion": "ossa/v0.2.7",
-      "type": "stable",
-      "published": false,
-      "available": false
-    },
-    {
-      "version": "0.2.6",
-      "tag": "v0.2.6",
-      "apiVersion": "ossa/v0.2.6",
-      "type": "stable",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.6/ossa-0.2.6.schema.json"
-    },
-    {
-      "version": "0.2.5",
-      "tag": "v0.2.5",
-      "apiVersion": "ossa/v0.2.5",
-      "type": "stable",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.5/ossa-0.2.5.schema.json"
-    },
-    {
-      "version": "0.2.3",
-      "tag": "v0.2.3",
-      "apiVersion": "ossa/v0.2.3",
-      "type": "stable",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.3/ossa-0.2.3.schema.json"
-    },
-    {
-      "version": "0.2.2",
-      "tag": "v0.2.2",
-      "apiVersion": "ossa/v0.2.2",
-      "type": "stable",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.2/ossa-0.2.2.schema.json"
-    },
-    {
-      "version": "0.2.1",
-      "tag": "v0.2.1",
-      "apiVersion": "ossa/v0.2.1",
-      "type": "stable",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.1/ossa-0.2.1.schema.json"
-    },
-    {
-      "version": "0.2.0",
-      "tag": "v0.2.0",
-      "apiVersion": "ossa/v0.2.0",
-      "type": "stable",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.0/ossa-0.2.0.schema.json"
-    },
-    {
-      "version": "0.1.9",
-      "tag": "v0.1.9",
-      "apiVersion": "ossa/v0.1.9",
-      "type": "stable",
-      "published": true,
-      "available": true
-    },
-    {
-      "version": "0.2.6-dev",
-      "tag": "v0.2.6-dev",
-      "apiVersion": "ossa/v0.2.6-dev",
-      "type": "dev",
-      "published": false,
-      "available": true,
-      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.6-dev/ossa-0.2.6-dev.schema.json"
-    }
-  ],
-  "fallbackVersion": "0.2.3"
-}

package/website/next.config.ts

@@ -1,18 +0,0 @@
-import type { NextConfig } from 'next';
-
-const nextConfig: NextConfig = {
-  output: 'export',
-  distDir: 'out',
-  trailingSlash: true,
-  images: {
-    unoptimized: true
-  },
-  eslint: {
-    ignoreDuringBuilds: true,
-  },
-  typescript: {
-    ignoreBuildErrors: true,
-  },
-};
-
-export default nextConfig;

package/website/nginx.conf

@@ -1,32 +0,0 @@
-server {
-    listen 80;
-    server_name localhost;
-    root /usr/share/nginx/html;
-    index index.html;
-
-    # Enable gzip compression
-    gzip on;
-    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
-
-    # Security headers
-    add_header X-Frame-Options "SAMEORIGIN" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header X-XSS-Protection "1; mode=block" always;
-
-    # Serve static files
-    location / {
-        try_files $uri $uri.html $uri/ =404;
-    }
-
-    # Cache static assets
-    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
-        expires 1y;
-        add_header Cache-Control "public, immutable";
-    }
-
-    # Handle 404 errors
-    error_page 404 /404.html;
-    location = /404.html {
-        internal;
-    }
-}