@defai.digital/automatosx 5.0.1

package/examples/templates/developer.yaml

@@ -0,0 +1,60 @@
+# Developer Agent Template
+# Pre-configured for software development tasks
+# Team: Engineering
+# v5.0+
+
+name: "{{AGENT_NAME}}"
+displayName: "{{DISPLAY_NAME}}"
+team: engineering
+role: "{{ROLE | default: Software Developer}}"
+description: "{{DESCRIPTION | default: Expert in software development, code review, and testing}}"
+
+# Development abilities (engineering team shared abilities will be added automatically)
+abilities:
+  - code-generation
+  - code-review
+  - debugging
+  - testing
+  # Add custom abilities here
+
+# Configuration
+temperature: 0.3  # Lower temperature for more deterministic code
+maxTokens: 4000
+
+# Orchestration
+orchestration:
+  maxDelegationDepth: 2
+  canReadWorkspaces:
+    - frontend
+    - backend
+    - database
+    - devops
+  canWriteToShared: true
+
+# System Prompt
+systemPrompt: |
+  You are {{DISPLAY_NAME}}, a {{ROLE | default: Software Developer}}.
+
+  {{DESCRIPTION | default: You are an expert software developer with deep knowledge of programming languages, frameworks, and best practices.}}
+
+  Your expertise includes:
+  - Writing clean, maintainable, and efficient code
+  - Code review and suggesting improvements
+  - Test-driven development (TDD)
+  - Debugging and troubleshooting
+  - Following coding standards and best practices
+
+  ## Multi-agent collaboration:
+  - Delegate UI/UX tasks to frontend specialists
+  - Delegate database design to data engineers
+  - Delegate infrastructure to devops engineers
+  - Delegate security audits to security specialists
+
+  ## Approach:
+  1. Understand requirements thoroughly
+  2. Design before implementing
+  3. Write tests first (TDD when appropriate)
+  4. Implement with clean code principles
+  5. Review and refactor
+
+  Communication style: Technical, precise, and collaborative

package/examples/templates/qa-specialist.yaml

@@ -0,0 +1,71 @@
+# QA Specialist Agent Template
+# Pre-configured for quality assurance and testing
+# Team: Core
+# v5.0+
+
+name: "{{AGENT_NAME}}"
+displayName: "{{DISPLAY_NAME}}"
+team: core
+role: "{{ROLE | default: QA Specialist}}"
+description: "{{DESCRIPTION | default: Expert in quality assurance, testing, and quality control}}"
+
+# QA abilities (core team shared abilities will be added automatically)
+abilities:
+  - test-planning
+  - test-automation
+  - quality-assurance
+  - bug-reporting
+  # Add custom abilities here
+
+# Configuration
+temperature: 0.2  # Very low temperature for consistent testing
+maxTokens: 4000
+
+# Orchestration
+orchestration:
+  maxDelegationDepth: 2
+  canReadWorkspaces:
+    - frontend
+    - backend
+    - database
+    - devops
+  canWriteToShared: true
+
+# System Prompt
+systemPrompt: |
+  You are {{DISPLAY_NAME}}, a {{ROLE | default: QA Specialist}}.
+
+  {{DESCRIPTION | default: You are an expert QA specialist with comprehensive knowledge of testing methodologies, quality assurance processes, and test automation.}}
+
+  Your expertise includes:
+  - Test planning and strategy
+  - Test case design and execution
+  - Automated testing (unit, integration, E2E)
+  - Performance and load testing
+  - Security testing
+  - Regression testing
+  - Bug identification and reporting
+  - Quality metrics and reporting
+
+  ## Testing principles:
+  - Thorough coverage (happy paths and edge cases)
+  - Early and continuous testing
+  - Risk-based testing prioritization
+  - Clear and reproducible bug reports
+  - Automation where beneficial
+
+  ## Multi-agent collaboration:
+  - Work with developers on test automation
+  - Collaborate with product team on acceptance criteria
+  - Delegate security testing to security specialists
+  - Coordinate with devops on CI/CD testing
+
+  ## Approach:
+  1. Understand requirements and acceptance criteria
+  2. Design comprehensive test plan
+  3. Create detailed test cases
+  4. Execute tests systematically
+  5. Document findings clearly
+  6. Verify fixes and prevent regressions
+
+  Communication style: Precise, detail-oriented, and quality-focused

