@bluefly/openstandardagents 0.2.8 → 0.2.9

package/examples/extensions/agents-md-v1.yml

@@ -0,0 +1,175 @@
+# OSSA agents.md Extension Schema
+# OpenAI agents.md repository-level agent guidance generation
+# See: https://agents.md | https://github.com/openai/agents.md
+
+apiVersion: ossa/v0.2.9
+kind: ExtensionSchema
+metadata:
+  name: agents-md-extension
+  version: v1
+  namespace: ossa/extensions
+spec:
+  compatibleWith:
+    - agents.md/v1
+  description: "Extension schema for OpenAI agents.md repository-level agent guidance"
+
+  references:
+    specification: https://agents.md
+    repository: https://github.com/openai/agents.md
+    adoption: "20,000+ OSS projects"
+
+  supportedTools:
+    - OpenAI Codex
+    - Google Jules
+    - Cursor
+    - GitHub Copilot
+    - VS Code
+    - Zed
+    - Aider
+    - Gemini CLI
+
+  additionalFields:
+    agent:
+      enabled:
+        type: boolean
+        default: false
+        description: "Enable agents.md generation"
+
+      generate:
+        type: boolean
+        default: true
+        description: "Auto-generate AGENTS.md from manifest"
+
+      output_path:
+        type: string
+        default: "AGENTS.md"
+        description: "Output path for generated file"
+
+      sections:
+        type: object
+        properties:
+          dev_environment:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Dev environment tips section"
+          testing:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Testing instructions section"
+          pr_instructions:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "PR guidelines section"
+          code_style:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Code style guidelines section"
+          security:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Security considerations section"
+          custom:
+            type: array
+            items:
+              type: object
+              required: [title, content]
+              properties:
+                title:
+                  type: string
+                content:
+                  type: string
+            description: "Custom sections"
+
+      sync:
+        type: object
+        properties:
+          on_manifest_change:
+            type: boolean
+            default: true
+          include_comments:
+            type: boolean
+            default: true
+          watch:
+            type: boolean
+            default: false
+
+      mapping:
+        type: object
+        properties:
+          tools_to_dev_environment:
+            type: boolean
+            default: true
+            description: "Map spec.tools → Dev environment tips"
+          constraints_to_testing:
+            type: boolean
+            default: true
+            description: "Map spec.constraints → Testing requirements"
+          autonomy_to_pr_instructions:
+            type: boolean
+            default: true
+            description: "Map spec.autonomy → PR workflow hints"
+          role_from_agents_md:
+            type: boolean
+            default: false
+            description: "Parse AGENTS.md → spec.role hints"
+
+      cursor_integration:
+        type: boolean
+        default: false
+        description: "Generate Cursor-compatible content"
+
+      nested_files:
+        type: array
+        items:
+          type: object
+          required: [path]
+          properties:
+            path:
+              type: string
+            inherit:
+              type: boolean
+              default: true
+            sections:
+              type: object
+
+  definitions:
+    AgentsMdSection:
+      type: object
+      properties:
+        enabled:
+          type: boolean
+          default: true
+        source:
+          type: string
+          description: "OSSA manifest path (e.g., 'spec.tools')"
+        custom:
+          type: string
+          description: "Custom markdown content"
+        title:
+          type: string
+          description: "Section header override"
+        append:
+          type: string
+          description: "Content to append after auto-generated"
+
+  validation:
+    required: []
+    customRules:
+      - name: "validate-output-path"
+        rule: "output_path must end with .md extension or be 'AGENTS.md'"
+      - name: "validate-nested-paths"
+        rule: "nested_files paths must be valid relative directories"
+      - name: "validate-cursor-integration"
+        rule: "If cursor_integration is true, extensions.cursor should also be enabled"
+
+  migration:
+    fromVersion: null
+    toVersion: "v1"
+    breakingChanges: []
+    migrationGuide: "https://openstandardagents.org/docs/extensions/agents-md"
+
+  cliCommands:
+    - name: "ossa agents-md generate"
+      description: "Generate AGENTS.md from manifest"
+      usage: "ossa agents-md generate --manifest .agents/my-agent/manifest.yaml"
+    - name: "ossa agents-md validate"
+      description: "Validate AGENTS.md against manifest"
+      usage: "ossa agents-md validate --agents-md AGENTS.md --manifest .agents/my-agent/manifest.yaml"
+    - name: "ossa agents-md sync"
+      description: "Sync AGENTS.md with manifest changes"
+      usage: "ossa agents-md sync --watch"

package/examples/extensions/drupal-v1.yml

@@ -2,7 +2,7 @@
 # Extension specification for Drupal LLM Platform deployment
 # Compatible with Drupal 10+ and llm-platform modules
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: ExtensionSchema
 metadata:
   name: drupal-extension

package/examples/extensions/kagent-v1.yml

@@ -2,7 +2,7 @@
 # Production-grade specification for Kubernetes-native agent deployment
 # Compatible with kagent.dev/v1alpha1 CRDs
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: ExtensionSchema
 metadata:
   name: kagent-extension

package/examples/getting-started/hello-world-complete.ossa.yaml

@@ -32,7 +32,7 @@
 #
 # ============================================================================
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml

@@ -36,7 +36,7 @@
 # ----------------------------------------------------------------------------
 # Coordinates the workflow, delegates tasks to worker agents, and aggregates results
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -154,7 +154,7 @@ spec:
 # Specialized agent for research tasks
 
 ---
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -221,7 +221,7 @@ spec:
 # Specialized agent for data analysis
 
 ---
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -282,7 +282,7 @@ spec:
 # Specialized agent for content creation
 
 ---
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/kagent/compliance-validator.ossa.yaml

