@bluefly/openstandardagents 0.1.9 → 0.2.5-RC

package/website/.wiki-export/README.md

@@ -1,31 +0,0 @@
-# OSSA Documentation
-
-## Core Documentation
-
-- **[Getting Started](Getting-Started)** - Quick start guide for OSSA
-- **[OpenAPI Extensions](OpenAPI-Extensions)** - How OSSA extends OpenAPI/Swagger for AI agents
-- **[Migration Guide](migration/)** - Upgrading from v0.1.x to v1.0
-- **[Specification](Specification/)** - OSSA 1.0 JSON Schema
-- **[Examples](Examples/)** - Reference implementations
-
-## Additional Resources
-
-For comprehensive documentation, guides, and architecture details, visit:
-
-**[GitHub Repository](https://github.com/blueflyio/openstandardagents)**
-
-The repository contains:
-- Architecture guides
-- Deployment strategies
-- Integration tutorials
-- Best practices
-- Community guidelines
-- Contributing guidelines
-
-## Quick Links
-
-- **Specification**: [spec/ossa-1.0.schema.json](Specification/ossa-1.0.schema.json)
-- **npm Package**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
-- **GitHub Repository**: [blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
-- **Issues**: [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
-

package/website/.wiki-export/RELEASE-READINESS.md

@@ -1,95 +0,0 @@
-# Release Readiness Checklist - v0.2.4
-
-## ✅ Core OSSA Features
-
-- [x] **Agent Folder Structure Standard** - Defined in `docs/agent-folder-structure.md`
-- [x] **Discovery Service** - Implemented in `src/services/discovery.service.ts`
-- [x] **CLI Discover Command** - Implemented in `src/cli/commands/discover.command.ts`
-- [x] **Workspace Discovery Documentation** - Complete in `website/content/docs/core-concepts/Workspace-Discovery.md`
-- [x] **Project Structure Documentation** - Updated in `website/content/docs/core-concepts/Project-Structure.md`
-
-## ✅ Examples & Documentation
-
-- [x] **Drupal Example** - `examples/drupal/module-with-agents/`
-- [x] **WordPress Example** - `examples/wordpress/plugin-with-agents/`
-- [x] **Laravel Example** - `examples/laravel/package-with-agents/`
-- [x] **React/Next.js Example** - `examples/react/component-with-agents/`
-- [x] **Python Example** - `examples/python/package-with-agents/`
-- [x] **Node.js/npm Example** - `examples/nodejs/package-with-agents/`
-- [x] **Monorepo Example** - `examples/monorepo/workspace-agents/`
-- [x] **Ecosystem Guides** - All 7 guides in `website/content/docs/ecosystems/`
-- [x] **Best Practices Guide** - `website/content/docs/guides/agent-organization.md`
-
-## ✅ CI/CD Agents
-
-- [x] **Validation Agent** - `.gitlab/agents/validation-agent/`
-- [x] **Build Agent** - `.gitlab/agents/build-agent/`
-- [x] **Test Agent** - `.gitlab/agents/test-agent/`
-- [x] **Release Agent** - `.gitlab/agents/release-agent/`
-- [x] **Documentation Agent** - `.gitlab/agents/documentation-agent/`
-- [x] **All agents have README.md** - Complete documentation
-
-## ✅ Website & Playground
-
-- [x] **Navigation Updated** - Added Core Concepts, Ecosystems, Guides sections
-- [x] **Playground Enhanced** - Added Discovery, Workspace, Capabilities, Simulator tabs
-- [x] **All Examples Validated** - All pass `ossa validate`
-
-## ✅ Integration Analysis
-
-- [x] **Integration Analysis Document** - `docs/INTEGRATION-ANALYSIS.md`
-- [x] **Compatibility Verified** - All examples work with existing OSSA CLI
-- [x] **Discovery Service Tested** - Builds successfully, integrated into DI container
-
-## ⚠️ Platform Integrations (NOT Required for Release)
-
-These are **optional** and can be implemented by the community:
-
-- [ ] Drupal Service Provider - Community implementation
-- [ ] WordPress Plugin Hooks - Community implementation
-- [ ] Laravel Service Provider - Community implementation
-- [ ] React/Next.js Build Plugin - Community implementation
-- [ ] Python Discovery Module - Community implementation
-- [ ] Node.js Discovery Module - Community implementation
-
-**Note**: These are NOT blockers for release. The standard is defined, examples exist, and the OSSA CLI can discover agents. Platform-specific integrations can be added by the community as needed.
-
-## ✅ Release Checklist
-
-### Code
-- [x] All TypeScript compiles without errors
-- [x] All examples validate successfully
-- [x] Discovery service integrated into DI container
-- [x] CLI discover command works
-
-### Documentation
-- [x] Standard specification documented
-- [x] All ecosystem examples created
-- [x] All ecosystem guides written
-- [x] Best practices guide complete
-- [x] Integration analysis complete
-
-### Testing
-- [x] Examples validate: `ossa validate examples/*/.agents/*/agent.ossa.yaml`
-- [x] Discovery works: `ossa discover`
-- [x] Build succeeds: `npm run build`
-
-## 🚀 Ready for Release
-
-**YES, this is ready for release!**
-
-The agent folder structure standard is:
-- ✅ **Complete** - Standard defined, examples created, documentation written
-- ✅ **Functional** - Discovery service implemented, CLI command works
-- ✅ **Compatible** - Works with existing OSSA tools
-- ✅ **Extensible** - Platform integrations can be added by community
-
-Platform integrations (Drupal, WordPress, etc.) are **NOT required** for release. They are optional enhancements that the community can implement as needed.
-
-## Next Steps
-
-1. **Release v0.2.4** with agent folder structure standard
-2. **Community can implement** platform-specific integrations
-3. **Document community integrations** as they're created
-4. **Iterate** based on community feedback
-

package/website/.wiki-export/VERSIONING.md

@@ -1,284 +0,0 @@
-# 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.2/
-v0.3.0          → spec/v0.3.0/
-v1.0.0          → spec/v1.0.0/
-```
-
-### 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/next-env.d.ts

@@ -1,6 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-/// <reference path="./out/types/routes.d.ts" />
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/website/out/app-build-manifest.json

@@ -1,3 +0,0 @@
-{
-  "pages": {}
-}

package/website/out/build-manifest.json

@@ -1,17 +0,0 @@
-{
-  "polyfillFiles": [
-    "static/chunks/polyfills.js"
-  ],
-  "devFiles": [],
-  "ampDevFiles": [],
-  "lowPriorityFiles": [
-    "static/development/_buildManifest.js",
-    "static/development/_ssgManifest.js"
-  ],
-  "rootMainFiles": [],
-  "rootMainFilesTree": {},
-  "pages": {
-    "/_app": []
-  },
-  "ampFirstPages": []
-}

package/website/out/cache/.rscinfo

@@ -1 +0,0 @@
-{"encryption.key":"C2nlm3KydVOsFdhetoJX9qPzX3AJZYpp5ALkI8/yaYg=","encryption.expire_at":1764906027852}

package/website/out/cache/next-devtools-config.json

@@ -1 +0,0 @@
-{}

package/website/out/package.json

@@ -1 +0,0 @@
-{"type": "commonjs"}

package/website/out/prerender-manifest.json

@@ -1,11 +0,0 @@
-{
-  "version": 4,
-  "routes": {},
-  "dynamicRoutes": {},
-  "notFoundRoutes": [],
-  "preview": {
-    "previewModeId": "8e6b07b438052679aade0be6ed99c184",
-    "previewModeSigningKey": "b4c4d71055aefde3608c7a1773833a2a5e6b96634aca5ede7c41bc32facc9ca3",
-    "previewModeEncryptionKey": "dc2ee74de6b12d2cc6ce5412846faef29c5f67a20ba56bb70d980682c2c3042f"
-  }
-}

package/website/out/react-loadable-manifest.json

@@ -1 +0,0 @@
-{}

package/website/out/routes-manifest.json

@@ -1 +0,0 @@
-{"version":3,"caseSensitive":false,"basePath":"","rewrites":{"beforeFiles":[],"afterFiles":[],"fallback":[]},"redirects":[{"source":"/:file((?!\\.well-known(?:/.*)?)(?:[^/]+/)*[^/]+\\.\\w+)/","destination":"/:file","permanent":true,"internal":true,"missing":[{"type":"header","key":"x-nextjs-data"}],"regex":"^(?:\\/((?!\\.well-known(?:\\/.*)?)(?:[^/]+\\/)*[^/]+\\.\\w+))\\/$"},{"source":"/:notfile((?!\\.well-known(?:/.*)?)(?:[^/]+/)*[^/\\.]+)","destination":"/:notfile/","permanent":true,"internal":true,"regex":"^(?:\\/((?!\\.well-known(?:\\/.*)?)(?:[^/]+\\/)*[^/\\.]+))$"}],"headers":[]}

package/website/out/server/app-paths-manifest.json

@@ -1 +0,0 @@
-{}

package/website/out/server/interception-route-rewrite-manifest.js

@@ -1 +0,0 @@
-self.__INTERCEPTION_ROUTE_REWRITE_MANIFEST="[]"

package/website/out/server/middleware-build-manifest.js

@@ -1,19 +0,0 @@
-globalThis.__BUILD_MANIFEST = {
-  "polyfillFiles": [
-    "static/chunks/polyfills.js"
-  ],
-  "devFiles": [],
-  "ampDevFiles": [],
-  "lowPriorityFiles": [],
-  "rootMainFiles": [],
-  "rootMainFilesTree": {},
-  "pages": {
-    "/_app": []
-  },
-  "ampFirstPages": []
-};
-globalThis.__BUILD_MANIFEST.lowPriorityFiles = [
-"/static/" + process.env.__NEXT_BUILD_ID + "/_buildManifest.js",
-,"/static/" + process.env.__NEXT_BUILD_ID + "/_ssgManifest.js",
-
-];

package/website/out/server/middleware-manifest.json

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "middleware": {},
-  "functions": {},
-  "sortedMiddleware": []
-}

package/website/out/server/middleware-react-loadable-manifest.js

@@ -1 +0,0 @@
-self.__REACT_LOADABLE_MANIFEST="{}"

package/website/out/server/next-font-manifest.js

@@ -1 +0,0 @@
-self.__NEXT_FONT_MANIFEST="{\"pages\":{},\"app\":{},\"appUsingSizeAdjust\":false,\"pagesUsingSizeAdjust\":false}"

package/website/out/server/next-font-manifest.json

@@ -1 +0,0 @@
-{"pages":{},"app":{},"appUsingSizeAdjust":false,"pagesUsingSizeAdjust":false}

package/website/out/server/pages-manifest.json

@@ -1 +0,0 @@
-{}

package/website/out/server/server-reference-manifest.js

@@ -1 +0,0 @@
-self.__RSC_SERVER_MANIFEST="{\n  \"node\": {},\n  \"edge\": {},\n  \"encryptionKey\": \"process.env.NEXT_SERVER_ACTIONS_ENCRYPTION_KEY\"\n}"

package/website/out/server/server-reference-manifest.json

@@ -1,5 +0,0 @@
-{
-  "node": {},
-  "edge": {},
-  "encryptionKey": "C2nlm3KydVOsFdhetoJX9qPzX3AJZYpp5ALkI8/yaYg="
-}