@bluefly/openstandardagents 0.3.6 → 0.4.0

package/dist/version-management/core/version-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.js","sourceRoot":"","sources":["../../../src/version-management/core/version-manager.ts"],"names":[],"mappings":"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"}

package/dist/version-management/core/version-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version-manager.test.d.ts.map

package/dist/version-management/core/version-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.test.d.ts","sourceRoot":"","sources":["../../../src/version-management/core/version-manager.test.ts"],"names":[],"mappings":""}

package/dist/version-management/core/version-manager.test.js

@@ -0,0 +1,210 @@
+import { VersionManager } from './version-manager';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+describe('VersionManager', () => {
+    let versionManager;
+    let tempDir;
+    beforeEach(async () => {
+        versionManager = new VersionManager();
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ossa-version-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    describe('validate', () => {
+        it('should validate correct semantic versions', () => {
+            const testCases = [
+                '0.4.2',
+                'v0.4.2',
+                '1.2.3',
+                '1.2.3-alpha.1',
+                '2.0.0-rc.1+build.123',
+            ];
+            testCases.forEach((version) => {
+                const result = versionManager.validate(version);
+                expect(result.valid).toBe(true);
+                expect(result.success).toBe(true);
+                expect(result.parsed).toBeDefined();
+            });
+        });
+        it('should reject invalid semantic versions', () => {
+            const testCases = ['0.4', '1.2.3.4', 'latest', 'v1', 'invalid'];
+            testCases.forEach((version) => {
+                const result = versionManager.validate(version);
+                expect(result.valid).toBe(false);
+                expect(result.errors).toBeDefined();
+            });
+        });
+        it('should parse version components correctly', () => {
+            const result = versionManager.validate('1.2.3-alpha.1');
+            expect(result.valid).toBe(true);
+            expect(result.parsed).toEqual({
+                major: 1,
+                minor: 2,
+                patch: 3,
+                prerelease: 'alpha.1',
+                build: undefined,
+            });
+        });
+    });
+    describe('bump', () => {
+        it('should bump major version', () => {
+            const result = versionManager.bump('0.4.2', 'major');
+            expect(result.success).toBe(true);
+            expect(result.oldVersion).toBe('0.4.2');
+            expect(result.newVersion).toBe('1.0.0');
+            expect(result.bumpType).toBe('major');
+        });
+        it('should bump minor version', () => {
+            const result = versionManager.bump('0.4.2', 'minor');
+            expect(result.success).toBe(true);
+            expect(result.newVersion).toBe('0.5.0');
+        });
+        it('should bump patch version', () => {
+            const result = versionManager.bump('0.4.2', 'patch');
+            expect(result.success).toBe(true);
+            expect(result.newVersion).toBe('0.4.3');
+        });
+        it('should bump to prerelease', () => {
+            const result = versionManager.bump('0.4.2', 'prerelease', 'alpha');
+            expect(result.success).toBe(true);
+            expect(result.newVersion).toBe('0.4.3-alpha.0');
+        });
+        it('should handle versions with v prefix', () => {
+            const result = versionManager.bump('v0.4.2', 'patch');
+            expect(result.success).toBe(true);
+            expect(result.oldVersion).toBe('0.4.2');
+            expect(result.newVersion).toBe('0.4.3');
+        });
+    });
+    describe('substitute', () => {
+        it('should replace placeholders in files', async () => {
+            // Create test files
+            const testFile1 = path.join(tempDir, 'test1.md');
+            const testFile2 = path.join(tempDir, 'test2.json');
+            await fs.writeFile(testFile1, '# Version {{VERSION}}\n\nThis is version {{VERSION}} of the project.');
+            await fs.writeFile(testFile2, JSON.stringify({
+                apiVersion: 'ossa/v{{VERSION}}',
+                version: '{{VERSION}}',
+            }));
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md', '**/*.json'],
+                cwd: tempDir,
+            });
+            expect(result.success).toBe(true);
+            expect(result.versionUsed).toBe('v0.4.2');
+            expect(result.filesProcessed).toBe(2);
+            expect(result.replacementsMade).toBe(4);
+            // Verify file contents
+            const content1 = await fs.readFile(testFile1, 'utf-8');
+            expect(content1).toContain('# Version v0.4.2');
+            expect(content1).toContain('This is version v0.4.2 of the project.');
+            const content2 = await fs.readFile(testFile2, 'utf-8');
+            const json = JSON.parse(content2);
+            expect(json.apiVersion).toBe('ossa/vv0.4.2');
+            expect(json.version).toBe('v0.4.2');
+        });
+        it('should support dry run mode', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, '# Version {{VERSION}}');
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                cwd: tempDir,
+                dryRun: true,
+            });
+            expect(result.success).toBe(true);
+            expect(result.dryRun).toBe(true);
+            expect(result.replacementsMade).toBe(1);
+            // Verify file was NOT modified
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('# Version {{VERSION}}');
+        });
+        it('should handle custom placeholders', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, '# Version $VERSION');
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                cwd: tempDir,
+                placeholder: '$VERSION',
+            });
+            expect(result.success).toBe(true);
+            expect(result.replacementsMade).toBe(1);
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('# Version v0.4.2');
+        });
+        it('should respect exclude patterns', async () => {
+            // Create files
+            const includedFile = path.join(tempDir, 'included.md');
+            const excludedDir = path.join(tempDir, 'node_modules');
+            await fs.mkdir(excludedDir);
+            const excludedFile = path.join(excludedDir, 'excluded.md');
+            await fs.writeFile(includedFile, '{{VERSION}}');
+            await fs.writeFile(excludedFile, '{{VERSION}}');
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                exclude: ['node_modules/**'],
+                cwd: tempDir,
+            });
+            expect(result.filesProcessed).toBe(1);
+            expect(result.replacementsMade).toBe(1);
+            // Verify excluded file was NOT modified
+            const excludedContent = await fs.readFile(excludedFile, 'utf-8');
+            expect(excludedContent).toBe('{{VERSION}}');
+        });
+    });
+    describe('restore', () => {
+        it('should restore specific version to placeholder', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, '# Version v0.4.2\n\nThis is v0.4.2.');
+            const result = await versionManager.restore({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                cwd: tempDir,
+            });
+            expect(result.success).toBe(true);
+            expect(result.replacementsMade).toBe(2);
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('# Version {{VERSION}}\n\nThis is {{VERSION}}.');
+        });
+        it('should restore all versions to placeholder', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, 'v0.4.2, v0.4.1, v1.0.0, and even 2.3.4');
+            const result = await versionManager.restore({
+                restoreAll: true,
+                paths: ['**/*.md'],
+                cwd: tempDir,
+            });
+            expect(result.success).toBe(true);
+            expect(result.replacementsMade).toBe(4);
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('{{VERSION}}, {{VERSION}}, {{VERSION}}, and even {{VERSION}}');
+        });
+    });
+    describe('detect', () => {
+        it('should detect version from package.json', async () => {
+            const packageJson = path.join(tempDir, 'package.json');
+            await fs.writeFile(packageJson, JSON.stringify({ name: 'test', version: '0.4.2' }));
+            const result = await versionManager.detect({ directory: tempDir });
+            expect(result.success).toBe(true);
+            expect(result.version).toBe('0.4.2');
+            expect(result.source).toBe('package_json');
+        });
+        it('should detect version from VERSION file', async () => {
+            const versionFile = path.join(tempDir, 'VERSION');
+            await fs.writeFile(versionFile, 'v0.4.2\n');
+            const result = await versionManager.detect({ directory: tempDir });
+            expect(result.success).toBe(true);
+            expect(result.version).toBe('v0.4.2');
+            expect(result.source).toBe('VERSION_file');
+        });
+        it('should throw error when no version found', async () => {
+            await expect(versionManager.detect({ directory: tempDir })).rejects.toThrow('Could not detect version from any source');
+        });
+    });
+});
+//# sourceMappingURL=version-manager.test.js.map