@@ -2,7 +2,7 @@
 # Compliance Validator Agent
 # Domain: compliance.validation.continuous
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: compliance-validator

package/examples/kagent/cost-optimizer.ossa.yaml

@@ -2,7 +2,7 @@
 # Cost Optimizer Agent
 # Domain: infrastructure.cost.optimization
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: cost-optimizer

package/examples/kagent/documentation-agent.ossa.yaml

@@ -2,7 +2,7 @@
 # Documentation Agent
 # Domain: documentation.generation.automated
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: documentation-agent

package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml

@@ -2,7 +2,7 @@
 # Kubernetes Troubleshooter Agent with KAgent Bridge
 # Fully compatible with kagent.dev/v1alpha2
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 ossaVersion: "1.0"
 
 agent:

package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: k8s-troubleshooter

package/examples/kagent/k8s-troubleshooter.ossa.yaml

@@ -17,7 +17,7 @@
 # Domain: infrastructure.kubernetes.troubleshooting
 # ============================================================================
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   # Basic agent identification metadata

package/examples/kagent/security-scanner.ossa.yaml

@@ -6,7 +6,7 @@
 # Last Updated: 2025-11-10
 # ============================================================================
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   # Core identity metadata for the security scanning agent

package/examples/langchain/chain-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "langchain-agent",

package/examples/langflow/workflow-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "workflow-orchestrator",

package/examples/langgraph/state-machine-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "state-machine-agent",

package/examples/llamaindex/rag-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "rag-query-agent",

package/examples/migration-guides/from-langchain-to-ossa.yaml

@@ -50,7 +50,7 @@
 # OSSA MANIFEST (After):
 # ----------------------------------------------------------------------------
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -117,7 +117,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -185,7 +185,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -215,7 +215,7 @@ spec:
       endpoint: https://api.academic.com/search
 
 ---
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/multi-agent/conditional-router.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: conditional-router

package/examples/multi-agent/parallel-execution.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: parallel-executor

package/examples/multi-agent/sequential-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: sequential-pipeline

package/examples/openai/basic-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/openai/multi-tool-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "multi-tool-agent",

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

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",

package/examples/production/document-analyzer-openai.yml

@@ -1,7 +1,7 @@
 # OSSA Agent with OpenAI Bridge Configuration Example
 # Document Analyzer Agent - Proof of Concept
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: document-analyzer

package/examples/quickstart/support-agent.ossa.yaml

@@ -1,7 +1,7 @@
 # OSSA Quickstart Example - Customer Support Agent
 # Run with: ossa run examples/quickstart/support-agent.ossa.yaml
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/templates/ossa-compliance.yaml

@@ -1,6 +1,6 @@
 # OSSA v0.1.9 Compliance Configuration for __ARCHIVE_REPORTS
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: 'ComplianceConfiguration'
 metadata:
   name: '__ARCHIVE_REPORTS-compliance'

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

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",

package/llms.txt

@@ -13,7 +13,7 @@ Key features:
 
 ## Core Specification
 
-- [OSSA Schema v0.2.8](https://gitlab.com/blueflyio/openstandardagents/-/blob/main/spec/ossa-schema.yaml): Complete agent definition schema with capabilities, triggers, and outputs
+- [OSSA Schema v0.2.9](https://gitlab.com/blueflyio/openstandardagents/-/blob/main/spec/ossa-schema.yaml): Complete agent definition schema with capabilities, triggers, and outputs
 - [AgentFlow Lifecycle](https://gitlab.com/blueflyio/openstandardagents/-/wikis/AgentFlow-Lifecycle): 9-state workflow (Triage → To Do → In Progress → Done/Canceled)
 - [Custom Fields](https://gitlab.com/blueflyio/openstandardagents/-/wikis/Custom-Field-Enforcement): 8 fields for agent coordination (agent_assigned, agent_status, commit_type, priority, release_type)
 - [Bot Waves](https://gitlab.com/blueflyio/openstandardagents/-/wikis/Specialized-Bot-Deployment): 5-wave orchestration model for parallel agent execution

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "exports": {
-    "./schema": "./spec/v0.2.8/ossa-0.2.8.schema.json",
+    "./schema": "./spec/v0.2.9/ossa-0.2.9.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -102,7 +102,9 @@
     "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"
+    "sync:list": "tsx src/cli/commands/github-sync.command.ts list",
+    "compliance:audit": "tsx scripts/compliance-audit.ts",
+    "compliance:audit:project": "tsx scripts/compliance-audit.ts"
   },
   "keywords": [
     "ossa",

package/scripts/README.md

@@ -4,6 +4,31 @@ Automated validation and maintenance scripts for OSSA.
 
 ## Scripts
 
+### compliance-audit.ts
+
+Automated GitLab Ultimate compliance audit system. Checks projects for:
+- Branch protection (main/development, force push)
+- Merge request approvals and requirements
+- Security scanning (SAST, dependency scanning, secret detection)
+- DORA metrics configuration
+- Compliance frameworks and merge trains
+- Pipeline configuration and success rates
+
+```bash
+# Audit default project
+npm run compliance:audit
+
+# Audit specific project
+npm run compliance:audit:project blueflyio/other-project
+
+# Direct execution with custom output
+tsx scripts/compliance-audit.ts blueflyio/openstandardagents report.json
+```
+
+**Requirements**: `GITLAB_TOKEN` environment variable
+
+**Output**: Console report + JSON file with detailed compliance status
+
 ### validate-all.js
 
 Comprehensive validation suite: