@bluefly/openstandardagents 0.2.4

package/ossa-website-swarm-tasks.json

@@ -0,0 +1,105 @@
+{
+  "swarm": {
+    "name": "OSSA Website Build Team",
+    "description": "Parallel team to build out comprehensive OSSA website with diagrams, docs, and examples",
+    "tasks": [
+      {
+        "id": "architecture-diagrams",
+        "name": "Architecture & Flow Diagrams Agent",
+        "description": "Create Mermaid diagrams for agent execution flow, OSSA stack, multi-agent systems, and tool integration. Add to /website/content/docs/architecture/ with explanations.",
+        "agent_type": "documentation",
+        "priority": "critical",
+        "dependencies": [],
+        "deliverables": [
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/overview.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/execution-flow.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/stack-integration.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/multi-agent-systems.md"
+        ],
+        "context": "User wants data flow maps similar to OpenAPI.org. Create Mermaid sequence diagrams and architecture visuals showing how OSSA agents execute, where OSSA fits in the stack, and how multi-agent systems communicate."
+      },
+      {
+        "id": "gitlab-wiki-sync",
+        "name": "GitLab Wiki Integration Agent",
+        "description": "Fetch all 23+ GitLab Wiki pages via API and integrate into /website/content/docs/. Pull migration guides, OpenAPI extensions, AIFlow integration, contributing, changelog, quick reference.",
+        "agent_type": "integration",
+        "priority": "high",
+        "dependencies": [],
+        "deliverables": [
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/migration-guides/",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/integrations/aiflow.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/contributing.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/changelog.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/quick-reference.md"
+        ],
+        "context": "Use GitLab API: GITLAB_HOST=gitlab.bluefly.io glab api projects/llm%2Fopenstandardagents/wikis to fetch all pages. Convert to website markdown format and organize in proper directory structure."
+      },
+      {
+        "id": "schema-reference",
+        "name": "Schema Reference Documentation Agent",
+        "description": "Create OpenAPI-style schema reference docs with field tables (Field Name | Type | Required | Description) for all OSSA objects: OSSAManifest, Agent, Capabilities, LLM, Tools, Observability, Compliance.",
+        "agent_type": "documentation",
+        "priority": "high",
+        "dependencies": [],
+        "deliverables": [
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/index.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/ossa-manifest.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/agent-object.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/capabilities-object.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/llm-object.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/tools-object.md"
+        ],
+        "context": "Parse /Users/flux423/Sites/LLM/OSSA/schema/ossa-0.2.3.schema.json and generate markdown docs with tables like OpenAPI.org spec. Include YAML examples for each object."
+      },
+      {
+        "id": "use-case-gallery",
+        "name": "Use Case & Examples Agent",
+        "description": "Create real-world use case deep dives with code examples in TypeScript/Python. Cover: Enterprise compliance agent, CI/CD code review agent, customer support agent, research multi-agent system.",
+        "agent_type": "documentation",
+        "priority": "medium",
+        "dependencies": [],
+        "deliverables": [
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/enterprise-compliance.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/cicd-code-review.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/customer-support.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/research-multi-agent.md"
+        ],
+        "context": "Each use case needs: problem statement, OSSA manifest YAML, implementation code in TypeScript/Python, architecture diagram, and deployment instructions."
+      },
+      {
+        "id": "ecosystem-page",
+        "name": "Ecosystem & Integrations Agent",
+        "description": "Create ecosystem page with framework support matrix (LangChain, CrewAI, kAgent, Anthropic MCP), runtime compatibility table, and integration guides.",
+        "agent_type": "documentation",
+        "priority": "medium",
+        "dependencies": ["gitlab-wiki-sync"],
+        "deliverables": [
+          "/Users/flux423/Sites/LLM/OSSA/website/app/ecosystem/page.tsx",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/ecosystem/overview.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/ecosystem/framework-support.md"
+        ],
+        "context": "Create comparison tables showing OSSA support across frameworks. Include status (Supported/Beta/Planned), migration guide links, and example code links."
+      },
+      {
+        "id": "openapi-extensions",
+        "name": "OpenAPI Extensions Page Agent",
+        "description": "Integrate existing /docs/openapi-extensions.md (23KB) into website. Format with tables showing extension fields, types, and descriptions like OpenAPI spec.",
+        "agent_type": "integration",
+        "priority": "high",
+        "dependencies": [],
+        "deliverables": [
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/index.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/root-extensions.md",
+          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/operation-extensions.md"
+        ],
+        "context": "Source file exists at /Users/flux423/Sites/LLM/OSSA/docs/openapi-extensions.md. Convert to website format with proper navigation structure."
+      }
+    ]
+  },
+  "execution": {
+    "mode": "parallel",
+    "max_concurrent": 6,
+    "runtime": "local"
+  }
+}

