@bluefly/openstandardagents 0.2.8 → 0.3.0

package/examples/agents/spec-healer-openapi.yaml

@@ -0,0 +1,59 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: spec-healer-openapi
+  description: OpenAPI specification healer and validator
+spec:
+  model:
+    provider: anthropic
+    name: claude-3-5-sonnet-20241022
+  
+  tools:
+    - name: validate_openapi
+      description: Validate OpenAPI spec against standards
+      action: |
+        openapi-validator spec/openapi.yaml --errors-only
+    
+    - name: detect_breaking_changes
+      description: Compare specs and detect breaking changes
+      action: |
+        oasdiff breaking spec/v1.yaml spec/v2.yaml
+    
+    - name: generate_examples
+      description: Auto-generate request/response examples
+      action: |
+        openapi-examples-generator spec/openapi.yaml
+    
+    - name: sync_with_code
+      description: Ensure spec matches implementation
+      action: |
+        # Extract routes from code
+        # Compare with spec paths
+        # Flag mismatches
+        spectral lint spec/openapi.yaml --ruleset .spectral.yaml
+  
+  healing_rules:
+    - name: fix-missing-examples
+      condition: schema_without_examples
+      actions:
+        - generate_realistic_examples
+        - add_to_spec
+    
+    - name: fix-inconsistent-naming
+      condition: inconsistent_parameter_names
+      actions:
+        - standardize_to_camelCase
+        - update_all_references
+    
+    - name: add-missing-descriptions
+      condition: endpoint_without_description
+      actions:
+        - infer_from_code_comments
+        - generate_description
+    
+    - name: fix-security-definitions
+      condition: missing_security_schemes
+      actions:
+        - add_oauth2_flow
+        - add_api_key_header
+        - document_scopes

package/examples/agents/wiki-healer-production.yaml

@@ -0,0 +1,131 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: wiki-healer-production
+  description: Production wiki healer with comprehensive checks
+  labels:
+    tier: healer
+    domain: documentation
+spec:
+  model:
+    provider: anthropic
+    name: claude-3-5-sonnet-20241022
+  
+  capabilities:
+    - file_operations
+    - git_operations
+    - markdown_parsing
+    - link_validation
+    - content_analysis
+  
+  tools:
+    - name: check_broken_links
+      description: Scan wiki for broken internal/external links
+      action: |
+        find docs/ -name "*.md" -exec grep -H "](http" {} \; | \
+        while read line; do
+          url=$(echo "$line" | grep -oP '(?<=\()http[^)]+')
+          curl -s -o /dev/null -w "%{http_code}" "$url"
+        done
+    
+    - name: validate_frontmatter
+      description: Ensure all wiki pages have valid frontmatter
+      action: |
+        for file in docs/**/*.md; do
+          if ! head -n 5 "$file" | grep -q "^---$"; then
+            echo "Missing frontmatter: $file"
+          fi
+        done
+    
+    - name: check_orphaned_pages
+      description: Find pages not linked from anywhere
+      action: |
+        all_pages=$(find docs/ -name "*.md")
+        for page in $all_pages; do
+          basename=$(basename "$page")
+          if ! grep -r "$basename" docs/ --exclude="$page" > /dev/null; then
+            echo "Orphaned: $page"
+          fi
+        done
+    
+    - name: fix_markdown_formatting
+      description: Auto-fix common markdown issues
+      action: |
+        # Fix heading hierarchy
+        # Fix list indentation
+        # Fix code block fences
+        # Fix table formatting
+        prettier --write "docs/**/*.md"
+    
+    - name: update_table_of_contents
+      description: Regenerate TOC for changed pages
+      action: |
+        for file in $(git diff --name-only HEAD~1 docs/**/*.md); do
+          markdown-toc -i "$file"
+        done
+    
+    - name: check_image_references
+      description: Validate all image references exist
+      action: |
+        grep -r "!\[.*\](" docs/ | while read line; do
+          img=$(echo "$line" | grep -oP '(?<=\().*?(?=\))')
+          if [[ ! -f "docs/$img" ]]; then
+            echo "Missing image: $img in $line"
+          fi
+        done
+  
+  triggers:
+    - event: wiki.page.created
+      action: validate_and_enhance
+    - event: wiki.page.updated
+      action: check_and_fix
+    - event: schedule.daily
+      action: comprehensive_audit
+  
+  healing_rules:
+    - name: fix-broken-links
+      condition: broken_links_detected
+      actions:
+        - update_links_to_latest
+        - create_redirects
+        - notify_page_owners
+    
+    - name: fix-orphaned-pages
+      condition: orphaned_pages_found
+      actions:
+        - add_to_index
+        - suggest_parent_pages
+        - create_category_links
+    
+    - name: fix-formatting
+      condition: markdown_errors_detected
+      actions:
+        - auto_format
+        - fix_heading_hierarchy
+        - standardize_code_blocks
+    
+    - name: update-stale-content
+      condition: page_not_updated_90_days
+      actions:
+        - flag_for_review
+        - notify_maintainers
+        - add_stale_warning
+  
+  observability:
+    metrics:
+      - name: pages_healed
+        type: counter
+      - name: broken_links_fixed
+        type: counter
+      - name: orphaned_pages_linked
+        type: counter
+      - name: healing_duration_ms
+        type: histogram
+    
+    activity_stream:
+      enabled: true
+      track:
+        - healing.started
+        - healing.completed
+        - issue.detected
+        - issue.fixed