package/examples/use-cases/01-web-app-development.md

@@ -0,0 +1,374 @@
+# Use Case: Web Application Development
+
+Complete workflow for building a web application with AutomatosX.
+
+## Scenario
+
+Building a task management web app with user authentication, CRUD operations, and real-time updates.
+
+## Prerequisites
+
+```bash
+# Initialize project
+mkdir task-manager
+cd task-manager
+npm init -y
+
+# Initialize AutomatosX
+automatosx init
+
+# Set up API keys
+automatosx config --set providers.claude.apiKey --value "sk-ant-..."
+```
+
+## Step 1: Project Planning
+
+```bash
+automatosx chat assistant
+
+> "I want to build a task management web app with:
+  - User authentication (JWT)
+  - Task CRUD operations
+  - Real-time updates (WebSocket)
+  - RESTful API (Express.js)
+  - React frontend
+
+  Please help me plan the architecture and tech stack."
+
+# Agent will suggest:
+# - Project structure
+# - Technology choices
+# - API design
+# - Database schema
+# - Security considerations
+```
+
+## Step 2: Backend Setup
+
+### Generate Express.js Server
+
+```bash
+automatosx run coder "Create an Express.js server with:
+- TypeScript configuration
+- Basic middleware (cors, helmet, morgan)
+- Error handling
+- Environment variables setup"
+
+# Creates:
+# - src/server.ts
+# - src/config/env.ts
+# - src/middleware/errorHandler.ts
+# - tsconfig.json
+```
+
+### Database Schema
+
+```bash
+automatosx run coder "Create Prisma schema for:
+- User model (id, email, password, name, createdAt)
+- Task model (id, title, description, status, userId, createdAt, updatedAt)
+- Relationships between User and Tasks"
+
+# Creates:
+# - prisma/schema.prisma
+# - Migration files
+```
+
+### Authentication System
+
+```bash
+automatosx run coder "Implement JWT authentication with:
+- User registration endpoint
+- Login endpoint
+- Password hashing with bcrypt
+- JWT token generation
+- Auth middleware for protected routes"
+
+# Creates:
+# - src/controllers/auth.controller.ts
+# - src/middleware/auth.middleware.ts
+# - src/utils/jwt.ts
+# - src/routes/auth.routes.ts
+```
+
+## Step 3: API Development
+
+### Task CRUD Operations
+
+```bash
+automatosx run coder "Create RESTful API for tasks:
+- GET /api/tasks - List user's tasks
+- GET /api/tasks/:id - Get single task
+- POST /api/tasks - Create task
+- PUT /api/tasks/:id - Update task
+- DELETE /api/tasks/:id - Delete task
+
+Include:
+- Request validation
+- Error handling
+- Pagination for list endpoint"
+
+# Creates:
+# - src/controllers/tasks.controller.ts
+# - src/routes/tasks.routes.ts
+# - src/validators/task.validator.ts
+```
+
+## Step 4: Code Review
+
+```bash
+# Review authentication logic
+automatosx run reviewer "Review src/controllers/auth.controller.ts for:
+- Security vulnerabilities
+- Error handling
+- Best practices"
+
+# Review API endpoints
+automatosx run reviewer "Review src/routes/ directory for:
+- RESTful design
+- Validation
+- Error responses"
+```
+
+## Step 5: Testing
+
+### Unit Tests
+
+```bash
+automatosx run coder "Create unit tests for authentication controller using Jest:
+- Test user registration with valid data
+- Test registration with existing email
+- Test login with valid credentials
+- Test login with invalid credentials
+- Test JWT token generation"
+
+# Creates:
+# - src/controllers/__tests__/auth.controller.test.ts
+```
+
+### Integration Tests
+
+```bash
+automatosx run coder "Create integration tests for task API:
+- Test creating task (authenticated)
+- Test listing tasks (authenticated)
+- Test updating task (owner only)
+- Test deleting task (owner only)
+- Test 401 for unauthenticated requests"
+
+# Creates:
+# - src/routes/__tests__/tasks.routes.test.ts
+```
+
+## Step 6: Frontend Development
+
+### React Components
+
+```bash
+automatosx run coder "Create React components for task management:
+- TaskList component with pagination
+- TaskItem component with edit/delete actions
+- TaskForm component for create/edit
+- Include TypeScript types
+- Use React hooks (useState, useEffect)"
+
+# Creates:
+# - src/components/TaskList.tsx
+# - src/components/TaskItem.tsx
+# - src/components/TaskForm.tsx
+# - src/types/task.ts
+```
+
+### Authentication UI
+
+```bash
+automatosx run coder "Create authentication components:
+- LoginForm with email/password validation
+- RegisterForm with password confirmation
+- Protected route wrapper
+- Auth context for global state"
+
+# Creates:
+# - src/components/auth/LoginForm.tsx
+# - src/components/auth/RegisterForm.tsx
+# - src/contexts/AuthContext.tsx
+# - src/components/ProtectedRoute.tsx
+```
+
+## Step 7: WebSocket Integration
+
+```bash
+automatosx run coder "Add WebSocket support for real-time task updates:
+- Socket.io server setup
+- Emit events on task create/update/delete
+- Client-side socket connection
+- Auto-update UI on socket events"
+
+# Creates:
+# - src/socket/server.ts
+# - src/socket/client.ts
+# - Event handlers
+```
+
+## Step 8: Documentation
+
+```bash
+# API Documentation
+automatosx run writer "Create API documentation for all endpoints:
+- Authentication endpoints
+- Task endpoints
+- Request/response examples
+- Error codes
+- Use OpenAPI/Swagger format"
+
+# Creates:
+# - docs/api.md
+# - swagger.yaml
+
+# Setup Guide
+automatosx run writer "Create development setup guide including:
+- Prerequisites
+- Installation steps
+- Environment variables
+- Database setup
+- Running the app
+- Running tests"
+
+# Creates:
+# - docs/setup.md
+```
+
+## Step 9: Debugging
+
+```bash
+# If you encounter errors:
+automatosx run debugger "I'm getting this error when creating a task:
+Error: Cannot read property 'userId' of undefined
+at createTask (src/controllers/tasks.controller.ts:45)"
+
+# Agent will:
+# - Analyze the error
+# - Identify the root cause
+# - Suggest fixes
+# - Provide code corrections
+```
+
+## Step 10: Deployment Preparation
+
+```bash
+# Environment Configuration
+automatosx run coder "Create production-ready configuration:
+- Separate dev/prod configs
+- Docker Compose setup
+- Environment variables validation
+- Health check endpoint
+- Graceful shutdown"
+
+# Creates:
+# - docker-compose.yml
+# - Dockerfile
+# - .env.example
+# - src/health.ts
+
+# Deployment Guide
+automatosx run writer "Create deployment guide for:
+- Docker deployment
+- Environment setup
+- Database migrations
+- SSL/TLS configuration
+- Monitoring and logging"
+
+# Creates:
+# - docs/deployment.md
+```
+
+## Complete Project Structure
+
+After following this workflow, you'll have:
+
+```
+task-manager/
+├── src/
+│   ├── server.ts
+│   ├── config/
+│   ├── controllers/
+│   ├── middleware/
+│   ├── routes/
+│   ├── validators/
+│   ├── socket/
+│   ├── components/
+│   └── types/
+├── prisma/
+│   └── schema.prisma
+├── docs/
+│   ├── api.md
+│   ├── setup.md
+│   └── deployment.md
+├── tests/
+├── docker-compose.yml
+├── Dockerfile
+└── package.json
+```
+
+## Tips for Success
+
+1. **Start with Planning**: Always use assistant/chat mode to plan before coding
+2. **Incremental Development**: Build one feature at a time, test, then move on
+3. **Regular Reviews**: Review code after each major component
+4. **Documentation First**: Document as you build, not after
+5. **Use Memory**: AutomatosX remembers context across sessions
+6. **Iterate**: Don't expect perfect code first time, refine iteratively
+
+## Common Issues
+
+### Agent Gives Generic Code
+
+**Problem**: Generated code is too generic
+**Solution**: Provide more context and specific requirements
+
+```bash
+# Instead of:
+automatosx run coder "Create user model"
+
+# Do this:
+automatosx run coder "Create Prisma User model with:
+- UUID primary key
+- Email (unique, validated)
+- Password (hashed with bcrypt, min 8 chars)
+- Name (required)
+- Role (enum: user, admin)
+- CreatedAt, UpdatedAt timestamps
+- Soft delete support"
+```
+
+### Code Doesn't Match Project Style
+
+**Problem**: Generated code doesn't follow your conventions
+**Solution**: Create a custom agent with style guidelines
+
+```yaml
+# .automatosx/agents/project-coder.yaml
+name: project-coder
+systemPrompt: |
+  You are a code generator for this specific project.
+
+  Code Style:
+  - Use functional components (React)
+  - Async/await (no promises)
+  - Named exports (no default)
+  - 2 spaces indentation
+  - Single quotes
+  - Trailing commas
+
+  Follow these patterns exactly when generating code.
+```
+
+## Next Steps
+
+- Explore [API Design Use Case](./02-api-design.md)
+- Learn about [Code Migration](./03-code-migration.md)
+- See [Security Audit Workflow](./04-security-audit.md)
+
+---
+
+**Questions?** Ask in [GitHub Discussions](https://github.com/defai-digital/automatosx/discussions)

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@defai.digital/automatosx",
+  "version": "5.0.1",
+  "description": "AI Agent Orchestration Platform",
+  "type": "module",
+  "bin": {
+    "automatosx": "./dist/index.js",
+    "ax": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli/index.ts",
+    "test": "npm run test:unit && npm run test:integration",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:all": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run test:all && npm run build",
+    "prepack": "npm run build",
+    "postpack": "echo '✅ Package created successfully'",
+    "version:patch": "npm version patch -m 'chore: bump version to %s'",
+    "version:minor": "npm version minor -m 'chore: bump version to %s'",
+    "version:major": "npm version major -m 'chore: bump version to %s'",
+    "version:beta": "npm version prerelease --preid=beta -m 'chore: bump version to %s'",
+    "release:check": "node scripts/check-release.js",
+    "prototype:path": "tsx tmp/phase0-prototypes/03-path-resolution-poc.ts",
+    "prototype:sqlite": "tsx tmp/phase0-prototypes/01-sqlite-vec-poc.ts",
+    "prototype:ts": "tsx tmp/phase0-prototypes/02-typescript-migration-poc.ts",
+    "prototype:provider": "tsx tmp/phase0-prototypes/04-provider-abstraction-poc.ts"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.10.0",
+    "@types/yargs": "^17.0.33",
+    "@vitest/coverage-v8": "^2.1.9",
+    "markdownlint-cli": "^0.45.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.9"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.4.1",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "find-up": "^7.0.0",
+    "js-yaml": "^4.1.0",
+    "ora": "^9.0.0",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "yargs": "^17.7.2"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "orchestration",
+    "automation",
+    "llm",
+    "claude",
+    "gemini",
+    "openai",
+    "vector-search",
+    "sqlite",
+    "typescript",
+    "ai-agents"
+  ],
+  "author": "AutomatosX Team",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git"
+  },
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "homepage": "https://automatosx.com",
+  "overrides": {
+    "esbuild": "^0.25.0"
+  }
+}