package/package.json

@@ -0,0 +1,132 @@
+{
+  "name": "@bluefly/openstandardagents",
+  "version": "0.2.4",
+  "description": "OSSA - Open Standard for Scalable AI Agents. A specification standard for AI agents (like OpenAPI for REST APIs). NOT a framework.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ossa": "bin/ossa"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./validation": {
+      "types": "./dist/services/validation.service.d.ts",
+      "import": "./dist/services/validation.service.js",
+      "require": "./dist/services/validation.service.js"
+    },
+    "./generation": {
+      "types": "./dist/services/generation.service.d.ts",
+      "import": "./dist/services/generation.service.js",
+      "require": "./dist/services/generation.service.js"
+    },
+    "./migration": {
+      "types": "./dist/services/migration.service.d.ts",
+      "import": "./dist/services/migration.service.js",
+      "require": "./dist/services/migration.service.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.js"
+    },
+    "./schema": "./spec/v0.2.2/ossa-0.2.2.schema.json",
+    "./openapi-extensions": {
+      "types": "./dist/types/openapi-extensions.d.ts",
+      "import": "./dist/types/openapi-extensions.js",
+      "require": "./dist/types/openapi-extensions.js"
+    },
+    "./openapi-extensions-schema": "./docs/schemas/openapi-extensions.schema.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blueflyio/openstandardagents.git"
+  },
+  "bugs": {
+    "url": "https://github.com/blueflyio/openstandardagents/issues"
+  },
+  "homepage": "https://openstandardagents.org",
+  "scripts": {
+    "build": "tsc && npm run copy-assets",
+    "copy-assets": "cp -r spec dist/ && mkdir -p dist/docs/schemas && cp docs/schemas/*.json dist/docs/schemas/ 2>/dev/null || true",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist coverage",
+    "test": "jest",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration",
+    "test:e2e": "jest tests/e2e",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests --ext .ts",
+    "lint:fix": "eslint src tests --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "validate:schema": "ajv validate -s spec/v0.2.2/ossa-0.2.2.schema.json",
+    "validate:examples": "node -r ts-node/register tests/integration/examples/validate-all-examples.test.ts",
+    "validate:power-suite": "ts-node bin/validate-ossa-0.2.2.ts",
+    "gen:types": "json-schema-to-typescript spec/v0.2.2/ossa-0.2.2.schema.json > src/types/generated/ossa-v0.2.2.types.ts",
+    "gen:zod": "json-schema-to-zod spec/v0.2.2/ossa-0.2.2.schema.json > src/types/generated/ossa-v0.2.2.zod.ts",
+    "gen:all": "npm run gen:types && npm run gen:zod",
+    "cli:legacy": "node cli/bin/ossa --help",
+    "prepublishOnly": "npm run clean && npm run build && npm run test && npm run lint"
+  },
+  "keywords": [
+    "ossa",
+    "ai-agents",
+    "openapi",
+    "standard",
+    "kubernetes",
+    "kagent",
+    "cli",
+    "validation",
+    "agent-generation"
+  ],
+  "author": "OSSA Standards Team",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "ajv": "^8.12.0",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^11.1.0",
+    "glob": "^11.0.3",
+    "inversify": "^7.10.3",
+    "openai": "^6.9.1",
+    "readline": "^1.3.0",
+    "reflect-metadata": "^0.2.2",
+    "yaml": "^2.3.0",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^13.2.9",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.19.19",
+    "@types/pg": "^8.15.5",
+    "@types/redis": "^4.0.10",
+    "@typescript-eslint/eslint-plugin": "^5.62.0",
+    "@typescript-eslint/parser": "^5.62.0",
+    "axios": "^1.12.2",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "json-schema-to-typescript": "^15.0.4",
+    "json-schema-to-zod": "^2.6.1",
+    "prettier": "^3.6.2",
+    "semantic-release": "^25.0.1",
+    "ts-jest": "^29.4.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

