@bluefly/openstandardagents 0.2.7 → 0.2.9

package/.github/workflows/pr-triage-to-gitlab.yml

@@ -0,0 +1,164 @@
+name: PR Triage to GitLab
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  pull_request_review:
+    types: [submitted]
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
+jobs:
+  # Triage new PRs and create corresponding GitLab MR
+  triage-pr:
+    if: github.event_name == 'pull_request' && github.event.action == 'opened'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Welcome and Triage
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const prNumber = pr.number;
+            const prTitle = pr.title;
+            const prBody = pr.body || '';
+            const author = pr.user.login;
+
+            // Add triage label
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+              labels: ['github-pr', 'needs-triage']
+            });
+
+            // Welcome message with GitLab sync info
+            const welcomeMessage = `## 👋 Welcome @${author}!
+
+Thank you for your contribution to **OSSA (Open Standard for Scalable AI Agents)**!
+
+### 📋 Triage Process
+
+This GitHub repository is a **public mirror** of our [GitLab repository](https://gitlab.com/blueflyio/openstandardagents). Here's what happens next:
+
+1. **🤖 Automated Triage** - Your PR will be analyzed by our OSSA-powered agents
+2. **🔗 GitLab Sync** - If approved, a corresponding MR will be created on GitLab
+3. **✅ Review & Merge** - Core team reviews on GitLab where CI/CD runs
+4. **🔄 Auto-Close** - This PR auto-closes when changes sync back to GitHub
+
+### 📝 PR Details
+
+| Field | Value |
+|-------|-------|
+| Title | \`${prTitle}\` |
+| Author | @${author} |
+| Files Changed | ${pr.changed_files} |
+| Additions | +${pr.additions} |
+| Deletions | -${pr.deletions} |
+
+### ⏱️ Timeline
+
+We aim to triage within **24-48 hours**. For urgent issues, please also file an issue on [GitLab](https://gitlab.com/blueflyio/openstandardagents/-/issues).
+
+---
+
+*🦊 [GitLab Repository](https://gitlab.com/blueflyio/openstandardagents) | 📖 [Documentation](https://openstandardagents.org) | 💬 [Discord](https://discord.gg/ossa)*`;
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+              body: welcomeMessage
+            });
+
+      - name: Notify GitLab Agent Platform
+        if: ${{ secrets.GITLAB_WEBHOOK_URL }}
+        run: |
+          curl -X POST "${{ secrets.GITLAB_WEBHOOK_URL }}" \
+            -H "Content-Type: application/json" \
+            -H "X-GitHub-Event: pull_request" \
+            -d '{
+              "event": "github_pr_opened",
+              "pr_number": ${{ github.event.pull_request.number }},
+              "pr_title": "${{ github.event.pull_request.title }}",
+              "pr_url": "${{ github.event.pull_request.html_url }}",
+              "author": "${{ github.event.pull_request.user.login }}",
+              "head_sha": "${{ github.event.pull_request.head.sha }}",
+              "base_branch": "${{ github.event.pull_request.base.ref }}"
+            }'
+
+  # Sync PR updates to GitLab
+  sync-pr-updates:
+    if: github.event_name == 'pull_request' && github.event.action == 'synchronize'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Notify GitLab of PR Update
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number,
+              body: '🔄 PR updated. Changes will be synced to GitLab MR.'
+            });
+
+  # Handle review comments - sync to GitLab
+  sync-review:
+    if: github.event_name == 'pull_request_review'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Log Review
+        run: |
+          echo "Review submitted: ${{ github.event.review.state }}"
+          echo "Reviewer: ${{ github.event.review.user.login }}"
+
+  # Auto-close PRs that duplicate existing GitLab MRs
+  check-duplicate:
+    if: github.event_name == 'pull_request' && github.event.action == 'opened'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check for Duplicate
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+
+            // Check if this is a bot PR (from GitLab sync)
+            if (pr.user.login === 'github-actions[bot]' || pr.user.login === 'gitlab-mirror') {
+              console.log('Skipping bot PR');
+              return;
+            }
+
+            // Check if PR title matches existing GitLab MR pattern
+            const mrPattern = /^(feat|fix|docs|refactor|test|chore|perf)(\(.+\))?!?:/;
+            if (!mrPattern.test(pr.title)) {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: pr.number,
+                body: `⚠️ **PR Title Format**
+
+Please use [Conventional Commits](https://www.conventionalcommits.org/) format:
+- \`feat: add new feature\`
+- \`fix: resolve bug\`
+- \`docs: update documentation\`
+
+This helps with automated changelog generation and semantic versioning.`
+              });
+
+              await github.rest.issues.addLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: pr.number,
+                labels: ['needs-title-fix']
+              });
+            }

package/.version.json

