@bluefly/openstandardagents 0.2.4

package/.releaserc.json.disabled

@@ -0,0 +1,81 @@
+{
+  "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/CHANGELOG.md

@@ -0,0 +1,152 @@
+# Changelog
+
+All notable changes to OSSA (Open Standard for Scalable AI Agents) will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.4](https://github.com/blueflyio/openstandardagents/compare/v0.2.3...v0.2.4) (2025-11-19)
+
+### Package Rename
+
+* **IMPORTANT**: Package renamed from `@bluefly/open-standards-scalable-agents` to `@bluefly/openstandardagents`
+* The old package `@bluefly/open-standards-scalable-agents` has been deprecated
+* Update your dependencies: `npm install @bluefly/openstandardagents`
+
+### Website Fixes
+
+* Fixed 100+ broken links (gitlab.bluefly.io → github.com/blueflyio/openstandardagents)
+* Fixed npm registry auth in CI pipeline
+* Standardized all package references across documentation
+* Fixed broken internal links (/docs/deployment, /research, CLI-Reference)
+* Updated all schema version references to v0.2.3
+* Fixed RSS feed base URL to openstandardagents.org
+
+## [0.2.3](https://github.com/blueflyio/openstandardagents/compare/v0.2.2...v0.2.3) (2025-11-12)
+
+### Documentation
+
+* **spec**: Created versioned release structure in spec/v0.2.3/ with schema, README, CHANGELOG, and migration guide
+* **examples**: Enhanced inline documentation for kAgent and integration pattern examples
+* **migrations**: Added comprehensive migration guide from v0.2.2 to v0.2.3 (no breaking changes)
+* **compatibility**: Documented backward compatibility with v0.2.2
+
+### Features
+
+* **schema**: Added v0.2.3 schema support with backward compatibility for v0.2.2
+* **types**: Extended SchemaVersion type to include '0.2.3'
+* **repository**: Updated SchemaRepository to load v0.2.3 schema files
+* **validation**: Set v0.2.3 as default version for validation service
+
+### Bug Fixes
+
+* **git**: Cleaned up diverged branches (merged main → development)
+* **tags**: Removed erroneous v0.3.0 tag from repository
+* **versions**: Reset all version references to 0.2.3 (removed v2.0.0 confusion)
+
+### BREAKING CHANGES
+
+**None** - This is a fully backward-compatible patch release. All v0.2.2 manifests work without modification.
+
+## [2.0.0](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/compare/v1.0.0...v2.0.0) (2025-11-05)
+
+
+### Bug Fixes
+
+* add v0.2.2 schema JSON files to git ([7ad617a](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/7ad617a5bcdb2304e4aaa9424562fa1654d90fb4))
+* add v0.2.2 schema support and set as default ([da22d4d](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/da22d4d47d4e9cc732c33290f971c670647d3318))
+* all tests pass with v0.2.2 format ([ee00098](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/ee00098772bbb9b6c128b483dce0366ce983329c))
+* change releases to manual triggers on main branch only ([7d48895](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/7d4889515c85107c9ca56cb624ebe70846af6041))
+* complete ESM module support with proper .js extensions ([b9754f3](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b9754f384cde11640860ceb3370b8180c290c2b8))
+* convert ES module syntax in convert-to-kagent.js ([dba2b37](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/dba2b37c3992545b0230e6ae0458a0c215c54852))
+* convert ES module syntax in convert-to-kagent.js ([9b00af6](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/9b00af64966ea0a2a2183ecbcd4b2837767968f0))
+* convert release.config.js to ES module syntax ([b9cacbf](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b9cacbfda385234034f6afb19925c6884bacb3cc))
+* correct version from 1.0.0 to 0.3.0 ([1786934](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/178693428cf72d8bdc216ddfd65d111ec41f811f))
+* correct version to 0.2.1 (patch bump) ([4227258](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/42272581065db0fc3bf30b3f4fd65a27af0dfd93))
+* disable promote-to-main job - use merge requests for main branch ([76e4e0b](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/76e4e0b6284ca346dd9768e827bbb5c083226a5c))
+* **ci:** make promote-to-main fast-forward-only; auto-create MR on conflicts via API ([a414db0](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/a414db0d5fda70d499ef9e55162f499a39d029a8))
+* **ci:** make promote-to-main script a single multiline string to satisfy YAML parsing ([c1563ea](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/c1563eae6a90365db699f5e3c63e9268ec79e1dd))
+* **ci:** promote-to-main handles shallow clones and unrelated histories; add auth remote ([7a66d60](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/7a66d60142541505d0a65d0d5413adc34c24a235))
+* **ci:** remove colon from commit message to fix YAML parsing ([260270a](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/260270a24ce59752aef963a293b62b26e2c996c0))
+* **ci:** remove invalid need on promote-to-main (cannot need later-stage job) ([211dbf7](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/211dbf7cd38e3ffc4dac3ced00cf320754f815f1))
+* **ci:** remove stray text and update development branch git config ([eb895b5](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/eb895b580ab27cf84bc005340eeff43ce6c2bb6c))
+* **ci:** rename job to avoid YAML colon parsing issue ([f641574](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/f6415745b4423636d332915e9061e948142a3959))
+* replace all gitlab.bluefly.io references with new instance ([89496c7](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/89496c7fa1e723491482f4c804fd9addf0da65f8))
+* replace gitlab.bluefly.io with app-4001.cloud.bluefly.io ([b8480a6](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b8480a6d089c790f1d4f17359f9c79951239824e))
+* revert to version 0.2.2 and fix schema validation ([5789f6d](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/5789f6d7bfa0cc8638307902701ac967579097b0))
+* schema formatting ([3dd018b](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/3dd018b56756da1821658a4a7ee8986e55c4b632))
+* update all tests for v0.2.2 format ([34bb695](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/34bb695bd2376b9d93d47d6867bf8b1f4a4e4b73))
+* update CHANGELOG version to 0.3.0 ([b10b9f4](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b10b9f4c38ece7455995ccd96a28d4cfedf4df36))
+* **ci:** update Node.js version to 22 for semantic-release compatibility ([eef4b89](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/eef4b89de9e4ef4cf3361a9e95d30ee81e706e78))
+* update version to 0.2.2 and reorganize spec directory ([5f9a8a0](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/5f9a8a0f3d7fa6386d88e07da70c5fd775812bc8))
+* **aiflow:** URGENT - Reduce CPU requests from 500m to 50m ([846c8fd](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/846c8fda3861120d6324ce957bf33b03fa484826))
+* **ci:** use PRIVATE-TOKEN with CI_JOB_TOKEN for MR API; reuse existing MR if present ([afd8c25](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/afd8c258b635c519bd0698adb8972e1c09e6efe4))
+* validate command supports both v0.2.2 and v1.0 formats ([4d777d0](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/4d777d08ab49267ad8670acaf8d0fdfb3617cfb9))
+
+
+### chore
+
+* clean up OSSA for npm publication ([f6d2c27](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/f6d2c27b3ac972cf065bfe4d67cf1d9e51f47b51))
+
+
+### Features
+
+* add CryptoSage AIFlow social agent example ([9c03a6b](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/9c03a6b94f0741a56e1aaaefebd71d387f428235))
+* add CryptoSage AIFlow social agent example ([36a1a21](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/36a1a219d546bf29185c4df7218a844e5891a70c))
+* add ecosystem tasks orchestrator agent ([276b868](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/276b868722d46ed1198f3a7ffc1f37e815d82d3b))
+* add ecosystem tasks orchestrator agent ([b9ac082](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b9ac082f2746107de11ebddba26fcc0e5c065ea0))
+* add kagent.dev and AIFlow-Agent bridge support to OSSA 1.0 ([c83f462](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/c83f46270cf7264dbe6b7a3936373a6568f6015e))
+* add kagent.dev and AIFlow-Agent bridge support to OSSA 1.0 ([2a98c1e](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/2a98c1ebd09eb7d34992dee44074073f070f89bf))
+* **ci:** add manual merge-to-main button after successful pipeline ([d3fb40c](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/d3fb40c5d1aef7bda5cac15d0c2215cfc3f77a37))
+* **ci:** add manual promotion and release buttons ([c57fb66](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/c57fb66e3f258a0ae87c51db9d6f2c1d7d9cdff2))
+* **ossa:** add OpenAI Agents SDK bridge extension ([3cf4c9f](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/3cf4c9fd5ae6c042a96c5ec328d514bacd8936c9))
+* add OpenAPI/Swagger specification extensions for AI agents ([bfe5025](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/bfe5025a83d06449648cd3e92588568bc42217c8))
+* **compliance:** Add OSSA reasoning compliance extension schema for chain-of-thought auditing ([9bb60ec](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/9bb60ecc20b56df65f0e3d5e8562104386b773d7))
+* **automation:** Add resource validation to prevent cluster exhaustion ([3910b66](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/3910b662905661504e57969bc4d76b6c87282dbc))
+* add semantic-release for automated versioning ([589d530](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/589d5304c8e1b5a59d3ba0b15a809a961acc4e7e))
+* complete OSSA ecosystem automation suite ([cbef539](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/cbef539551430f7710cf689f50ea0aad4c8d3bb2))
+* complete OSSA ecosystem automation suite ([abc485f](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/abc485fc00344a3fe405739b734d8807cdf9adc2))
+* complete OSSA v0.2.2 agent migration with framework integration ([b0ab662](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b0ab662f31faafed8de01e2ffb4a5a8c948eb634))
+* Complete OSSA v1.0 TypeScript implementation with Drupal integration ([be27188](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/be271880728e4dc6f164b4c85af432daf3d66858))
+* **aiflow:** Complete Phases 2 & 3 - Production-ready AIFlow integration ([0f81e9d](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/0f81e9d0c77586241caf94e593ad738481c0f68d)), closes [#1876](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1876) [#1877](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1877) [#1878](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1878)
+* Complete platform integration - OpenAPI + Helm for all projects ([d7140aa](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/d7140aac1e780d6094ef5aa20cf31c9adf3072d6))
+* Enhanced OSSA CLI with audit, inspect, and schema commands ([ca21cc2](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/ca21cc271161f592dd39a9e4bd7d7f3fd97a0004)), closes [#178](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/178)
+* integrate v1.0 to v0.2.2 migration into OSSA CLI ([349c4dd](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/349c4ddda10066a628447fff6a62edc09615e3be))
+* **kagent:** intelligent agent deployment + ecosystem tooling ([b602d25](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/b602d25e9b200e01ff07be1fdf95a09da5938cb6))
+* intelligent agent deployment with resource optimization ([e9fba1e](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/e9fba1eedab9dcc6c5e0674a192bdf5315152984))
+* mass cleanup and standardization - ZERO ERRORS ([79cb19d](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/79cb19d1e8b7b0454a25abf9a8e18d765aae5fd8))
+* mass cleanup and standardization - ZERO ERRORS ([cd6f1cc](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/cd6f1cc5278c74bde5b1ad63e71d8665e0bb26a4))
+* mass cleanup and standardization - ZERO ERRORS ([3452f4f](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/3452f4f3c2b0a9d9ac72ac2c6917a4bda5ac050c))
+* **spec:** organize OSSA spec with clean v1.0 versioning ([08468e3](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/08468e3831fa8dc8e83bc2bbfdae352ab3f33e10))
+* OSSA v0.1.9 with kAgent extension support ([1d4c0b5](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/1d4c0b50cdcb5d4bf2fcc3f648968688f3139517))
+* **aiflow:** Phase 2 - BuildKit registration, Phoenix tracing, integration tests ([ee7279d](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/ee7279db63cee7afe4be2a2b044d87b40778f0f4)), closes [#1876](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1876)
+* **aiflow:** Phase 3 - K8s deployment, load testing, CI/CD, monitoring ([f5b9f46](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/f5b9f46ddea9fc90910a773093d620813a5945b1)), closes [#1877](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1877)
+* **aiflow:** Phase 3 - Production deployment, load testing, monitoring ([6066100](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/60661001e698edf269c4b4d2a450dc36090c0935)), closes [#1877](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1877)
+* **aiflow:** Phase 4 - SLO/SLA, incident response, chaos engineering ([3fb78f1](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/3fb78f15a25e9cf700e8e61bf68c088652afc066)), closes [#1878](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/issues/1878)
+* update k6 load testing scenarios ([e0bfc15](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/commit/e0bfc1550962e8357fd446f23babdec7ff7634ef))
+
+
+### BREAKING CHANGES
+
+* None - this is additive functionality
+* Manual version management replaced with semantic-release
+* Cleaned up project structure for v1.0.0 release
+* - Removed old Jest config and legacy tests
+- Removed helm charts (moved to agent-buildkit)
+- CLI now uses TypeScript compiled output
+
+Test Results: 68/68 passing, 97.85% coverage
+Status: Production Ready
+* - CLI now requires OSSA 1.0 manifest format
+- Production example updated to OSSA 1.0 spec
+
+New Features:
+- audit command: Score agents 0-100 on completeness, best practices, security, performance
+- inspect command: Detailed agent information with --json output
+- schema command: Query schema attributes (roles, protocols, compliance, bridges)
+- Fixed ES module conflicts in CLI
+
+Improvements:
+- Production example validates with 80/100 audit score
+- All required fields properly enforced
+- Comprehensive validation output

package/CONTRIBUTING.md

@@ -0,0 +1,249 @@
+# Contributing to OSSA
+
+Thank you for your interest in contributing to **OSSA (Open Standard for Scalable AI Agents)**!
+
+## 📋 Table of Contents
+
+- [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)
+
+## 🤝 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/BlueflyCollective/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** if needed (optional)
+7. **Merge** using "Squash and Merge" or "Rebase and Merge"
+
+### PR Title Convention
+
+PR titles should follow the conventional commit format:
+
+```
+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
+
+### 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: security@bluefly.io
+
+## 📊 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://ossa.bluefly.io/docs
+- **GitHub Actions**: https://github.com/BlueflyCollective/openstandardagents/actions
+
+---
+
+**Questions?** Open a [Discussion](https://github.com/BlueflyCollective/openstandardagents/discussions).

package/LICENSE

@@ -0,0 +1,190 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+   Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+   stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+   that You distribute, all copyright, patent, trademark, and
+   attribution notices from the Source form of the Work,
+   excluding those notices that do not pertain to any part of
+   the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+   distribution, then any Derivative Works that You distribute must
+   include a readable copy of the attribution notices contained
+   within such NOTICE file, excluding those notices that do not
+   pertain to any part of the Derivative Works, in at least one
+   of the following places: within a NOTICE text file distributed
+   as part of the Derivative Works; within the Source form or
+   documentation, if provided along with the Derivative Works; or,
+   within a display generated by the Derivative Works, if and
+   wherever such third-party notices normally appear. The contents
+   of the NOTICE file are for informational purposes only and
+   do not modify the License. You may add Your own attribution
+   notices within Derivative Works that You distribute, alongside
+   or as an addendum to the NOTICE text from the Work, provided
+   that such additional attribution notices cannot be construed
+   as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Support. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+Copyright 2024-2025 OSSA Standards Team
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.