package/dist/version-management/core/version-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.test.js","sourceRoot":"","sources":["../../../src/version-management/core/version-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/version-management/index.d.ts

@@ -0,0 +1,3 @@
+export { VersionManager } from './core/version-manager';
+export type { SubstituteOptions, RestoreOptions, DetectOptions, FileResult, SubstituteResult, RestoreResult, DetectResult, ValidateResult, BumpResult, VersionSource, BumpType, } from './core/version-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/version-management/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version-management/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,EACb,QAAQ,GACT,MAAM,wBAAwB,CAAC"}

package/dist/version-management/index.js

@@ -0,0 +1,2 @@
+export { VersionManager } from './core/version-manager';
+//# sourceMappingURL=index.js.map

package/dist/version-management/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/version-management/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/openapi/agent-crud.yaml

@@ -719,9 +719,9 @@ components:
           type: string
 
     AgentType:
-      $ref: '../schemas/common/agent.yaml#/components/schemas/AgentType'
+      $ref: './schemas/common/agent.yaml#/components/schemas/AgentType'
     AgentStatus:
-      $ref: '../schemas/common/agent.yaml#/components/schemas/AgentStatus'
+      $ref: './schemas/common/agent.yaml#/components/schemas/AgentStatus'
 
     AgentMetrics:
       type: object
@@ -745,7 +745,7 @@ components:
 
     # Error Schemas (RFC7807) - Using shared schema
     Problem:
-      $ref: '../schemas/common/errors.yaml#/components/schemas/Problem'
+      $ref: './schemas/common/errors.yaml#/components/schemas/Problem'
 
   responses:
     BadRequest:

package/openapi/agent-taxonomy.yaml

