@bluefly/openstandardagents 0.1.9

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

@@ -0,0 +1,31 @@
+# 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

@@ -0,0 +1,95 @@
+# 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

@@ -0,0 +1,284 @@
+# 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/lib/versions.json

@@ -0,0 +1,77 @@
+{
+  "stable": "0.2.4",
+  "latest": "0.2.4",
+  "dev": "0.2.5-dev",
+  "all": [
+    {
+      "version": "0.2.4",
+      "tag": "v0.2.4",
+      "apiVersion": "ossa/v0.2.4",
+      "type": "stable",
+      "published": true,
+      "available": true
+    },
+    {
+      "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": false,
+      "available": false
+    },
+    {
+      "version": "0.2.5-dev",
+      "tag": "v0.2.5-dev",
+      "apiVersion": "ossa/v0.2.5-dev",
+      "type": "dev",
+      "published": true,
+      "available": true
+    },
+    {
+      "version": "0.2.4-dev",
+      "tag": "v0.2.4-dev",
+      "apiVersion": "ossa/v0.2.4-dev",
+      "type": "prerelease",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.4-dev/ossa-0.2.4-dev.schema.json"
+    }
+  ],
+  "fallbackVersion": "0.2.3"
+}

package/website/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <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

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

package/website/out/build-manifest.json

@@ -0,0 +1,17 @@
+{
+  "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

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

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

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

package/website/out/package.json

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

package/website/out/prerender-manifest.json

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

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

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

package/website/out/routes-manifest.json

@@ -0,0 +1 @@
+{"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

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

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

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

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

@@ -0,0 +1,19 @@
+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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+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

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