@bluefly/openstandardagents 0.2.4 → 0.2.7

package/openapi/reference-implementations/workflow-orchestrator-api.openapi.yaml

@@ -0,0 +1,193 @@
+openapi: 3.1.0
+info:
+  title: Workflow Orchestration Agent API
+  version: 2.0.0
+  description: |
+    Advanced workflow orchestration agent that coordinates multi-step processes,
+    manages agent swarms, and provides intelligent task routing.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: workflow-orchestrator
+    type: orchestrator
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://workflow-orchestrator.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: workflows
+    description: Workflow execution operations
+  - name: coordination
+    description: Agent coordination operations
+
+paths:
+  /workflows/execute:
+    post:
+      summary: Execute workflow
+      description: Execute multi-step workflow with agent coordination
+      operationId: executeWorkflow
+      tags: [workflows]
+      x-ossa-capability: execute_workflow
+      x-ossa-autonomy:
+        level: semi-autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [workflow_definition]
+              properties:
+                workflow_definition:
+                  type: object
+                  required: [name, steps]
+                  properties:
+                    name:
+                      type: string
+                    steps:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          step_id:
+                            type: string
+                          agent_id:
+                            type: string
+                          capability:
+                            type: string
+                          input:
+                            type: object
+                          dependencies:
+                            type: array
+                            items:
+                              type: string
+                options:
+                  type: object
+                  properties:
+                    parallel:
+                      type: boolean
+                      default: false
+                    retry:
+                      type: object
+      responses:
+        '202':
+          description: Workflow execution started
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  workflow_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [pending, running, completed, failed]
+
+  /workflows/{workflow_id}:
+    get:
+      summary: Get workflow status
+      description: Retrieve workflow execution status and results
+      operationId: getWorkflowStatus
+      tags: [workflows]
+      x-ossa-capability: execute_workflow
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Workflow status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  workflow_id:
+                    type: string
+                  status:
+                    type: string
+                  steps:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        step_id:
+                          type: string
+                        status:
+                          type: string
+                        result:
+                          type: object
+                  result:
+                    type: object
+
+  /coordinate/swarm:
+    post:
+      summary: Coordinate agent swarm
+      description: Coordinate multiple agents for parallel task execution
+      operationId: coordinateSwarm
+      tags: [coordination]
+      x-ossa-capability: coordinate_agents
+      x-ossa-autonomy:
+        level: semi-autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [agents, task]
+              properties:
+                agents:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      agent_id:
+                        type: string
+                      capability:
+                        type: string
+                task:
+                  type: object
+                strategy:
+                  type: string
+                  enum: [parallel, sequential, priority]
+      responses:
+        '200':
+          description: Swarm coordination initiated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  coordination_id:
+                    type: string
+                  agents:
+                    type: array
+                    items:
+                      type: object
+                  status:
+                    type: string
+

package/package.json

@@ -1,14 +1,8 @@
 {
   "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"
-  },
+  "version": "0.2.7",
   "exports": {
+    "./schema": "./spec/v0.2.6/ossa-0.2.6.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -34,13 +28,20 @@
       "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"
+    }
+  },
+  "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",
+    "ossa-version": "bin/ossa-version",
+    "ossa-validate-all": "bin/ossa-validate-all"
   },
   "publishConfig": {
     "access": "public",
@@ -48,15 +49,21 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/blueflyio/openstandardagents.git"
+    "url": "https://github.com/blueflyio/openstandardagents/"
   },
   "bugs": {
     "url": "https://github.com/blueflyio/openstandardagents/issues"
   },
   "homepage": "https://openstandardagents.org",
   "scripts": {
+    "version:sync": "node scripts/sync-version.js",
+    "version:bump": "tsx scripts/bump-version.ts",
+    "version:enhanced": "tsx scripts/enhanced-version-manager.ts",
+    "version:check": "tsx scripts/sync-versions.ts --check",
+    "docs:process": "tsx scripts/process-doc-templates.ts",
+    "prebuild": "npm run version:sync && npm run docs:process",
     "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",
+    "copy-assets": "cp -r spec dist/",
     "dev": "tsc --watch",
     "clean": "rm -rf dist coverage",
     "test": "jest",
@@ -70,14 +77,32 @@
     "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:schema": "tsx scripts/validate-schema.ts",
+    "docs:api:generate": "tsx scripts/generate-api-docs.ts",
+    "docs:cli:generate": "tsx scripts/generate-cli-docs.ts",
+    "docs:schema:generate": "tsx scripts/generate-schema-docs.ts",
+    "docs:examples:generate": "tsx scripts/generate-examples-docs.ts",
+    "docs:agents:generate": "tsx scripts/generate-agents-catalog.ts",
+    "docs:types:generate": "tsx scripts/generate-types-docs.ts",
+    "docs:errors:generate": "tsx scripts/generate-errors-docs.ts",
+    "docs:config:generate": "tsx scripts/generate-config-docs.ts",
+    "docs:lowercase": "tsx scripts/lowercase-docs.ts",
+    "docs:generate": "npm run docs:api:generate && npm run docs:cli:generate && npm run docs:schema:generate && npm run docs:examples:generate && npm run docs:agents:generate && npm run docs:types:generate && npm run docs:errors:generate && npm run docs:config:generate && npm run docs:lowercase",
+    "docs:validate": "echo 'Documentation validation not yet implemented'",
+    "docs:lint": "echo 'Documentation linting not yet implemented'",
     "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",
+    "validate:power-suite": "tsx bin/validate-ossa.ts",
+    "gen:types": "tsx scripts/gen-types.ts",
+    "gen:zod": "tsx scripts/gen-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"
+    "prepublishOnly": "npm run clean && npm run build && npm run test && npm run lint",
+    "validate:all": "node scripts/validate-all.js",
+    "fix:schemas": "node scripts/fix-schema-formats.js",
+    "prepare": "husky install || true",
+    "sync:pr": "tsx src/cli/commands/github-sync.command.ts pr",
+    "sync:batch": "tsx src/cli/commands/github-sync.command.ts batch",
+    "sync:list": "tsx src/cli/commands/github-sync.command.ts list"
   },
   "keywords": [
     "ossa",
@@ -93,12 +118,16 @@
   "author": "OSSA Standards Team",
   "license": "Apache-2.0",
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.0",
+    "@gitbeaker/node": "^35.8.1",
+    "@octokit/rest": "^20.0.0",
     "ajv": "^8.12.0",
     "ajv-formats": "^3.0.1",
+    "axios": "^1.12.2",
     "chalk": "^5.6.2",
     "commander": "^11.1.0",
     "glob": "^11.0.3",
-    "inversify": "^7.10.3",
+    "inversify": "^7.10.4",
     "openai": "^6.9.1",
     "readline": "^1.3.0",
     "reflect-metadata": "^0.2.2",
@@ -106,7 +135,9 @@
     "zod": "^4.1.11"
   },
   "devDependencies": {
+    "@gitbeaker/rest": "^43.8.0",
     "@jest/globals": "^29.7.0",
+    "@octokit/rest": "^22.0.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/gitlab": "^13.2.9",
@@ -114,9 +145,8 @@
     "@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",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@typescript-eslint/parser": "^8.48.0",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -127,6 +157,7 @@
     "semantic-release": "^25.0.1",
     "ts-jest": "^29.4.4",
     "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
     "typescript": "^5.9.3"
   }
 }

package/release.config.js

