@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

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/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 }}'