@bluefly/openstandardagents 0.2.5-RC → 0.2.7

package/examples/openai/swarm-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.4",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",
@@ -17,12 +17,26 @@
       {
         "type": "function",
         "name": "search_web",
-        "capabilities": ["search", "retrieve"]
+        "capabilities": [
+          {
+            "name": "search"
+          },
+          {
+            "name": "retrieve"
+          }
+        ]
       },
       {
         "type": "function",
         "name": "execute_code",
-        "capabilities": ["run", "evaluate"]
+        "capabilities": [
+          {
+            "name": "run"
+          },
+          {
+            "name": "evaluate"
+          }
+        ]
       }
     ]
   },
@@ -55,5 +69,4 @@
       }
     }
   }
-}
-
+}

package/examples/vercel/edge-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.4",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",
@@ -33,11 +33,12 @@
                 "description": "City name"
               }
             },
-            "required": ["location"]
+            "required": [
+              "location"
+            ]
           }
         }
       ]
     }
   }
-}
-
+}

package/openapi/github-sync.yaml

@@ -0,0 +1,115 @@
+openapi: 3.1.0
+info:
+  title: GitHub Sync API
+  version: 1.0.0
+  description: API for syncing GitHub PRs to GitLab
+
+servers:
+  - url: http://localhost:3000
+    description: Development
+
+paths:
+  /sync/pr/{number}:
+    post:
+      summary: Sync GitHub PR to GitLab
+      operationId: syncPR
+      tags: [Sync]
+      parameters:
+        - name: number
+          in: path
+          required: true
+          schema:
+            type: integer
+      responses:
+        '200':
+          description: MR created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GitLabMR'
+
+  /sync/batch:
+    post:
+      summary: Batch sync PRs
+      operationId: batchSync
+      tags: [Sync]
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                author:
+                  type: string
+                  example: app/dependabot
+      responses:
+        '200':
+          description: Batch MR created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GitLabMR'
+
+  /sync/list:
+    get:
+      summary: List syncable PRs
+      operationId: listPRs
+      tags: [Sync]
+      parameters:
+        - name: author
+          in: query
+          schema:
+            type: string
+      responses:
+        '200':
+          description: List of PRs
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/GitHubPR'
+
+components:
+  schemas:
+    GitHubPR:
+      type: object
+      required: [number, title, author, state]
+      properties:
+        number:
+          type: integer
+        title:
+          type: string
+        body:
+          type: string
+          nullable: true
+        author:
+          type: object
+          properties:
+            login:
+              type: string
+        state:
+          type: string
+          enum: [open, closed]
+
+    GitLabMR:
+      type: object
+      required: [iid, title, source_branch, target_branch, state, web_url]
+      properties:
+        iid:
+          type: integer
+        title:
+          type: string
+        description:
+          type: string
+          nullable: true
+        source_branch:
+          type: string
+        target_branch:
+          type: string
+        state:
+          type: string
+          enum: [opened, closed, merged]
+        web_url:
+          type: string
+          format: uri

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.2.5-RC",
+  "version": "0.2.7",
   "exports": {
-    "./schema": "./spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json",
+    "./schema": "./spec/v0.2.6/ossa-0.2.6.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -56,7 +56,7 @@
   },
   "homepage": "https://openstandardagents.org",
   "scripts": {
-    "version:sync": "tsx scripts/sync-versions.ts",
+    "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",
@@ -78,13 +78,31 @@
     "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
     "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": "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",
@@ -100,6 +118,9 @@
   "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",

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"

package/scripts/configure-gitlab-branch-protection.ts

@@ -0,0 +1,95 @@
+#!/usr/bin/env tsx
+/**
+ * Configure GitLab Branch Protection Rules
+ * Sets up protection for main and development branches via GitLab API
+ */
+
+import { Gitlab } from '@gitbeaker/rest';
+
+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,
+});
+
+interface ProtectionRule {
+  name: string;
+  push_access_levels?: Array<{ access_level: number }>;
+  merge_access_levels?: Array<{ access_level: number }>;
+  allow_force_push?: boolean;
+  allowed_to_push?: Array<{ user_id?: number; group_id?: number }>;
+  allowed_to_merge?: Array<{ user_id?: number; group_id?: number }>;
+}
+
+async function protectBranch(branch: string, rules: ProtectionRule): Promise<void> {
+  try {
+    console.log(`\n🔒 Protecting branch: ${branch}`);
+    
+    // Check if branch is already protected
+    const existing = await gitlab.ProtectedBranches.all(PROJECT_ID);
+    const isProtected = existing.some((pb: any) => pb.name === branch);
+    
+    if (isProtected) {
+      console.log(`  ⚠️  ${branch} is already protected. Updating...`);
+      await gitlab.ProtectedBranches.unprotect(PROJECT_ID, branch);
+    }
+    
+    // Protect the branch
+    await gitlab.ProtectedBranches.protect(PROJECT_ID, branch, {
+      push_access_levels: [{ access_level: 0 }], // No one can push
+      merge_access_levels: [{ access_level: 40 }], // Maintainers can merge
+      allow_force_push: false,
+    });
+    
+    console.log(`  ✅ ${branch} protected successfully`);
+    console.log(`     - Push: Blocked (no direct pushes)`);
+    console.log(`     - Merge: Maintainers only (via MR)`);
+    console.log(`     - Force push: Disabled`);
+  } catch (error: any) {
+    console.error(`  ❌ Failed to protect ${branch}:`, error.message);
+    throw error;
+  }
+}
+
+async function main() {
+  console.log('🔒 Configuring GitLab Branch Protection Rules\n');
+  console.log(`Project: ${PROJECT_ID}`);
+  console.log(`Token: ${TOKEN.substring(0, 10)}...`);
+  
+  try {
+    // Protect main branch
+    await protectBranch('main', {
+      name: 'main',
+      push_access_levels: [{ access_level: 0 }], // No one
+      merge_access_levels: [{ access_level: 40 }], // Maintainers
+      allow_force_push: false,
+    });
+    
+    // Protect development branch
+    await protectBranch('development', {
+      name: 'development',
+      push_access_levels: [{ access_level: 0 }], // No one
+      merge_access_levels: [{ access_level: 40 }], // Maintainers
+      allow_force_push: false,
+    });
+    
+    console.log('\n✅ Branch protection configured successfully!');
+    console.log('\nProtected branches:');
+    console.log('  - main: No direct pushes, MR required');
+    console.log('  - development: No direct pushes, MR required');
+    console.log('\nView in GitLab:');
+    console.log(`  https://gitlab.com/${PROJECT_ID}/-/settings/repository#protected-branches`);
+  } catch (error: any) {
+    console.error('\n❌ Error configuring branch protection:', error.message);
+    process.exit(1);
+  }
+}
+
+main();