@@ -1,6 +1,6 @@
 {
-  "current": "0.2.5-RC",
-  "latest_stable": "0.2.4",
+  "current": "0.2.9",
+  "latest_stable": "0.2.5-RC",
   "spec_path": "spec/v{version}",
   "schema_file": "ossa-{version}.schema.json"
 }

package/.wiki-config.json

@@ -0,0 +1,24 @@
+{
+  "PROJECT_NAME": "@bluefly/openstandardagents",
+  "PROJECT_DESCRIPTION": "OSSA - Open Standard for Scalable AI Agents. A specification standard for AI agents (like OpenAPI for REST APIs). NOT a framework.",
+  "VERSION": "0.2.9",
+  "STATUS": "Active",
+  "LICENSE": "MIT",
+  "KEY_FEATURES": "- Comprehensive test suite\n- Type-safe TypeScript",
+  "REPO_URL": "https://gitlab.com/blueflyio/agent-platform/@bluefly/openstandardagents",
+  "GITLAB_ISSUES_URL": "https://gitlab.com/blueflyio/agent-platform/@bluefly/openstandardagents/-/issues",
+  "DOCS_URL": "https://gitlab.com/blueflyio/agent-platform/@bluefly/openstandardagents/-/wikis/home",
+  "TEAM_CONTACT": "team@bluefly.io",
+  "PREREQUISITES": "- Node.js 18+\n- TypeScript 5+",
+  "INSTALL_COMMAND": "npm install",
+  "START_COMMAND": "tsc --watch",
+  "VERIFY_COMMAND": "jest",
+  "BACKEND_STACK": "- Zod - Schema validation",
+  "FRONTEND_STACK": "N/A",
+  "INFRASTRUCTURE_STACK": "- Docker\n- GitLab CI/CD",
+  "API_BASE_URL": "http://localhost:3000/api",
+  "OPENAPI_URL": "N/A",
+  "UNIT_TEST_COMMAND": "jest",
+  "LINT_COMMAND": "eslint src tests --ext .ts",
+  "FORMAT_COMMAND": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\""
+}

package/CHANGELOG.md

@@ -5,6 +5,49 @@ All notable changes to OSSA (Open Standard for Scalable AI Agents) will be docum
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.9] - 2025-12-04
+
+### Added
+
+- **Reasoning Strategies** (`spec.reasoning`): Declarative configuration for agent reasoning
+  - Strategy selection: ReAct, Chain of Thought (CoT), Tree of Thought (ToT), custom
+  - Step and depth limits for controlled reasoning
+  - Reasoning trace export to observability (OTEL, JSON, Markdown)
+  - Self-reflection configuration with confidence thresholds
+  - Refs: #107
+
+- **Prompt Management** (`spec.prompts`): Structured prompt templating and versioning
+  - System and user prompt templates with file references
+  - Semantic versioning for A/B testing
+  - Template variable interpolation
+  - Few-shot examples array (up to 20 examples)
+  - External prompt registry integration (Langfuse, PromptLayer)
+  - Refs: #108
+
+- **Knowledge Graph Integration** (`spec.knowledge_graph`): Native graph database support
+  - Provider support: Neo4j, Neptune, Dgraph, Memgraph, custom
+  - Connection configuration with credential references
+  - Schema constraints for entity and relationship types
+  - Sync modes: real-time, batch, on-demand
+  - Refs: #109
+
+- **agents.md Extension**: OpenAI repository-level agent guidance support
+
+### Documentation
+
+- Added `examples/advanced/reasoning-agent.yaml` demonstrating all new features
+- Updated schema description with v0.2.9 capabilities
+
+## [0.2.8] - 2025-11-30
+
+### Fixed
+- Version synchronization across all project files
+- Corrected `.version.json` to match package version
+- Schema export paths in package.json
+
+### Changed
+- Updated latest_stable reference to 0.2.5-RC (skipping burned 0.2.6/0.2.7)
+
 ## [0.2.6] - 2025-11-26
 
 ### Added
@@ -71,23 +114,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Enhanced getting started documentation with detailed option descriptions
 - Updated README.md with running agents section
 
-## [0.2.4](https://github.com/blueflyio/openstandardagents/compare/v0.2.3...v0.2.4) (2025-11-19)
-
-### Package Rename
-
-- **IMPORTANT**: Package renamed from `@bluefly/open-standards-scalable-agents` to `@bluefly/openstandardagents`
-- The old package `@bluefly/open-standards-scalable-agents` has been deprecated
-- Update your dependencies: `npm install @bluefly/openstandardagents`
-
-### Website Fixes
-
-- Fixed 100+ broken links (gitlab.com → github.com/blueflyio/openstandardagents)
-- Fixed npm registry auth in CI pipeline
-- Standardized all package references across documentation
-- Fixed broken internal links (/docs/deployment, /research, CLI-Reference)
-- Updated all schema version references to v0.2.3
-- Fixed RSS feed base URL to openstandardagents.org
-
 ## [0.2.3](https://github.com/blueflyio/openstandardagents/compare/v0.2.2...v0.2.3) (2025-11-12)
 
 ### Documentation
