@defai.digital/automatosx 12.8.7 → 13.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/dist/bin.d.ts +8 -0
- package/dist/bin.d.ts.map +1 -0
- package/dist/bin.js +16 -0
- package/dist/bin.js.map +1 -0
- package/dist/index.d.ts +8 -2
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +7 -74239
- package/dist/index.js.map +1 -0
- package/package.json +35 -160
- package/.github/assets/ax-cli.png +0 -0
- package/.github/assets/axlogo.png +0 -0
- package/CHANGELOG.md +0 -81
- package/README.md +0 -790
- package/SECURITY.md +0 -173
- package/dist/mcp/index.d.ts +0 -2
- package/dist/mcp/index.js +0 -43627
- package/examples/AGENTS_INFO.md +0 -187
- package/examples/README.md +0 -434
- package/examples/abilities/accessibility.md +0 -115
- package/examples/abilities/api-design.md +0 -168
- package/examples/abilities/best-practices.md +0 -102
- package/examples/abilities/caching-strategy.md +0 -165
- package/examples/abilities/ci-cd.md +0 -61
- package/examples/abilities/clean-code.md +0 -398
- package/examples/abilities/code-generation.md +0 -333
- package/examples/abilities/code-review.md +0 -51
- package/examples/abilities/component-architecture.md +0 -112
- package/examples/abilities/content-creation.md +0 -97
- package/examples/abilities/data-modeling.md +0 -171
- package/examples/abilities/data-validation.md +0 -50
- package/examples/abilities/db-modeling.md +0 -167
- package/examples/abilities/debugging.md +0 -52
- package/examples/abilities/design-patterns.md +0 -437
- package/examples/abilities/design-system-implementation.md +0 -126
- package/examples/abilities/documentation.md +0 -54
- package/examples/abilities/etl-pipelines.md +0 -44
- package/examples/abilities/feasibility-study.md +0 -20
- package/examples/abilities/general-assistance.md +0 -26
- package/examples/abilities/idea-evaluation.md +0 -21
- package/examples/abilities/infra-as-code.md +0 -57
- package/examples/abilities/job-orchestration.md +0 -44
- package/examples/abilities/literature-review.md +0 -19
- package/examples/abilities/longform-report.md +0 -25
- package/examples/abilities/mathematical-reasoning.md +0 -170
- package/examples/abilities/observability.md +0 -61
- package/examples/abilities/orbital-mechanics.md +0 -50
- package/examples/abilities/our-architecture-decisions.md +0 -180
- package/examples/abilities/our-code-review-checklist.md +0 -149
- package/examples/abilities/our-coding-standards.md +0 -369
- package/examples/abilities/our-project-structure.md +0 -183
- package/examples/abilities/performance.md +0 -89
- package/examples/abilities/problem-solving.md +0 -50
- package/examples/abilities/propulsion-systems.md +0 -50
- package/examples/abilities/quantum-algorithm-design.md +0 -54
- package/examples/abilities/quantum-error-correction.md +0 -56
- package/examples/abilities/quantum-frameworks-transpilation.md +0 -53
- package/examples/abilities/quantum-noise-modeling.md +0 -58
- package/examples/abilities/refactoring.md +0 -223
- package/examples/abilities/release-strategy.md +0 -58
- package/examples/abilities/secrets-policy.md +0 -61
- package/examples/abilities/secure-coding-review.md +0 -60
- package/examples/abilities/software-architecture.md +0 -394
- package/examples/abilities/solid-principles.md +0 -341
- package/examples/abilities/sql-optimization.md +0 -84
- package/examples/abilities/state-management.md +0 -96
- package/examples/abilities/task-planning.md +0 -65
- package/examples/abilities/technical-writing.md +0 -77
- package/examples/abilities/telemetry-diagnostics.md +0 -51
- package/examples/abilities/testing.md +0 -56
- package/examples/abilities/threat-modeling.md +0 -58
- package/examples/abilities/troubleshooting.md +0 -80
- package/examples/abilities/typescript-zod-validation.md +0 -830
- package/examples/agents/AGENTS_INTEGRATION.md +0 -99
- package/examples/agents/aerospace-scientist.yaml +0 -159
- package/examples/agents/architecture.yaml +0 -244
- package/examples/agents/automatosx.config.json +0 -286
- package/examples/agents/backend.yaml +0 -141
- package/examples/agents/ceo.yaml +0 -105
- package/examples/agents/creative-marketer.yaml +0 -173
- package/examples/agents/cto.yaml +0 -118
- package/examples/agents/data-scientist.yaml +0 -200
- package/examples/agents/data.yaml +0 -106
- package/examples/agents/design.yaml +0 -115
- package/examples/agents/devops.yaml +0 -124
- package/examples/agents/frontend.yaml +0 -171
- package/examples/agents/fullstack.yaml +0 -172
- package/examples/agents/mobile.yaml +0 -185
- package/examples/agents/product.yaml +0 -103
- package/examples/agents/quality.yaml +0 -117
- package/examples/agents/quantum-engineer.yaml +0 -166
- package/examples/agents/researcher.yaml +0 -122
- package/examples/agents/security.yaml +0 -115
- package/examples/agents/standard.yaml +0 -214
- package/examples/agents/writer.yaml +0 -122
- package/examples/providers/README.md +0 -117
- package/examples/providers/claude/CLAUDE_INTEGRATION.md +0 -302
- package/examples/providers/claude/mcp/automatosx.json +0 -244
- package/examples/providers/codex/CODEX_INTEGRATION.md +0 -593
- package/examples/providers/codex/README.md +0 -349
- package/examples/providers/codex/usage-examples.ts +0 -421
- package/examples/providers/gemini/GEMINI_INTEGRATION.md +0 -236
- package/examples/providers/gemini/README.md +0 -76
- package/examples/providers/openai-codex-example.ts +0 -421
- package/examples/pytorch_resnet50_training.py +0 -289
- package/examples/specs/automatosx-release.ax.yaml +0 -380
- package/examples/specs/enterprise.ax.yaml +0 -121
- package/examples/specs/enterprise.yaml.mustache +0 -121
- package/examples/specs/government.ax.yaml +0 -148
- package/examples/specs/government.yaml.mustache +0 -148
- package/examples/specs/minimal.ax.yaml +0 -21
- package/examples/specs/minimal.yaml.mustache +0 -21
- package/examples/teams/business.yaml +0 -56
- package/examples/teams/core.yaml +0 -60
- package/examples/teams/design.yaml +0 -58
- package/examples/teams/engineering.yaml +0 -69
- package/examples/teams/research.yaml +0 -56
- package/examples/use-cases/01-web-app-development.md +0 -374
- package/examples/workflows/analyst.yaml +0 -60
- package/examples/workflows/assistant.yaml +0 -48
- package/examples/workflows/basic-agent.yaml +0 -28
- package/examples/workflows/code-reviewer.yaml +0 -52
- package/examples/workflows/debugger.yaml +0 -63
- package/examples/workflows/designer.yaml +0 -69
- package/examples/workflows/developer.yaml +0 -60
- package/examples/workflows/fullstack-developer.yaml +0 -395
- package/examples/workflows/qa-specialist.yaml +0 -71
- package/schema/ability-metadata.json +0 -21
- package/schema/config.json +0 -703
- package/schema/spec-schema.json +0 -608
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
# Testing Ability
|
|
2
|
-
|
|
3
|
-
Write comprehensive, maintainable tests for software systems.
|
|
4
|
-
|
|
5
|
-
## Test Types
|
|
6
|
-
|
|
7
|
-
1. **Unit Tests** (80% of tests)
|
|
8
|
-
- Test individual functions/methods
|
|
9
|
-
- Mock external dependencies
|
|
10
|
-
- Fast execution (<1ms per test)
|
|
11
|
-
- High coverage (80%+)
|
|
12
|
-
|
|
13
|
-
2. **Integration Tests** (15% of tests)
|
|
14
|
-
- Test component interactions
|
|
15
|
-
- Use real dependencies when possible
|
|
16
|
-
- Test critical workflows
|
|
17
|
-
- Moderate execution time
|
|
18
|
-
|
|
19
|
-
3. **End-to-End Tests** (5% of tests)
|
|
20
|
-
- Test complete user workflows
|
|
21
|
-
- Use production-like environment
|
|
22
|
-
- Test critical paths only
|
|
23
|
-
- Slower execution acceptable
|
|
24
|
-
|
|
25
|
-
## Best Practices
|
|
26
|
-
|
|
27
|
-
- **Arrange-Act-Assert** pattern
|
|
28
|
-
- One assertion per test (when possible)
|
|
29
|
-
- Clear test names (describe what is tested)
|
|
30
|
-
- Independent tests (no shared state)
|
|
31
|
-
- Fast feedback (optimize test speed)
|
|
32
|
-
|
|
33
|
-
## Test Coverage Goals
|
|
34
|
-
|
|
35
|
-
- Critical paths: 100%
|
|
36
|
-
- Business logic: 90%+
|
|
37
|
-
- UI components: 70%+
|
|
38
|
-
- Utility functions: 80%+
|
|
39
|
-
- Overall project: 80%+
|
|
40
|
-
|
|
41
|
-
## Testing Anti-Patterns to Avoid
|
|
42
|
-
|
|
43
|
-
- Testing implementation details
|
|
44
|
-
- Brittle tests (break with minor changes)
|
|
45
|
-
- Slow tests (block development)
|
|
46
|
-
- Flaky tests (non-deterministic)
|
|
47
|
-
- No tests (technical debt)
|
|
48
|
-
|
|
49
|
-
## Application Hints
|
|
50
|
-
|
|
51
|
-
When writing tests:
|
|
52
|
-
- Test behavior, not implementation details; tests should survive refactoring
|
|
53
|
-
- Prioritize critical paths and edge cases over chasing coverage percentages
|
|
54
|
-
- Keep tests independent; shared state between tests causes flaky failures
|
|
55
|
-
- Make test names describe the expected behavior, not the method being tested
|
|
56
|
-
- Fix flaky tests immediately; they erode trust in the entire test suite
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
# Threat Modeling
|
|
2
|
-
|
|
3
|
-
Identify, assess, and mitigate security threats systematically using frameworks like STRIDE to analyze attack vectors.
|
|
4
|
-
|
|
5
|
-
## STRIDE Framework
|
|
6
|
-
|
|
7
|
-
- **S**poofing: Impersonating user/system
|
|
8
|
-
- **T**ampering: Modifying data/code
|
|
9
|
-
- **R**epudiation: Denying actions
|
|
10
|
-
- **I**nformation Disclosure: Exposing sensitive data
|
|
11
|
-
- **D**enial of Service: Making system unavailable
|
|
12
|
-
- **E**levation of Privilege: Gaining unauthorized access
|
|
13
|
-
|
|
14
|
-
## Do's ✅
|
|
15
|
-
|
|
16
|
-
```markdown
|
|
17
|
-
# ✅ Good: Document threats per asset
|
|
18
|
-
## Asset: User Password
|
|
19
|
-
- Spoofing: Attacker uses stolen credentials → Mitigation: MFA
|
|
20
|
-
- Tampering: Hash modified in DB → Mitigation: Hash with bcrypt
|
|
21
|
-
- Information Disclosure: Leaked in logs → Mitigation: No passwords in logs
|
|
22
|
-
- Elevation: Admin password compromised → Mitigation: Rate limiting, complexity
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
```javascript
|
|
26
|
-
// ✅ Good: Validate and sanitize
|
|
27
|
-
const path = require('path');
|
|
28
|
-
const filename = path.basename(req.body.filename);
|
|
29
|
-
const safePath = path.join('./uploads', filename);
|
|
30
|
-
if (!safePath.startsWith('./uploads/')) {
|
|
31
|
-
return res.status(400).send('Invalid filename');
|
|
32
|
-
}
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
## Don'ts ❌
|
|
36
|
-
|
|
37
|
-
```javascript
|
|
38
|
-
// ❌ Bad: Assuming input is safe
|
|
39
|
-
const filename = req.body.filename;
|
|
40
|
-
fs.writeFile(`./uploads/${filename}`, content);
|
|
41
|
-
// What if filename = "../../etc/passwd"?
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
## Best Practices
|
|
45
|
-
- Perform threat modeling early in design
|
|
46
|
-
- Update when architecture changes
|
|
47
|
-
- Prioritize by risk (likelihood × impact)
|
|
48
|
-
- Document mitigations
|
|
49
|
-
- Review with security team
|
|
50
|
-
|
|
51
|
-
## Application Hints
|
|
52
|
-
|
|
53
|
-
When threat modeling:
|
|
54
|
-
- Identify assets and trust boundaries first before analyzing specific threats
|
|
55
|
-
- Apply STRIDE per component or data flow, not globally across the entire system
|
|
56
|
-
- Prioritize threats by (Impact × Likelihood); don't attempt to fix everything
|
|
57
|
-
- Document residual risks explicitly; security is about informed trade-offs
|
|
58
|
-
- Update the threat model when architecture changes, not just at initial design
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
# Troubleshooting Ability
|
|
2
|
-
|
|
3
|
-
Systematically diagnose and resolve technical issues.
|
|
4
|
-
|
|
5
|
-
## Troubleshooting Process
|
|
6
|
-
|
|
7
|
-
1. **Gather Information**
|
|
8
|
-
- What is the expected behavior?
|
|
9
|
-
- What actually happens?
|
|
10
|
-
- Error messages (exact text)
|
|
11
|
-
- Steps to reproduce
|
|
12
|
-
- When did it start?
|
|
13
|
-
- Recent changes
|
|
14
|
-
|
|
15
|
-
2. **Reproduce** the Issue
|
|
16
|
-
- Follow exact steps
|
|
17
|
-
- Use same environment
|
|
18
|
-
- Note any variations
|
|
19
|
-
- Document reproduction steps
|
|
20
|
-
|
|
21
|
-
3. **Isolate** the Problem
|
|
22
|
-
- Is it consistent or intermittent?
|
|
23
|
-
- Which components are affected?
|
|
24
|
-
- What works vs what doesn't?
|
|
25
|
-
- Minimum reproduction case
|
|
26
|
-
|
|
27
|
-
4. **Form Hypothesis**
|
|
28
|
-
- Based on evidence
|
|
29
|
-
- Consider multiple possibilities
|
|
30
|
-
- Most likely cause first
|
|
31
|
-
- Document reasoning
|
|
32
|
-
|
|
33
|
-
5. **Test Hypothesis**
|
|
34
|
-
- Change one variable at a time
|
|
35
|
-
- Verify results
|
|
36
|
-
- If wrong, revise hypothesis
|
|
37
|
-
- Keep track of what you've tried
|
|
38
|
-
|
|
39
|
-
6. **Implement Solution**
|
|
40
|
-
- Apply fix
|
|
41
|
-
- Test thoroughly
|
|
42
|
-
- Document solution
|
|
43
|
-
- Prevent recurrence
|
|
44
|
-
|
|
45
|
-
## Diagnostic Techniques
|
|
46
|
-
|
|
47
|
-
- **Check Logs**: Application, system, error logs
|
|
48
|
-
- **Verify Basics**: Network, permissions, disk space
|
|
49
|
-
- **Binary Search**: Disable half, narrow down
|
|
50
|
-
- **Compare Environments**: Dev vs prod differences
|
|
51
|
-
- **Monitor Resources**: CPU, memory, network
|
|
52
|
-
- **Review Recent Changes**: Git history, deployments
|
|
53
|
-
- **Test in Isolation**: Minimal setup, mock dependencies
|
|
54
|
-
|
|
55
|
-
## Common Issues Checklist
|
|
56
|
-
|
|
57
|
-
Configuration:
|
|
58
|
-
|
|
59
|
-
- [ ] Environment variables set correctly
|
|
60
|
-
- [ ] Config files in right location
|
|
61
|
-
- [ ] Paths absolute vs relative
|
|
62
|
-
|
|
63
|
-
Network:
|
|
64
|
-
|
|
65
|
-
- [ ] Firewall/security groups allow traffic
|
|
66
|
-
- [ ] DNS resolving correctly
|
|
67
|
-
- [ ] SSL certificates valid
|
|
68
|
-
- [ ] Timeouts configured appropriately
|
|
69
|
-
|
|
70
|
-
Permissions:
|
|
71
|
-
|
|
72
|
-
- [ ] File permissions correct
|
|
73
|
-
- [ ] User has necessary privileges
|
|
74
|
-
- [ ] Database permissions granted
|
|
75
|
-
|
|
76
|
-
Dependencies:
|
|
77
|
-
|
|
78
|
-
- [ ] All dependencies installed
|
|
79
|
-
- [ ] Correct versions
|
|
80
|
-
- [ ] No version conflicts
|