@bluefly/openstandardagents 0.2.9 → 0.3.0

package/.prettierignore

@@ -1,7 +0,0 @@
-
-node_modules
-dist
-build
-coverage
-*.min.js
-*.min.css

package/.prettierrc.json

@@ -1,10 +0,0 @@
-{
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": true,
-  "singleQuote": true,
-  "trailingComma": "es5",
-  "bracketSpacing": true,
-  "arrowParens": "always"
-}

package/.redocly.yaml

@@ -1,9 +0,0 @@
-extends:
-  - recommended
-
-rules:
-  no-server-example.com: off
-  no-required-schema-properties-undefined: error
-  operation-operationId: error
-  tag-description: warn
-  info-contact: warn

package/.releaserc.json

@@ -1,85 +0,0 @@
-{
-  "branches": [
-    "main",
-    {
-      "name": "development",
-      "prerelease": "dev"
-    }
-  ],
-  "plugins": [
-    [
-      "@semantic-release/commit-analyzer",
-      {
-        "preset": "conventionalcommits",
-        "releaseRules": [
-          { "type": "feat", "release": "minor" },
-          { "type": "fix", "release": "patch" },
-          { "type": "perf", "release": "patch" },
-          { "type": "revert", "release": "patch" },
-          { "type": "docs", "release": "patch" },
-          { "type": "chore", "release": false },
-          { "type": "refactor", "release": "patch" },
-          { "type": "test", "release": false },
-          { "type": "build", "release": false },
-          { "type": "ci", "release": false },
-          { "breaking": true, "release": "major" }
-        ],
-        "parserOpts": {
-          "noteKeywords": ["BREAKING CHANGE", "BREAKING CHANGES", "BREAKING"]
-        }
-      }
-    ],
-    [
-      "@semantic-release/release-notes-generator",
-      {
-        "preset": "conventionalcommits",
-        "presetConfig": {
-          "types": [
-            { "type": "feat", "section": "✨ Features", "hidden": false },
-            { "type": "fix", "section": "🐛 Bug Fixes", "hidden": false },
-            { "type": "perf", "section": "⚡ Performance", "hidden": false },
-            { "type": "revert", "section": "⏪ Reverts", "hidden": false },
-            { "type": "docs", "section": "📚 Documentation", "hidden": false },
-            { "type": "refactor", "section": "♻️ Code Refactoring", "hidden": false },
-            { "type": "test", "section": "✅ Tests", "hidden": true },
-            { "type": "build", "section": "🏗️ Build System", "hidden": true },
-            { "type": "ci", "section": "👷 CI/CD", "hidden": true },
-            { "type": "chore", "section": "🔧 Chores", "hidden": true }
-          ]
-        }
-      }
-    ],
-    [
-      "@semantic-release/changelog",
-      {
-        "changelogFile": "CHANGELOG.md",
-        "changelogTitle": "# Changelog\n\nAll notable changes to OSSA (Open Standard for Scalable AI 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": true,
-        "tarballDir": "dist"
-      }
-    ],
-    [
-      "@semantic-release/gitlab",
-      {
-        "gitlabUrl": "https://gitlab.com",
-        "assets": [
-          { "path": "dist/*.tgz", "label": "Distribution Package" },
-          { "path": "CHANGELOG.md", "label": "Changelog" }
-        ],
-        "successComment": "🎉 This ${issue.pull_request ? 'MR is included' : 'issue has been resolved'} in version ${nextRelease.version}\n\nThe release is available on:\n- [npm package](https://www.npmjs.com/package/@bluefly/openstandardagents)\n- [GitLab release](${releases[0].url})\n- [Documentation](https://openstandardagents.org)\n\nYour **${issue.pull_request ? 'merge request' : 'issue'}** is included in this release!"
-      }
-    ],
-    [
-      "@semantic-release/git",
-      {
-        "assets": ["CHANGELOG.md", "package.json", "package-lock.json"],
-        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-      }
-    ]
-  ]
-}

package/.version.json

@@ -1,6 +0,0 @@
-{
-  "current": "0.2.9",
-  "latest_stable": "0.2.5-RC",
-  "spec_path": "spec/v{version}",
-  "schema_file": "ossa-{version}.schema.json"
-}