@@ -216,4 +242,4 @@ Improvements:
 
 - Production example validates with 80/100 audit score
 - All required fields properly enforced
-- Comprehensive validation output
+- Comprehensive validation output

package/CODEOWNERS

@@ -0,0 +1,75 @@
+# CODEOWNERS for openstandardagents (OSSA Spec)
+# https://docs.gitlab.com/ee/user/project/codeowners/
+
+# =============================================================================
+# DEFAULT OWNERS
+# =============================================================================
+* @blueflyio/ossa-maintainers
+
+# =============================================================================
+# SPEC & SCHEMA (Critical - Requires OSSA Bot + TypeScript Bot)
+# =============================================================================
+/spec/                     @blueflyio/ossa-spec-maintainers @bot-ossa-local
+/spec/**/*.schema.json     @blueflyio/ossa-spec-maintainers @bot-typescript-local @bot-ossa-local
+/spec/**/CHANGELOG.md      @blueflyio/ossa-spec-maintainers @bot-wiki-aggregator
+
+# =============================================================================
+# CLI & SOURCE CODE (TypeScript Bot + Dev Bot)
+# =============================================================================
+/src/                      @blueflyio/ossa-dev-team @bot-typescript-local @bot-native-local
+/bin/                      @blueflyio/ossa-dev-team @bot-typescript-local
+/tests/                    @blueflyio/ossa-dev-team @bot-typescript-local
+
+# =============================================================================
+# EXAMPLES (OSSA Bot validates, Dev Bot implements)
+# =============================================================================
+/examples/                 @blueflyio/ossa-examples-team @bot-ossa-local @bot-native-local
+
+# =============================================================================
+# CI/CD & INFRASTRUCTURE (CI Bot + K8s Agents)
+# =============================================================================
+/.gitlab-ci.yml            @flux423 @blueflyio/platform-team @bot-ci-local
+/.gitlab/                  @flux423 @blueflyio/platform-team @bot-ci-local
+/infrastructure/           @flux423 @blueflyio/platform-team @bot-ci-local
+
+# =============================================================================
+# AGENTS (OSSA Bot validates agent manifests)
+# =============================================================================
+/.agents/                  @blueflyio/ossa-agent-team @bot-ossa-local
+/agents/                   @blueflyio/ossa-agent-team @bot-ossa-local
+
+# =============================================================================
+# DOCUMENTATION (Wiki Aggregator syncs)
+# =============================================================================
+/docs/                     @blueflyio/ossa-docs-team @bot-wiki-aggregator
+README.md                  @blueflyio/ossa-docs-team @bot-wiki-aggregator
+CONTRIBUTING.md            @blueflyio/ossa-docs-team @bot-wiki-aggregator
+CHANGELOG.md               @blueflyio/ossa-docs-team @bot-wiki-aggregator
+
+# =============================================================================
+# RELEASE & VERSIONING (CI Bot manages releases)
+# =============================================================================
+package.json               @flux423 @blueflyio/ossa-maintainers @bot-ci-local
+package-lock.json          @flux423 @blueflyio/ossa-maintainers @bot-ci-local
+.releaserc.json            @flux423 @blueflyio/ossa-maintainers @bot-ci-local
+.version.json              @flux423 @blueflyio/ossa-maintainers @bot-ci-local
+
+# =============================================================================
+# SCRIPTS (TypeScript Bot + CI Bot)
+# =============================================================================
+/scripts/                  @flux423 @blueflyio/platform-team @bot-typescript-local @bot-ci-local
+
+# =============================================================================
+# BOT & AGENT TOKEN MAPPING
+# =============================================================================
+# GITLAB_BOT_TS_TOKEN      -> @bot-typescript-local  (TypeScript code)
+# GITLAB_BOT_OSSA_TOKEN    -> @bot-ossa-local        (OSSA validation)
+# GITLAB_BOT_CI_TOKEN      -> @bot-ci-local          (CI/CD pipelines)
+# GITLAB_BOT_DEV_TOKEN     -> @bot-native-local      (General dev)
+# GITLAB_BOT_WIKI_TOKEN    -> @bot-wiki-aggregator   (Documentation sync)
+#
+# K8s Agents (GitOps deployments):
+# AGENT_K8_TS_LOCAL        -> TypeScript local namespace
+# AGENT_K8_TS_PROD         -> TypeScript production namespace
+# AGENT_K8_GITLAB_LIB_CI   -> GitLab components CI
+# AGENT_K8_INFRA_PROD      -> Infrastructure production

package/CONTRIBUTING.md