package/examples/agents-md/code-agent.ossa.json

@@ -0,0 +1,100 @@
+{
+  "apiVersion": "ossa/v0.3.0",
+  "kind": "Agent",
+  "metadata": {
+    "name": "code-assistant",
+    "version": "1.0.0",
+    "description": "AI coding agent with agents.md repository guidance",
+    "labels": {
+      "domain": "development",
+      "framework": "agents-md"
+    }
+  },
+  "spec": {
+    "role": "You are an expert software developer. Follow the project's coding standards and conventions. Write clean, maintainable code with proper tests.",
+    "llm": {
+      "provider": "openai",
+      "model": "gpt-4o",
+      "temperature": 0.2
+    },
+    "tools": [
+      {
+        "type": "mcp",
+        "name": "filesystem",
+        "server": "filesystem",
+        "capabilities": [
+          { "name": "read_file" },
+          { "name": "write_file" },
+          { "name": "list_directory" }
+        ]
+      },
+      {
+        "type": "mcp",
+        "name": "git",
+        "server": "git",
+        "capabilities": [
+          { "name": "status" },
+          { "name": "diff" },
+          { "name": "commit" }
+        ]
+      }
+    ],
+    "constraints": {
+      "performance": {
+        "maxLatencySeconds": 30,
+        "timeoutSeconds": 120
+      }
+    },
+    "autonomy": {
+      "level": "supervised",
+      "approval_required": true,
+      "allowed_actions": ["read", "write", "test"],
+      "blocked_actions": ["deploy", "delete"]
+    }
+  },
+  "extensions": {
+    "agents_md": {
+      "enabled": true,
+      "generate": true,
+      "output_path": "AGENTS.md",
+      "sections": {
+        "dev_environment": {
+          "enabled": true,
+          "source": "spec.tools",
+          "append": "- Use `pnpm` for package management\n- Run `pnpm dev` to start development server"
+        },
+        "testing": {
+          "enabled": true,
+          "custom": "Run `pnpm test` before committing.\nEnsure all tests pass and coverage is maintained.\nUse Jest for unit tests and Playwright for E2E."
+        },
+        "pr_instructions": {
+          "enabled": true,
+          "source": "spec.autonomy",
+          "custom": "- Use conventional commits format\n- Include tests for new features\n- Update documentation as needed\n- Request review from at least one team member"
+        },
+        "code_style": {
+          "enabled": true,
+          "custom": "- TypeScript strict mode enabled\n- ESLint + Prettier for formatting\n- Prefer functional programming patterns\n- Use descriptive variable names"
+        }
+      },
+      "sync": {
+        "on_manifest_change": true,
+        "include_comments": true
+      },
+      "mapping": {
+        "tools_to_dev_environment": true,
+        "constraints_to_testing": true,
+        "autonomy_to_pr_instructions": true
+      },
+      "cursor_integration": true
+    },
+    "cursor": {
+      "enabled": true,
+      "agent_type": "composer",
+      "workspace_config": {
+        "context_files": ["src/**/*.ts", "tests/**/*.ts"],
+        "ignore_patterns": ["node_modules/**", "dist/**"]
+      }
+    }
+  }
+}

package/examples/agents-md/monorepo-agent.ossa.yaml