package/.wiki-config.json

@@ -1,24 +0,0 @@
-{
-  "PROJECT_NAME": "@bluefly/openstandardagents",
-  "PROJECT_DESCRIPTION": "OSSA - Open Standard for Scalable AI Agents. A specification standard for AI agents (like OpenAPI for REST APIs). NOT a framework.",
-  "VERSION": "0.2.9",
-  "STATUS": "Active",
-  "LICENSE": "MIT",
-  "KEY_FEATURES": "- Comprehensive test suite\n- Type-safe TypeScript",
-  "REPO_URL": "https://gitlab.com/blueflyio/agent-platform/@bluefly/openstandardagents",
-  "GITLAB_ISSUES_URL": "https://gitlab.com/blueflyio/agent-platform/@bluefly/openstandardagents/-/issues",
-  "DOCS_URL": "https://gitlab.com/blueflyio/agent-platform/@bluefly/openstandardagents/-/wikis/home",
-  "TEAM_CONTACT": "team@bluefly.io",
-  "PREREQUISITES": "- Node.js 18+\n- TypeScript 5+",
-  "INSTALL_COMMAND": "npm install",
-  "START_COMMAND": "tsc --watch",
-  "VERIFY_COMMAND": "jest",
-  "BACKEND_STACK": "- Zod - Schema validation",
-  "FRONTEND_STACK": "N/A",
-  "INFRASTRUCTURE_STACK": "- Docker\n- GitLab CI/CD",
-  "API_BASE_URL": "http://localhost:3000/api",
-  "OPENAPI_URL": "N/A",
-  "UNIT_TEST_COMMAND": "jest",
-  "LINT_COMMAND": "eslint src tests --ext .ts",
-  "FORMAT_COMMAND": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\""
-}

package/CODEOWNERS

@@ -1,75 +0,0 @@
-# CODEOWNERS for openstandardagents (OSSA Spec)
-# https://docs.gitlab.com/ee/user/project/codeowners/
-
-# =============================================================================
-# DEFAULT OWNERS
-# =============================================================================
-* @blueflyio/ossa-maintainers
-
-# =============================================================================
-# SPEC & SCHEMA (Critical - Requires OSSA Bot + TypeScript Bot)
-# =============================================================================
-/spec/                     @blueflyio/ossa-spec-maintainers @bot-ossa-local
-/spec/**/*.schema.json     @blueflyio/ossa-spec-maintainers @bot-typescript-local @bot-ossa-local
-/spec/**/CHANGELOG.md      @blueflyio/ossa-spec-maintainers @bot-wiki-aggregator
-
-# =============================================================================
-# CLI & SOURCE CODE (TypeScript Bot + Dev Bot)
-# =============================================================================
-/src/                      @blueflyio/ossa-dev-team @bot-typescript-local @bot-native-local
-/bin/                      @blueflyio/ossa-dev-team @bot-typescript-local
-/tests/                    @blueflyio/ossa-dev-team @bot-typescript-local
-
-# =============================================================================
-# EXAMPLES (OSSA Bot validates, Dev Bot implements)
-# =============================================================================
-/examples/                 @blueflyio/ossa-examples-team @bot-ossa-local @bot-native-local
-
-# =============================================================================
-# CI/CD & INFRASTRUCTURE (CI Bot + K8s Agents)
-# =============================================================================
-/.gitlab-ci.yml            @flux423 @blueflyio/platform-team @bot-ci-local
-/.gitlab/                  @flux423 @blueflyio/platform-team @bot-ci-local
-/infrastructure/           @flux423 @blueflyio/platform-team @bot-ci-local
-
-# =============================================================================
-# AGENTS (OSSA Bot validates agent manifests)
-# =============================================================================
-/.agents/                  @blueflyio/ossa-agent-team @bot-ossa-local
-/agents/                   @blueflyio/ossa-agent-team @bot-ossa-local
-
-# =============================================================================
-# DOCUMENTATION (Wiki Aggregator syncs)
-# =============================================================================
-/docs/                     @blueflyio/ossa-docs-team @bot-wiki-aggregator
-README.md                  @blueflyio/ossa-docs-team @bot-wiki-aggregator
-CONTRIBUTING.md            @blueflyio/ossa-docs-team @bot-wiki-aggregator
-CHANGELOG.md               @blueflyio/ossa-docs-team @bot-wiki-aggregator
-
-# =============================================================================
-# RELEASE & VERSIONING (CI Bot manages releases)
-# =============================================================================
-package.json               @flux423 @blueflyio/ossa-maintainers @bot-ci-local
-package-lock.json          @flux423 @blueflyio/ossa-maintainers @bot-ci-local
-.releaserc.json            @flux423 @blueflyio/ossa-maintainers @bot-ci-local
-.version.json              @flux423 @blueflyio/ossa-maintainers @bot-ci-local
-
-# =============================================================================
-# SCRIPTS (TypeScript Bot + CI Bot)
-# =============================================================================
-/scripts/                  @flux423 @blueflyio/platform-team @bot-typescript-local @bot-ci-local
-
-# =============================================================================
-# BOT & AGENT TOKEN MAPPING
-# =============================================================================
-# GITLAB_BOT_TS_TOKEN      -> @bot-typescript-local  (TypeScript code)
-# GITLAB_BOT_OSSA_TOKEN    -> @bot-ossa-local        (OSSA validation)
-# GITLAB_BOT_CI_TOKEN      -> @bot-ci-local          (CI/CD pipelines)
-# GITLAB_BOT_DEV_TOKEN     -> @bot-native-local      (General dev)
-# GITLAB_BOT_WIKI_TOKEN    -> @bot-wiki-aggregator   (Documentation sync)
-#
-# K8s Agents (GitOps deployments):
-# AGENT_K8_TS_LOCAL        -> TypeScript local namespace
-# AGENT_K8_TS_PROD         -> TypeScript production namespace
-# AGENT_K8_GITLAB_LIB_CI   -> GitLab components CI
-# AGENT_K8_INFRA_PROD      -> Infrastructure production