package/release.config.js

@@ -0,0 +1,64 @@
+export default {
+  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/spec/v0.1.9/agent-autonomous-extensions.json

@@ -0,0 +1,234 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://open-standards-scalable-agents.org/schemas/v0.1.9/agent-autonomous-extensions.json",
+  "title": "OSSA Autonomous Agent Extensions v0.1.9",
+  "description": "Extensions to OSSA agent schema for autonomous agent capabilities",
+  "type": "object",
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "enum": ["open-standards-scalable-agents/v0.1.9"],
+      "description": "OSSA API version"
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["Agent"],
+      "description": "Resource type"
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
+          "description": "Agent name (kebab-case)"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+          "description": "Semantic version"
+        },
+        "description": {
+          "type": "string",
+          "description": "Agent description"
+        }
+      }
+    },
+    "spec": {
+      "type": "object",
+      "required": ["type", "capabilities"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["worker", "orchestrator", "critic", "integrator"],
+          "description": "Agent type"
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Agent capabilities"
+        },
+        "autonomous": {
+          "type": "boolean",
+          "description": "Enable autonomous operation",
+          "default": false
+        },
+        "auto_claim_issues": {
+          "type": "boolean",
+          "description": "Automatically claim unclaimed issues",
+          "default": false
+        },
+        "max_concurrent_tasks": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Maximum concurrent tasks"
+        },
+        "gitlab": {
+          "type": "object",
+          "properties": {
+            "project_id": {
+              "type": "string",
+              "description": "GitLab project ID or path"
+            },
+            "epic_id": {
+              "type": "integer",
+              "description": "GitLab epic ID for task grouping"
+            },
+            "milestone_id": {
+              "type": "integer",
+              "description": "GitLab milestone ID"
+            },
+            "labels": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Labels to filter issues"
+            }
+          },
+          "required": ["project_id"]
+        },
+        "thinking_stages": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "PROBLEM_DEFINITION",
+              "RESEARCH",
+              "ANALYSIS",
+              "SYNTHESIS",
+              "IMPLEMENTATION",
+              "VALIDATION",
+              "REFLECTION",
+              "CONCLUSION"
+            ]
+          },
+          "description": "Sequential thinking stages"
+        },
+        "task": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Task title"
+            },
+            "description": {
+              "type": "string",
+              "description": "Task description"
+            },
+            "files": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Files to work on"
+            },
+            "dependencies": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Package dependencies"
+            },
+            "success_criteria": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Success criteria"
+            },
+            "estimated_effort": {
+              "type": "string",
+              "description": "Estimated effort"
+            },
+            "priority": {
+              "type": "string",
+              "enum": ["P0", "P1", "P2", "P3"],
+              "description": "Task priority"
+            }
+          }
+        },
+        "coordination": {
+          "type": "object",
+          "description": "Orchestrator coordination settings",
+          "properties": {
+            "worker_agents": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Worker agent names to coordinate"
+            },
+            "workflow": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "phases": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      },
+                      "parallel": {
+                        "type": "boolean"
+                      },
+                      "depends_on": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "tasks": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "agent": {
+                              "type": "string"
+                            },
+                            "task": {
+                              "type": "string"
+                            },
+                            "blocking": {
+                              "type": "boolean"
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "success_criteria": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "timeline": {
+                  "type": "object",
+                  "properties": {
+                    "start": {
+                      "type": "string"
+                    },
+                    "target_completion": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "required": ["apiVersion", "kind", "metadata", "spec"]
+}