@@ -1,9 +1,16 @@
 export default {
   branches: [
-    'main',
-    { name: 'development', prerelease: 'dev', channel: 'development' },
+    {
+      name: 'main',
+      channel: false, // Stable releases get 'latest' tag
+    },
+    {
+      name: 'development',
+      prerelease: 'dev',
+      channel: 'dev', // Dev releases get 'dev' tag
+    },
   ],
-  repositoryUrl: 'https://gitlab.bluefly.io/llm/openapi-ai-agents-standard.git',
+  repositoryUrl: 'https://github.com/blueflyio/openstandardagents.git',
   plugins: [
     [
       '@semantic-release/commit-analyzer',
@@ -14,6 +21,9 @@ export default {
           { type: 'refactor', scope: 'core-*', release: 'minor' },
           { type: 'refactor', release: 'patch' },
           { type: 'chore', scope: 'deps', release: 'patch' },
+          // Version is determined automatically by commit analysis
+          // Milestones are used for planning and tracking, but version bump
+          // is controlled by commit messages (feat → minor, fix → patch, BREAKING → major)
         ],
         parserOpts: {
           noteKeywords: ['BREAKING CHANGE', 'BREAKING CHANGES'],
@@ -38,12 +48,17 @@ export default {
     ],
     [
       '@semantic-release/npm',
-      { npmPublish: false, tarballDir: 'dist' },
+      { 
+        npmPublish: true,
+        tarballDir: 'dist',
+        // Tag stable releases as 'latest', dev releases as 'dev'
+        // This is handled by branch configuration below
+      },
     ],
     [
       '@semantic-release/gitlab',
       {
-        gitlabUrl: 'https://gitlab.bluefly.io',
+        gitlabUrl: 'https://gitlab.com',
         assets: [
           { path: 'dist/*.tgz', label: 'OSSA npm package (${nextRelease.gitTag})' },
           {

package/scripts/README.md

@@ -0,0 +1,103 @@
+# Validation Scripts
+
+Automated validation and maintenance scripts for OSSA.
+
+## Scripts
+
+### validate-all.js
+
+Comprehensive validation suite:
+- Version consistency across packages
+- Schema exports and files
+- Spec directory structure
+- Schema validation
+- Version reference checks
+
+```bash
+npm run validate:all
+```
+
+### fix-schema-formats.js
+
+Automatically fixes unsupported format constraints in JSON schemas.
+
+```bash
+npm run fix:schemas
+```
+
+Removes format constraints like `"format": "uri"` that aren't supported by ajv-cli.
+
+### sync-version.js (website)
+
+Syncs version from package.json to website code.
+
+```bash
+cd website && npm run sync-version
+```
+
+## CI/CD Integration
+
+Validation runs automatically on:
+- Merge requests
+- Commits to main/development
+
+See `.gitlab-ci-validation.yml` for configuration.
+
+## Pre-commit Hook
+
+Install husky to run validations before commit:
+
+```bash
+npm install
+npm run prepare
+```
+
+## Maintenance
+
+### Adding New Validations
+
+Edit `scripts/validate-all.js`:
+
+```javascript
+check('New Check', () => {
+  // Your validation logic
+  if (somethingWrong) {
+    throw new Error('Description');
+  }
+  console.log('✓ Check passed');
+});
+```
+
+### Adding Unsupported Formats
+
+Edit `scripts/fix-schema-formats.js`:
+
+```javascript
+const UNSUPPORTED_FORMATS = ['uri', 'new-format'];
+```
+
+## Troubleshooting
+
+### Schema validation fails
+
+```bash
+npm run fix:schemas
+npm run validate:schema
+```
+
+### Version mismatch
+
+```bash
+# Update root version
+npm version patch
+
+# Sync to website
+cd website && npm run sync-version
+```
+
+### Pre-commit hook not running
+
+```bash
+npm run prepare
+chmod +x .husky/pre-commit
+```

package/scripts/auto-rebase-mrs.ts

@@ -0,0 +1,106 @@
+#!/usr/bin/env tsx
+/**
+ * Auto-rebase all open MRs onto their target branches
+ * Runs in CI or manually to keep MRs up to date
+ */
+
+import { Gitlab } from '@gitbeaker/rest';
+import { execSync } from 'child_process';
+
+const PROJECT_ID = 'blueflyio/openstandardagents';
+const TOKEN = process.env.GITLAB_TOKEN || process.env.SERVICE_ACCOUNT_OSSA_TOKEN || process.env.GITLAB_PUSH_TOKEN;
+
+if (!TOKEN) {
+  console.error('❌ Error: GITLAB_TOKEN or SERVICE_ACCOUNT_OSSA_TOKEN required');
+  process.exit(1);
+}
+
+const gitlab = new Gitlab({
+  host: 'https://gitlab.com',
+  token: TOKEN,
+});
+
+async function rebaseMR(mr: any): Promise<boolean> {
+  const { iid, source_branch, target_branch, merge_status } = mr;
+  
+  console.log(`\n🔄 Rebasing MR !${iid}: ${source_branch} -> ${target_branch}`);
+  
+  try {
+    // Fetch branches
+    execSync(`git fetch origin ${source_branch} ${target_branch}`, { stdio: 'inherit' });
+    
+    // Check if behind
+    const behind = execSync(
+      `git rev-list --count origin/${target_branch}..origin/${source_branch} 2>/dev/null || echo 0`
+    ).toString().trim();
+    
+    if (behind === '0') {
+      console.log(`  ✅ Already up to date`);
+      return true;
+    }
+    
+    console.log(`  ⚠️  ${behind} commits behind, rebasing...`);
+    
+    // Create worktree
+    const worktreePath = `../rebase-${iid}-${source_branch.replace(/\//g, '-')}`;
+    try {
+      execSync(`git worktree remove ${worktreePath}`, { stdio: 'ignore' });
+    } catch {}
+    
+    execSync(`git worktree add ${worktreePath} origin/${source_branch}`, { stdio: 'inherit' });
+    
+    // Rebase
+    try {
+      execSync(`cd ${worktreePath} && git rebase origin/${target_branch}`, { stdio: 'inherit' });
+      
+      // Push
+      execSync(`cd ${worktreePath} && git push origin ${source_branch} --force-with-lease`, { stdio: 'inherit' });
+      
+      console.log(`  ✅ Rebased and pushed successfully`);
+      
+      // Cleanup
+      execSync(`git worktree remove ${worktreePath}`, { stdio: 'ignore' });
+      
+      return true;
+    } catch (error) {
+      console.error(`  ❌ Rebase failed - conflicts may exist`);
+      console.error(`  Worktree: ${worktreePath}`);
+      return false;
+    }
+  } catch (error: any) {
+    console.error(`  ❌ Error: ${error.message}`);
+    return false;
+  }
+}
+
+async function main() {
+  console.log('🔄 Auto-rebasing all open MRs\n');
+  
+  try {
+    const mrs = await gitlab.MergeRequests.all({
+      projectId: PROJECT_ID,
+      state: 'opened',
+      perPage: 20,
+    });
+    
+    console.log(`Found ${mrs.length} open MRs\n`);
+    
+    const results = await Promise.all(mrs.map(rebaseMR));
+    
+    const success = results.filter(Boolean).length;
+    const failed = results.length - success;
+    
+    console.log(`\n✅ Summary:`);
+    console.log(`  Successfully rebased: ${success}`);
+    console.log(`  Failed: ${failed}`);
+    
+    if (failed > 0) {
+      process.exit(1);
+    }
+  } catch (error: any) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/scripts/batch-dependabot.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+set -e
+
+# Batch merge Dependabot PRs from GitHub
+# Creates a single GitLab MR with all updates
+
+REPO="blueflyio/openstandardagents"
+BRANCH="batch-dependabot-$(date +%Y%m%d)"
+
+echo "🤖 Batching Dependabot PRs..."
+
+# Get all open Dependabot PRs
+DEPENDABOT_PRS=$(gh pr list --repo $REPO --author app/dependabot --state open --json number -q '.[].number')
+
+if [ -z "$DEPENDABOT_PRS" ]; then
+  echo "No Dependabot PRs found"
+  exit 0
+fi
+
+echo "Found PRs: $DEPENDABOT_PRS"
+
+# Create new branch
+git checkout -b $BRANCH main
+
+# Merge each PR
+for PR in $DEPENDABOT_PRS; do
+  echo "Merging PR #$PR..."
+  gh pr checkout $PR
+  git merge --no-ff --no-edit FETCH_HEAD || {
+    echo "⚠️  Conflict in PR #$PR, skipping"
+    git merge --abort
+    continue
+  }
+done
+
+# Push to GitLab
+git push origin $BRANCH
+
+# Create GitLab MR
+glab mr create \
+  --title "chore(deps): batch Dependabot updates $(date +%Y-%m-%d)" \
+  --description "Batched Dependabot PRs from GitHub:
+
+$(echo "$DEPENDABOT_PRS" | while read pr; do
+  echo "- https://github.com/$REPO/pull/$pr"
+done)
+
+**Changes:**
+- Dependency updates from Dependabot
+- Tested in CI before merge
+
+**GitHub PRs will auto-close** when this merges and syncs back." \
+  --source-branch $BRANCH \
+  --target-branch main \
+  --label "dependencies"
+
+echo "✅ Created GitLab MR with batched updates"