@@ -4,6 +4,7 @@ Thank you for your interest in contributing to **OSSA (Open Standard for Scalabl
 
 ## 📋 Table of Contents
 
+- [Repository Structure](#repository-structure)
 - [Code of Conduct](#code-of-conduct)
 - [Getting Started](#getting-started)
 - [Development Workflow](#development-workflow)
@@ -13,6 +14,60 @@ Thank you for your interest in contributing to **OSSA (Open Standard for Scalabl
 - [Testing](#testing)
 - [Documentation](#documentation)
 
+## 🏗️ Repository Structure
+
+OSSA uses a **dual-repository workflow**:
+
+| Repository | Purpose | Access |
+|------------|---------|--------|
+| [GitLab](https://gitlab.com/blueflyio/openstandardagents) | Primary development, CI/CD, releases | Private (core team) |
+| [GitHub](https://github.com/blueflyio/openstandardagents) | Public mirror, community contributions | Public |
+
+### How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                     Community Contribution Flow                  │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   GitHub (Public)              GitLab (Private)                 │
+│   ┌─────────────┐              ┌─────────────┐                 │
+│   │   Issue     │──── sync ───▶│   Issue     │                 │
+│   │   or PR     │              │   or MR     │                 │
+│   └─────────────┘              └──────┬──────┘                 │
+│                                       │                         │
+│                                       ▼                         │
+│                                ┌─────────────┐                 │
+│                                │   CI/CD     │                 │
+│                                │   Tests     │                 │
+│                                └──────┬──────┘                 │
+│                                       │                         │
+│                                       ▼                         │
+│   ┌─────────────┐              ┌─────────────┐                 │
+│   │   Mirror    │◀── push ────│   Merge     │                 │
+│   │   Updated   │              │   to main   │                 │
+│   └─────────────┘              └─────────────┘                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Where to Contribute
+
+| Contribution Type | Where | Notes |
+|-------------------|-------|-------|
+| Bug reports | GitHub Issues | Auto-synced to GitLab |
+| Feature requests | GitHub Issues | Auto-synced to GitLab |
+| Code changes | GitHub PR | Reviewed here, merged on GitLab |
+| Documentation | GitHub PR | Same as code |
+| Security issues | Email only | ops@openstandardagents.org |
+
+### Why Dual Repositories?
+
+1. **Privacy**: Internal development, CI/CD secrets, and infrastructure stay private
+2. **Public Access**: Open specification accessible to the community
+3. **Best of Both**: GitLab's superior CI/CD + GitHub's community reach
+4. **Agent-Powered**: OSSA agents automate sync between platforms
+
 ## 🤝 Code of Conduct
 
 This project adheres to a Code of Conduct. By participating, you are expected to uphold this code.
@@ -169,12 +224,56 @@ git commit -m "docs: update getting started guide"
    - Security audit passes
 4. **Request review** from maintainers
 5. **Address feedback**
-6. **Squash commits** if needed (optional)
-7. **Merge** using "Squash and Merge" or "Rebase and Merge"
+6. **Squash commits** for feature branches (recommended)
+7. **Merge** using "Squash and Merge" (default for feature branches)
+
+### Squash Merge Workflow
+
+**This project encourages squash merging for feature branches** to maintain a clean, readable git history.
+
+#### When to Squash
+
+- **Feature branches** (`feat/*`, `fix/*`, `refactor/*`): Always squash
+- **Documentation branches** (`docs/*`): Squash if multiple commits
+- **Major releases**: May preserve commit history (case-by-case)
+
+#### Best Practices
+
+1. **Enable squash** when creating the merge request (encouraged by default)
+2. **Write a clear squash commit message** following conventional commits format
+3. **Include issue references** in the squash commit message (e.g., `Closes #123`)
+4. **Summarize all changes** in the squash commit body if multiple features were added
+
+#### Squash Commit Message Format
+
+When squashing, the final commit message should be:
+
+```
+<type>(<scope>): <summary of all changes>
+
+- Detailed change 1
+- Detailed change 2
+- Detailed change 3
+
+Closes #123
+```
+
+**Example:**
+
+```
+feat(validation): add multi-framework extension support
+
+- Add CrewAI extension validator
+- Add LangGraph extension validator
+- Update schema documentation with examples
+- Add integration tests for all validators
+
+Closes #123, Closes #124
+```
 
 ### PR Title Convention
 
-PR titles should follow the conventional commit format:
+PR titles should follow the conventional commit format (this becomes the squash commit title):
 
 ```
 feat: add LangGraph extension support
@@ -238,7 +337,7 @@ Internal project documentation is located in `.gitlab/docs/`:
 
 **DO NOT** open public issues for security vulnerabilities.
 
-Email: operations@bluefly.io
+Email: ops@openstandardagents.org
 
 ## 📊 Code Style