@@ -0,0 +1,180 @@
+# OSSA Agent Manifest with agents.md Extension
+# Demonstrates monorepo support with nested AGENTS.md files
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: monorepo-assistant
+  version: 1.0.0
+  description: Multi-package monorepo coding agent with nested agents.md support
+  labels:
+    domain: development
+    framework: agents-md
+    architecture: monorepo
+
+spec:
+  role: |
+    You are an expert developer working on a monorepo containing multiple packages.
+    Each package has its own conventions and testing requirements.
+    Always check the local AGENTS.md file in the current directory for package-specific guidance.
+
+  llm:
+    provider: anthropic
+    model: claude-3-5-sonnet-20241022
+    temperature: 0.1
+
+  tools:
+    - type: mcp
+      name: filesystem
+      server: filesystem
+      capabilities:
+        - name: read_file
+        - name: write_file
+        - name: search_files
+    - type: mcp
+      name: git
+      server: git
+      capabilities:
+        - name: status
+        - name: diff
+        - name: log
+    - type: http
+      name: npm-registry
+      endpoint: https://registry.npmjs.org
+      capabilities:
+        - name: search_packages
+
+  constraints:
+    cost:
+      maxTokensPerDay: 100000
+      maxTokensPerRequest: 8000
+    performance:
+      maxLatencySeconds: 60
+      timeoutSeconds: 180
+
+  autonomy:
+    level: autonomous
+    approval_required: false
+    allowed_actions:
+      - read
+      - write
+      - test
+      - lint
+      - format
+    blocked_actions:
+      - publish
+      - deploy
+      - delete_branch
+
+extensions:
+  agents_md:
+    enabled: true
+    generate: true
+    output_path: AGENTS.md
+
+    sections:
+      dev_environment:
+        enabled: true
+        title: "Development Environment"
+        custom: |
+          - This is a pnpm workspace monorepo
+          - Run `pnpm install` from root to install all dependencies
+          - Use `pnpm -F <package>` to run commands in specific packages
+          - Turborepo is used for task orchestration
+
+      testing:
+        enabled: true
+        title: "Testing Requirements"
+        custom: |
+          - Run `pnpm test` to execute all tests
+          - Run `pnpm -F <package> test` for package-specific tests
+          - Coverage threshold is 80% for all packages
+          - E2E tests are in `apps/web/e2e/`
+
+      pr_instructions:
+        enabled: true
+        title: "Pull Request Guidelines"
+        custom: |
+          - Use conventional commits: `feat:`, `fix:`, `chore:`, etc.
+          - PRs must pass CI checks before merge
+          - Changesets are required for publishable packages
+          - Run `pnpm changeset` to create a changeset
+
+      code_style:
+        enabled: true
+        custom: |
+          - TypeScript strict mode in all packages
+          - Biome for linting and formatting
+          - Run `pnpm lint` and `pnpm format` before committing
+
+      custom:
+        - title: "Package Structure"
+          content: |
+            - `apps/` - Application packages (web, api, cli)
+            - `packages/` - Shared library packages
+            - `tooling/` - Build and development tools
+
+    sync:
+      on_manifest_change: true
+      include_comments: true
+      watch: false
+
+    mapping:
+      tools_to_dev_environment: true
+      constraints_to_testing: true
+      autonomy_to_pr_instructions: true
+
+    # Nested AGENTS.md files for each package
+    nested_files:
+      - path: apps/web
+        inherit: true
+        sections:
+          dev_environment:
+            custom: |
+              - Next.js 14 application
+              - Run `pnpm -F web dev` to start dev server
+              - Uses App Router and Server Components
+          testing:
+            custom: |
+              - Playwright for E2E tests
+              - React Testing Library for component tests
+              - Run `pnpm -F web test:e2e` for E2E
+
+      - path: apps/api
+        inherit: true
+        sections:
+          dev_environment:
+            custom: |
+              - Hono API server
+              - Run `pnpm -F api dev` to start
+              - OpenAPI spec in `openapi.yaml`
+          testing:
+            custom: |
+              - Vitest for unit tests
+              - Integration tests require Docker
+              - Run `docker-compose up -d` first
+
+      - path: packages/ui
+        inherit: true
+        sections:
+          dev_environment:
+            custom: |
+              - Shared React component library
+              - Run `pnpm -F ui storybook` for component preview
+              - Uses Radix UI primitives
+          testing:
+            custom: |
+              - Storybook visual tests
+              - Run `pnpm -F ui test:visual`
+
+  cursor:
+    enabled: true
+    agent_type: composer
+    workspace_config:
+      context_files:
+        - "**/*.ts"
+        - "**/*.tsx"
+        - "**/package.json"
+      ignore_patterns:
+        - "**/node_modules/**"
+        - "**/dist/**"
+        - "**/.turbo/**"

package/examples/anthropic/claude-assistant.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.3.0",
   "kind": "Agent",
   "metadata": {
     "name": "claude-assistant",