@defai.digital/automatosx 12.8.7 → 13.1.3

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.
Files changed (130) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +48 -754
  3. package/dist/bin.d.ts +8 -0
  4. package/dist/bin.d.ts.map +1 -0
  5. package/dist/bin.js +16 -0
  6. package/dist/bin.js.map +1 -0
  7. package/dist/index.d.ts +8 -2
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +7 -74239
  10. package/dist/index.js.map +1 -0
  11. package/package.json +35 -160
  12. package/.github/assets/ax-cli.png +0 -0
  13. package/.github/assets/axlogo.png +0 -0
  14. package/CHANGELOG.md +0 -81
  15. package/SECURITY.md +0 -173
  16. package/dist/mcp/index.d.ts +0 -2
  17. package/dist/mcp/index.js +0 -43627
  18. package/examples/AGENTS_INFO.md +0 -187
  19. package/examples/README.md +0 -434
  20. package/examples/abilities/accessibility.md +0 -115
  21. package/examples/abilities/api-design.md +0 -168
  22. package/examples/abilities/best-practices.md +0 -102
  23. package/examples/abilities/caching-strategy.md +0 -165
  24. package/examples/abilities/ci-cd.md +0 -61
  25. package/examples/abilities/clean-code.md +0 -398
  26. package/examples/abilities/code-generation.md +0 -333
  27. package/examples/abilities/code-review.md +0 -51
  28. package/examples/abilities/component-architecture.md +0 -112
  29. package/examples/abilities/content-creation.md +0 -97
  30. package/examples/abilities/data-modeling.md +0 -171
  31. package/examples/abilities/data-validation.md +0 -50
  32. package/examples/abilities/db-modeling.md +0 -167
  33. package/examples/abilities/debugging.md +0 -52
  34. package/examples/abilities/design-patterns.md +0 -437
  35. package/examples/abilities/design-system-implementation.md +0 -126
  36. package/examples/abilities/documentation.md +0 -54
  37. package/examples/abilities/etl-pipelines.md +0 -44
  38. package/examples/abilities/feasibility-study.md +0 -20
  39. package/examples/abilities/general-assistance.md +0 -26
  40. package/examples/abilities/idea-evaluation.md +0 -21
  41. package/examples/abilities/infra-as-code.md +0 -57
  42. package/examples/abilities/job-orchestration.md +0 -44
  43. package/examples/abilities/literature-review.md +0 -19
  44. package/examples/abilities/longform-report.md +0 -25
  45. package/examples/abilities/mathematical-reasoning.md +0 -170
  46. package/examples/abilities/observability.md +0 -61
  47. package/examples/abilities/orbital-mechanics.md +0 -50
  48. package/examples/abilities/our-architecture-decisions.md +0 -180
  49. package/examples/abilities/our-code-review-checklist.md +0 -149
  50. package/examples/abilities/our-coding-standards.md +0 -369
  51. package/examples/abilities/our-project-structure.md +0 -183
  52. package/examples/abilities/performance.md +0 -89
  53. package/examples/abilities/problem-solving.md +0 -50
  54. package/examples/abilities/propulsion-systems.md +0 -50
  55. package/examples/abilities/quantum-algorithm-design.md +0 -54
  56. package/examples/abilities/quantum-error-correction.md +0 -56
  57. package/examples/abilities/quantum-frameworks-transpilation.md +0 -53
  58. package/examples/abilities/quantum-noise-modeling.md +0 -58
  59. package/examples/abilities/refactoring.md +0 -223
  60. package/examples/abilities/release-strategy.md +0 -58
  61. package/examples/abilities/secrets-policy.md +0 -61
  62. package/examples/abilities/secure-coding-review.md +0 -60
  63. package/examples/abilities/software-architecture.md +0 -394
  64. package/examples/abilities/solid-principles.md +0 -341
  65. package/examples/abilities/sql-optimization.md +0 -84
  66. package/examples/abilities/state-management.md +0 -96
  67. package/examples/abilities/task-planning.md +0 -65
  68. package/examples/abilities/technical-writing.md +0 -77
  69. package/examples/abilities/telemetry-diagnostics.md +0 -51
  70. package/examples/abilities/testing.md +0 -56
  71. package/examples/abilities/threat-modeling.md +0 -58
  72. package/examples/abilities/troubleshooting.md +0 -80
  73. package/examples/abilities/typescript-zod-validation.md +0 -830
  74. package/examples/agents/AGENTS_INTEGRATION.md +0 -99
  75. package/examples/agents/aerospace-scientist.yaml +0 -159
  76. package/examples/agents/architecture.yaml +0 -244
  77. package/examples/agents/automatosx.config.json +0 -286
  78. package/examples/agents/backend.yaml +0 -141
  79. package/examples/agents/ceo.yaml +0 -105
  80. package/examples/agents/creative-marketer.yaml +0 -173
  81. package/examples/agents/cto.yaml +0 -118
  82. package/examples/agents/data-scientist.yaml +0 -200
  83. package/examples/agents/data.yaml +0 -106
  84. package/examples/agents/design.yaml +0 -115
  85. package/examples/agents/devops.yaml +0 -124
  86. package/examples/agents/frontend.yaml +0 -171
  87. package/examples/agents/fullstack.yaml +0 -172
  88. package/examples/agents/mobile.yaml +0 -185
  89. package/examples/agents/product.yaml +0 -103
  90. package/examples/agents/quality.yaml +0 -117
  91. package/examples/agents/quantum-engineer.yaml +0 -166
  92. package/examples/agents/researcher.yaml +0 -122
  93. package/examples/agents/security.yaml +0 -115
  94. package/examples/agents/standard.yaml +0 -214
  95. package/examples/agents/writer.yaml +0 -122
  96. package/examples/providers/README.md +0 -117
  97. package/examples/providers/claude/CLAUDE_INTEGRATION.md +0 -302
  98. package/examples/providers/claude/mcp/automatosx.json +0 -244
  99. package/examples/providers/codex/CODEX_INTEGRATION.md +0 -593
  100. package/examples/providers/codex/README.md +0 -349
  101. package/examples/providers/codex/usage-examples.ts +0 -421
  102. package/examples/providers/gemini/GEMINI_INTEGRATION.md +0 -236
  103. package/examples/providers/gemini/README.md +0 -76
  104. package/examples/providers/openai-codex-example.ts +0 -421
  105. package/examples/pytorch_resnet50_training.py +0 -289
  106. package/examples/specs/automatosx-release.ax.yaml +0 -380
  107. package/examples/specs/enterprise.ax.yaml +0 -121
  108. package/examples/specs/enterprise.yaml.mustache +0 -121
  109. package/examples/specs/government.ax.yaml +0 -148
  110. package/examples/specs/government.yaml.mustache +0 -148
  111. package/examples/specs/minimal.ax.yaml +0 -21
  112. package/examples/specs/minimal.yaml.mustache +0 -21
  113. package/examples/teams/business.yaml +0 -56
  114. package/examples/teams/core.yaml +0 -60
  115. package/examples/teams/design.yaml +0 -58
  116. package/examples/teams/engineering.yaml +0 -69
  117. package/examples/teams/research.yaml +0 -56
  118. package/examples/use-cases/01-web-app-development.md +0 -374
  119. package/examples/workflows/analyst.yaml +0 -60
  120. package/examples/workflows/assistant.yaml +0 -48
  121. package/examples/workflows/basic-agent.yaml +0 -28
  122. package/examples/workflows/code-reviewer.yaml +0 -52
  123. package/examples/workflows/debugger.yaml +0 -63
  124. package/examples/workflows/designer.yaml +0 -69
  125. package/examples/workflows/developer.yaml +0 -60
  126. package/examples/workflows/fullstack-developer.yaml +0 -395
  127. package/examples/workflows/qa-specialist.yaml +0 -71
  128. package/schema/ability-metadata.json +0 -21
  129. package/schema/config.json +0 -703
  130. 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