@bluefly/openstandardagents 0.2.4 → 0.2.7

package/.cursorrules

@@ -0,0 +1,84 @@
+# OSSA Project Rules for Cursor Agent
+
+This file contains project-specific rules for Cursor Agent. Additional detailed rules are in `.cursor/rules/`.
+
+## Core Principles
+- OpenAPI-First: All APIs must be defined in OpenAPI 3.1 specs
+- TDD-Centric: Write tests first, then implement, then refactor
+- Schema-Driven: OSSA schema is the source of truth
+- No Vendor Lock-in: OSSA is a standard, not a framework
+
+## Critical Workflows
+
+### Version Management
+**NEVER manually update version numbers in any file.**
+- Single source of truth: `.version.json`
+- Use `npm run version:bump <type>` to change versions (rc, patch, minor, major, release)
+- Use `{{VERSION}}` placeholders in documentation
+- Versions auto-sync before every build
+- See `.gitlab/docs/development/VERSIONING.md` for complete guide
+
+### Before Config Work
+**ALWAYS** run `ddev drush cst` before working with Drupal config. This is CRITICAL.
+
+### Schema Updates
+1. Update schema JSON in `spec/v0.2.5-RC/`
+2. Run `npm run gen:types` to generate TypeScript types
+3. Run `npm run gen:zod` to generate Zod validators
+4. Run `npm run validate:schema` to validate schema
+5. Update examples and tests
+
+### OSSA Manifest Validation
+- All `.ossa.yaml` and `agent.yml` files must validate
+- Run `ossa validate` before committing
+- Examples in `examples/` must all validate
+
+### Testing Requirements
+- Unit tests for service logic and utilities
+- Integration tests for CLI commands and workflows
+- E2E tests for full validation workflows
+- 95%+ test coverage required
+
+## Prohibited Operations
+- ❌ Direct commits to `main` or `development` branches
+- ❌ Skipping tests
+- ❌ Breaking schema without migration
+- ❌ Hardcoded secrets
+- ❌ Bypassing hooks (`LEFTHOOK=0`)
+- ❌ Creating `.md` files (use GitLab Wiki)
+- ❌ Creating `.sh` files (use TypeScript/Node scripts)
+- ❌ Deleting critical files (use `__DELETE_LATER/` folder)
+
+## File Organization
+- `spec/` - OSSA schema definitions
+- `src/` - Source code (TypeScript)
+- `tests/` - Test files (unit, integration, e2e)
+- `examples/` - Example OSSA manifests
+- `openapi/` - OpenAPI specifications
+- `docs/` - Documentation
+
+## Custom Commands
+Use these custom commands for OSSA workflows:
+- `/ossa-validate` - Validate OSSA manifests
+- `/ossa-generate` - Generate OSSA agents
+- `/ossa-migrate` - Migrate between versions
+- `/ossa-test` - Run test suite
+- `/ossa-openapi` - Work with OpenAPI specs
+- `/ossa-schema` - Work with schema
+- `/ossa-release` - Manage releases
+- `/ossa-refactor` - Refactor code
+- `/ossa-debug` - Debug issues
+
+## Git Workflow
+- Feature branches branch off `development`
+- No direct commits to `main` or `development`
+- Merge requests required
+- CI must pass before merge
+
+## Release Process
+Releases require:
+- Milestone 100% complete and closed
+- `ENABLE_RELEASE=true` CI variable set
+
+See `.cursor/rules/ossa-development.md` for detailed rules.
+

package/.devfile.yaml