package/CONTRIBUTING.md

@@ -1,366 +0,0 @@
-# Contributing to OSSA
-
-Thank you for your interest in contributing to **OSSA (Open Standard for Scalable AI Agents)**!
-
-## 📋 Table of Contents
-
-- [Repository Structure](#repository-structure)
-- [Code of Conduct](#code-of-conduct)
-- [Getting Started](#getting-started)
-- [Development Workflow](#development-workflow)
-- [Commit Convention](#commit-convention)
-- [Release Process](#release-process)
-- [Pull Request Process](#pull-request-process)
-- [Testing](#testing)
-- [Documentation](#documentation)
-
-## 🏗️ Repository Structure
-
-OSSA uses a **dual-repository workflow**:
-
-| Repository | Purpose | Access |
-|------------|---------|--------|
-| [GitLab](https://gitlab.com/blueflyio/openstandardagents) | Primary development, CI/CD, releases | Private (core team) |
-| [GitHub](https://github.com/blueflyio/openstandardagents) | Public mirror, community contributions | Public |
-
-### How It Works
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     Community Contribution Flow                  │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│   GitHub (Public)              GitLab (Private)                 │
-│   ┌─────────────┐              ┌─────────────┐                 │
-│   │   Issue     │──── sync ───▶│   Issue     │                 │
-│   │   or PR     │              │   or MR     │                 │
-│   └─────────────┘              └──────┬──────┘                 │
-│                                       │                         │
-│                                       ▼                         │
-│                                ┌─────────────┐                 │
-│                                │   CI/CD     │                 │
-│                                │   Tests     │                 │
-│                                └──────┬──────┘                 │
-│                                       │                         │
-│                                       ▼                         │
-│   ┌─────────────┐              ┌─────────────┐                 │
-│   │   Mirror    │◀── push ────│   Merge     │                 │
-│   │   Updated   │              │   to main   │                 │
-│   └─────────────┘              └─────────────┘                 │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Where to Contribute
-
-| Contribution Type | Where | Notes |
-|-------------------|-------|-------|
-| Bug reports | GitHub Issues | Auto-synced to GitLab |
-| Feature requests | GitHub Issues | Auto-synced to GitLab |
-| Code changes | GitHub PR | Reviewed here, merged on GitLab |
-| Documentation | GitHub PR | Same as code |
-| Security issues | Email only | ops@openstandardagents.org |
-
-### Why Dual Repositories?
-
-1. **Privacy**: Internal development, CI/CD secrets, and infrastructure stay private
-2. **Public Access**: Open specification accessible to the community
-3. **Best of Both**: GitLab's superior CI/CD + GitHub's community reach
-4. **Agent-Powered**: OSSA agents automate sync between platforms
-
-## 🤝 Code of Conduct
-
-This project adheres to a Code of Conduct. By participating, you are expected to uphold this code.
-
-## 🚀 Getting Started
-
-### Prerequisites
-
-- Node.js 20+
-- npm or pnpm
-- Git
-
-### Initial Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/blueflyio/openstandardagents.git
-cd openstandardagents
-
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Run tests
-npm test
-
-# Validate OSSA examples
-npm run validate
-```
-
-## 🔄 Development Workflow
-
-We use **GitHub Flow**:
-
-1. **Create a feature branch** from `main`:
-   ```bash
-   git checkout -b feat/your-feature-name
-   ```
-
-2. **Make your changes** following our commit convention
-
-3. **Test your changes**:
-   ```bash
-   npm test
-   npm run lint
-   npm run build
-   ```
-
-4. **Push and create a Pull Request**
-
-### Branch Naming Convention
-
-- `feat/*` - New features
-- `fix/*` - Bug fixes
-- `docs/*` - Documentation changes
-- `refactor/*` - Code refactoring
-- `test/*` - Test additions/modifications
-- `chore/*` - Build process or auxiliary tool changes
-
-## 📝 Commit Convention
-
-We use **Conventional Commits** specification. This is **CRITICAL** for automated semantic versioning.
-
-### Commit Message Format
-
-```
-<type>(<scope>): <subject>
-
-<body>
-
-<footer>
-```
-
-### Types
-
-- `feat`: New feature (triggers MINOR version bump)
-- `fix`: Bug fix (triggers PATCH version bump)
-- `docs`: Documentation only changes
-- `refactor`: Code change that neither fixes a bug nor adds a feature
-- `perf`: Performance improvement (triggers PATCH version bump)
-- `test`: Adding missing tests
-- `chore`: Changes to build process or auxiliary tools
-- `ci`: Changes to CI configuration files
-
-### Breaking Changes
-
-Add `BREAKING CHANGE:` in the commit footer or `!` after the type:
-
-```bash
-# MAJOR version bump
-git commit -m "feat!: redesign agent manifest schema
-
-BREAKING CHANGE: The manifest schema now requires apiVersion field"
-```
-
-### Examples
-
-```bash
-# Feature (MINOR version bump: 0.2.3 → 0.3.0)
-git commit -m "feat(validation): add CrewAI extension validator"
-
-# Bug fix (PATCH version bump: 0.2.3 → 0.2.4)
-git commit -m "fix(schema): correct required fields in LangChain extension"
-
-# Breaking change (MAJOR version bump: 0.2.3 → 1.0.0)
-git commit -m "feat!: migrate to apiVersion from ossaVersion
-
-BREAKING CHANGE: All manifests must now use apiVersion instead of ossaVersion"
-
-# Documentation (no version bump)
-git commit -m "docs: update getting started guide"
-```
-
-## 🎯 Release Process
-
-**Releases are fully automated using semantic-release.**
-
-### How It Works
-
-1. **Merge to `main`** with conventional commits
-2. **GitHub Actions automatically**:
-   - Analyzes commit messages
-   - Determines next version (major.minor.patch)
-   - Generates CHANGELOG.md
-   - Creates GitHub Release
-   - Publishes to npm
-   - Deploys website to GitHub Pages
-   - Comments on related PRs/issues
-
-### Version Determination
-
-| Commit Type | Version Bump | Example |
-|-------------|--------------|---------|
-| `fix:` | PATCH | 0.2.3 → 0.2.4 |
-| `feat:` | MINOR | 0.2.3 → 0.3.0 |
-| `feat!:` or `BREAKING CHANGE:` | MAJOR | 0.2.3 → 1.0.0 |
-| `docs:`, `chore:`, `test:` | No release | - |
-
-### Release Branches
-
-- **`main`**: Production releases (latest tag on npm)
-- **`develop`**: Beta releases (beta tag on npm)
-
-## 🔍 Pull Request Process
-
-1. **Update tests** for any code changes
-2. **Update documentation** as needed
-3. **Ensure CI passes**:
-   - All tests pass
-   - Linting passes
-   - Build succeeds
-   - Security audit passes
-4. **Request review** from maintainers
-5. **Address feedback**
-6. **Squash commits** for feature branches (recommended)
-7. **Merge** using "Squash and Merge" (default for feature branches)
-
-### Squash Merge Workflow
-
-**This project encourages squash merging for feature branches** to maintain a clean, readable git history.
-
-#### When to Squash
-
-- **Feature branches** (`feat/*`, `fix/*`, `refactor/*`): Always squash
-- **Documentation branches** (`docs/*`): Squash if multiple commits
-- **Major releases**: May preserve commit history (case-by-case)
-
-#### Best Practices
-
-1. **Enable squash** when creating the merge request (encouraged by default)
-2. **Write a clear squash commit message** following conventional commits format
-3. **Include issue references** in the squash commit message (e.g., `Closes #123`)
-4. **Summarize all changes** in the squash commit body if multiple features were added
-
-#### Squash Commit Message Format
-
-When squashing, the final commit message should be:
-
-```
-<type>(<scope>): <summary of all changes>
-
-- Detailed change 1
-- Detailed change 2
-- Detailed change 3
-
-Closes #123
-```
-
-**Example:**
-
-```
-feat(validation): add multi-framework extension support
-
-- Add CrewAI extension validator
-- Add LangGraph extension validator
-- Update schema documentation with examples
-- Add integration tests for all validators
-
-Closes #123, Closes #124
-```
-
-### PR Title Convention
-
-PR titles should follow the conventional commit format (this becomes the squash commit title):
-
-```
-feat: add LangGraph extension support
-fix: resolve schema validation edge case
-docs: improve OpenAPI extension examples
-```
-
-## ✅ Testing
-
-### Running Tests
-
-```bash
-# Run all tests
-npm test
-
-# Run tests in watch mode
-npm test -- --watch
-
-# Run specific test file
-npm test -- schema.repository.test.ts
-
-# Run tests with coverage
-npm test -- --coverage
-```
-
-### Test Requirements
-
-- All new features **must** have tests
-- All bug fixes **must** have regression tests
-- Maintain **>80% code coverage**
-
-## 📚 Documentation
-
-### Public Documentation
-Public-facing documentation is managed in the [GitLab Wiki](https://gitlab.com/blueflyio/openstandardagents/-/wikis/home) and automatically synced to [openstandardagents.org](https://openstandardagents.org).
-
-**Public docs include:**
-- OSSA specification and standard
-- Usage guides and tutorials
-- API reference and schema documentation
-- Migration guides
-- Community contribution guidelines
-
-### Internal Documentation
-Internal project documentation is located in `.gitlab/docs/`:
-- `/development` - Development workflows and coding standards
-  - **VERSIONING.md** - Automated version management (CRITICAL: never manually update versions)
-- `/releases` - Release management and versioning
-- `/infrastructure` - CI/CD, GitLab agents, Kubernetes setup
-- `/processes` - Project governance and internal processes
-
-### Code Documentation
-
-- Use **JSDoc** for all public APIs
-- Include **examples** in JSDoc comments
-- Document **parameters** and **return types**
-
-## 🔐 Security
-
-### Reporting Security Issues
-
-**DO NOT** open public issues for security vulnerabilities.
-
-Email: ops@openstandardagents.org
-
-## 📊 Code Style
-
-We use:
-- **ESLint** for linting
-- **Prettier** for formatting (auto-format on commit)
-- **TypeScript** for type safety
-
-```bash
-# Lint code
-npm run lint
-
-# Fix auto-fixable issues
-npm run lint -- --fix
-```
-
-## 🎓 Resources
-
-- **Conventional Commits**: https://www.conventionalcommits.org/
-- **Semantic Versioning**: https://semver.org/
-- **OSSA Specification**: https://openstandardagents.org/docs
-- **GitHub Actions**: https://github.com/blueflyio/openstandardagents/actions
-
----
-
-**Questions?** Open an [Issue](https://github.com/blueflyio/openstandardagents/issues).