@@ -0,0 +1,323 @@
+openapi: 3.1.0
+info:
+  title: OSSA Agent Taxonomy API
+  version: 0.3.6
+  description: |
+    Agent classification and taxonomy system for OSSA v0.3.x.
+    Provides hierarchical categorization of agents by:
+    - Primary role (analyzer, executor, coordinator, reviewer)
+    - Domain expertise (devops, security, data, ml, etc.)
+    - Capability level (tier_1_read, tier_2_write, tier_3_full, tier_4_policy)
+    - Runtime environment (kubernetes, docker, serverless, local)
+
+servers:
+  - url: http://localhost:3000/api/v1
+    description: Local development
+
+paths:
+  /taxonomy/categories:
+    get:
+      summary: List all taxonomy categories
+      operationId: listTaxonomyCategories
+      tags: [Taxonomy]
+      responses:
+        '200':
+          description: List of taxonomy categories
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  categories:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/TaxonomyCategory'
+                  total:
+                    type: integer
+
+  /taxonomy/categories/{categoryId}:
+    get:
+      summary: Get category by ID
+      operationId: getTaxonomyCategory
+      tags: [Taxonomy]
+      parameters:
+        - name: categoryId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Taxonomy category details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxonomyCategory'
+        '404':
+          description: Category not found
+
+    put:
+      summary: Update category
+      operationId: updateTaxonomyCategory
+      tags: [Taxonomy]
+      parameters:
+        - name: categoryId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TaxonomyCategoryInput'
+      responses:
+        '200':
+          description: Category updated
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxonomyCategory'
+
+    delete:
+      summary: Delete category
+      operationId: deleteTaxonomyCategory
+      tags: [Taxonomy]
+      parameters:
+        - name: categoryId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Category deleted
+        '404':
+          description: Category not found
+
+  /taxonomy/categories:
+    post:
+      summary: Create new category
+      operationId: createTaxonomyCategory
+      tags: [Taxonomy]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TaxonomyCategoryInput'
+      responses:
+        '201':
+          description: Category created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxonomyCategory'
+
+  /taxonomy/classify:
+    post:
+      summary: Classify an agent manifest
+      operationId: classifyAgent
+      tags: [Taxonomy]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                manifest:
+                  type: object
+                  description: OSSA agent manifest to classify
+      responses:
+        '200':
+          description: Classification result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentClassification'
+
+  /taxonomy/validate:
+    post:
+      summary: Validate taxonomy assignment
+      operationId: validateTaxonomy
+      tags: [Taxonomy]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                categoryId:
+                  type: string
+                manifest:
+                  type: object
+      responses:
+        '200':
+          description: Validation result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ValidationResult'
+
+components:
+  schemas:
+    TaxonomyCategory:
+      type: object
+      required:
+        - id
+        - name
+        - type
+        - level
+        - created_at
+        - updated_at
+      properties:
+        id:
+          type: string
+          format: uuid
+          description: Unique category identifier
+        name:
+          type: string
+          description: Category name (e.g., "DevOps Automation", "Security Analysis")
+        description:
+          type: string
+          description: Category description
+        type:
+          type: string
+          enum: [role, domain, capability, runtime, custom]
+          description: Category type
+        level:
+          type: integer
+          minimum: 1
+          maximum: 5
+          description: Hierarchy level (1=top, 5=most specific)
+        parent_id:
+          type: string
+          format: uuid
+          nullable: true
+          description: Parent category ID for hierarchical taxonomy
+        metadata:
+          type: object
+          additionalProperties: true
+          description: Additional category metadata
+        tags:
+          type: array
+          items:
+            type: string
+          description: Category tags for search/filter
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+
+    TaxonomyCategoryInput:
+      type: object
+      required:
+        - name
+        - type
+        - level
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        type:
+          type: string
+          enum: [role, domain, capability, runtime, custom]
+        level:
+          type: integer
+          minimum: 1
+          maximum: 5
+        parent_id:
+          type: string
+          format: uuid
+          nullable: true
+        metadata:
+          type: object
+          additionalProperties: true
+        tags:
+          type: array
+          items:
+            type: string
+
+    AgentClassification:
+      type: object
+      required:
+        - agent_id
+        - classifications
+        - confidence
+      properties:
+        agent_id:
+          type: string
+          description: Agent identifier
+        classifications:
+          type: array
+          items:
+            type: object
+            properties:
+              category_id:
+                type: string
+                format: uuid
+              category_name:
+                type: string
+              confidence:
+                type: number
+                format: float
+                minimum: 0
+                maximum: 1
+              reason:
+                type: string
+        confidence:
+          type: number
+          format: float
+          minimum: 0
+          maximum: 1
+          description: Overall classification confidence
+        suggested_categories:
+          type: array
+          items:
+            type: string
+          description: Suggested categories based on manifest analysis
+
+    ValidationResult:
+      type: object
+      required:
+        - valid
+        - category_id
+      properties:
+        valid:
+          type: boolean
+          description: Whether taxonomy assignment is valid
+        category_id:
+          type: string
+          format: uuid
+        errors:
+          type: array
+          items:
+            type: object
+            properties:
+              field:
+                type: string
+              message:
+                type: string
+              severity:
+                type: string
+                enum: [error, warning, info]
+        warnings:
+          type: array
+          items:
+            type: object
+            properties:
+              field:
+                type: string
+              message:
+                type: string
+        recommendations:
+          type: array
+          items:
+            type: string
+          description: Recommendations for improving taxonomy fit