@@ -0,0 +1,87 @@
+schemaVersion: 2.2.0
+metadata:
+  name: ossa-development
+  version: 0.2.5-RC
+  description: OSSA development environment with GitLab agent access
+components:
+  - name: dev-tools
+    container:
+      image: node:22-alpine
+      memoryLimit: 4Gi
+      cpuLimit: 2000m
+      mountSources: true
+      env:
+        - name: NODE_ENV
+          value: development
+        - name: KUBECONFIG
+          value: /workspace/.kube/config
+      volumeMounts:
+        - name: kube-config
+          path: /workspace/.kube
+  
+  - name: kubectl
+    container:
+      image: bitnami/kubectl:latest
+      memoryLimit: 512Mi
+      cpuLimit: 500m
+      env:
+        - name: KUBECONFIG
+          value: /workspace/.kube/config
+      volumeMounts:
+        - name: kube-config
+          path: /workspace/.kube
+
+volumes:
+  - name: kube-config
+    ephemeral: true
+
+commands:
+  - id: install
+    exec:
+      component: dev-tools
+      commandLine: npm ci --legacy-peer-deps
+      workingDir: ${PROJECT_SOURCE}
+  
+  - id: build
+    exec:
+      component: dev-tools
+      commandLine: npm run build
+      workingDir: ${PROJECT_SOURCE}
+  
+  - id: test
+    exec:
+      component: dev-tools
+      commandLine: npm test
+      workingDir: ${PROJECT_SOURCE}
+  
+  - id: lint
+    exec:
+      component: dev-tools
+      commandLine: npm run lint
+      workingDir: ${PROJECT_SOURCE}
+  
+  - id: version-sync
+    exec:
+      component: dev-tools
+      commandLine: npm run version:sync
+      workingDir: ${PROJECT_SOURCE}
+  
+  - id: deploy-agents
+    exec:
+      component: kubectl
+      commandLine: kubectl apply -f .gitlab/agents/
+      workingDir: ${PROJECT_SOURCE}
+  
+  - id: get-pods
+    exec:
+      component: kubectl
+      commandLine: kubectl get pods -n ossa-agents
+  
+  - id: agent-logs
+    exec:
+      component: kubectl
+      commandLine: kubectl logs -n ossa-agents -l app=version-manager --tail=100 -f
+
+events:
+  postStart:
+    - install

package/.env.example

@@ -1,13 +1,35 @@
 # OSSA Production Environment Variables
-# Copy to .env and update values
+# Copy to .env.local and update values
 
 # ===========================================
 # Version & Environment
 # ===========================================
-VERSION=0.1.9
+VERSION=0.2.4
 NODE_ENV=production
 LOG_LEVEL=info
 
+# ===========================================
+# GitLab Configuration
+# ===========================================
+# Primary GitLab instance (PUBLIC - gitlab.com)
+GITLAB_PRIMARY_URL=https://gitlab.com/blueflyio/openstandardagents
+GITLAB_API_URL=https://gitlab.com/api/v4
+GITLAB_PUSH_TOKEN=your-gitlab-push-token-here
+GITLAB_URL=https://gitlab.com
+GITLAB_PROJECT_PATH=blueflyio/openstandardagents
+GITLAB_PROJECT_ID=your-project-id
+
+
+# ===========================================
+# GitHub Configuration (Mirror)
+# ===========================================
+GITHUB_API_URL=https://api.github.com
+GITHUB_BASE_URL=https://api.github.com
+GITHUB_URL=https://github.com
+GITHUB_REPOSITORY=blueflyio/openstandardagents
+GITHUB_MIRROR_TOKEN=your-github-token-here
+GITHUB_TOKEN=your-github-token-here
+
 # ===========================================
 # Security & Authentication
 # ===========================================
@@ -38,4 +60,4 @@ PROMETHEUS_URL=http://prometheus:9090
 # Development Overrides (optional)
 # ===========================================
 # DOCKER_BUILDKIT=1
-# COMPOSE_PROJECT_NAME=ossa
+# COMPOSE_PROJECT_NAME=ossa

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,63 @@
+name: Bug Report
+description: Report a bug in OSSA
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! We'll review and create an internal issue if needed.
+        
+        **Note**: Development happens on [GitLab](https://gitlab.com/blueflyio/openstandardagents).
+  
+  - type: input
+    id: version
+    attributes:
+      label: OSSA Version
+      description: Which version are you using?
+      placeholder: "0.2.6"
+    validations:
+      required: true
+  
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: What happened?
+      placeholder: Clear description of the bug
+    validations:
+      required: true
+  
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this?
+      placeholder: |
+        1. Install OSSA
+        2. Run command...
+        3. See error
+    validations:
+      required: true
+  
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should happen?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: Any relevant logs or error messages
+      render: shell

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,40 @@
+name: Feature Request
+description: Suggest a feature for OSSA
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! We'll review and add to our roadmap if appropriate.
+        
+        **Note**: Development happens on [GitLab](https://gitlab.com/blueflyio/openstandardagents).
+  
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve?
+      placeholder: I'm frustrated when...
+    validations:
+      required: true
+  
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should this work?
+      placeholder: I'd like to be able to...
+    validations:
+      required: true
+  
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What other solutions have you considered?
+  
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other context or screenshots

package/.github/workflows/dependabot-comment.yml

@@ -0,0 +1,34 @@
+name: Dependabot Comment
+
+on:
+  pull_request:
+    types: [opened]
+
+jobs:
+  comment:
+    if: github.actor == 'dependabot[bot]'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Comment on Dependabot PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `🤖 **Dependabot Update**
+
+This PR will be batched with other dependency updates and synced to our internal GitLab for testing.
+
+**Process:**
+1. We batch Dependabot PRs weekly
+2. Test on GitLab CI
+3. Merge and sync back to GitHub
+4. This PR will auto-close when changes appear in main
+
+**Timeline:** Usually within 7 days.
+
+---
+*This is a public mirror. Development at [gitlab.com/blueflyio/openstandardagents](https://gitlab.com/blueflyio/openstandardagents).*`
+            })

package/.github/workflows/pr-comment.yml

@@ -0,0 +1,33 @@
+name: PR Comment
+
+on:
+  pull_request:
+    types: [opened]
+
+jobs:
+  comment:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Comment on PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `👋 Thanks for your contribution!
+
+**Review Process:**
+1. We'll review your PR here on GitHub
+2. If approved, we'll sync it to our internal GitLab for final testing
+3. Once merged on GitLab, changes will automatically sync back here
+4. Your PR will auto-close when the changes appear in main
+
+**Timeline:** We aim to review within 48 hours.
+
+**Questions?** Feel free to ask in the comments or join our [Discord](https://discord.gg/ossa).
+
+---
+*This is a public mirror of our GitLab repository. Development happens at [gitlab.com/blueflyio/openstandardagents](https://gitlab.com/blueflyio/openstandardagents).*`
+            })

package/.github/workflows/release.yml

@@ -99,5 +99,5 @@ jobs:
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./website/out
-          cname: ossa.bluefly.io
+          cname: openstandardagents.org
           commit_message: 'deploy: update website from ${{ github.sha }}'

package/.husky/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+# Run validation before commit
+npm run validate:all

package/.kiro/config.json

@@ -0,0 +1,21 @@
+{
+  "version": "1.0",
+  "templateSource": "@bluefly/kiro-supercharger",
+  "templateVersion": "^0.1.0",
+  "overrides": {
+    "steering": [],
+    "hooks": [],
+    "settings": []
+  },
+  "disabled": {
+    "steering": [],
+    "hooks": [],
+    "mcpServers": []
+  },
+  "safety": {
+    "blockDangerousCommands": true,
+    "blockedPatterns": [],
+    "allowedCommands": [],
+    "requireConfirmation": true
+  }
+}

package/.kiro/settings/mcp.json

@@ -0,0 +1,61 @@
+{
+  "mcpServers": {
+    "gitlab": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@yoda.digital/gitlab-mcp-server"
+      ],
+      "env": {
+        "GITLAB_TOKEN": "glpat-L2hs2c9DugIGBBKYTHU3Vm86MQp1Oml4NzA0Cw.01.120ly0fym",
+        "GITLAB_URL": "https://gitlab.com"
+      },
+      "disabled": false
+    },
+    "browsermcp": {
+      "command": "npx",
+      "args": [
+        "@browsermcp/mcp@latest"
+      ],
+      "disabled": false,
+      "autoApprove": [
+        "browser_navigate"
+      ]
+    },
+    "postgres": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-postgres",
+        "postgresql://localhost/postgres"
+      ],
+      "disabled": false
+    },
+    "sqlite": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-sqlite",
+        "--db-path",
+        "/tmp/test.db"
+      ],
+      "disabled": false
+    },
+    "memory": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-memory"
+      ],
+      "disabled": false
+    },
+    "sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ],
+      "disabled": false
+    }
+  }
+}