@nomad-e/bluma-cli 0.1.13 → 0.1.16

package/dist/skills/testing/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: testing
+description: Testing expert. Writes and runs tests with Jest and React Testing Library.
+version: 1.0.0
+author: NomadEngenuity
+license: LICENSE.txt
+tools:
+  required:
+    - shell_command
+    - command_status
+    - message
+  recommended:
+    - read_file_lines
+    - edit_tool
+---
+
+# Instructions
+
+## Context
+You are executing the testing workflow. This skill ensures code quality through comprehensive, maintainable tests using Jest and React Testing Library.
+
+## Procedure
+
+### Step 1: Run Existing Tests
+```bash
+npm test
+```
+Check current test status before making changes.
+
+### Step 2: Analyze Code to Test
+Use `read_file_lines` to understand:
+- Function signatures
+- Component props
+- Expected behavior
+
+### Step 3: Write Tests
+Use `edit_tool` to create test file following this structure:
+```typescript
+describe('ComponentName', () => {
+  beforeEach(() => {
+    // setup
+  });
+
+  it('should do expected behavior', () => {
+    // arrange
+    // act
+    // assert
+  });
+});
+```
+
+### Step 4: Run Tests
+```bash
+npm test -- path/to/file.test.ts
+```
+Verify tests pass.
+
+### Step 5: Report Result
+- All pass: "✅ Tests passing"
+- Failures: "❌ N tests failing" + show errors
+
+## Reference: Jest Patterns
+
+### Assertions
+```typescript
+expect(value).toBe(expected);
+expect(value).toEqual(expected);
+expect(value).toBeTruthy();
+expect(array).toContain(item);
+expect(fn).toThrow();
+```
+
+### Async
+```typescript
+it('fetches data', async () => {
+  const data = await fetchData();
+  expect(data).toBeDefined();
+});
+```
+
+### Mocking
+```typescript
+jest.mock('./module');
+jest.spyOn(object, 'method');
+jest.fn().mockReturnValue(value);
+```
+
+## Reference: React Testing Library
+
+### Query Priority
+1. getByRole
+2. getByLabelText
+3. getByPlaceholderText
+4. getByText
+5. getByTestId
+
+### Component Test
+```typescript
+import { render, screen, fireEvent } from '@testing-library/react';
+
+it('handles click', () => {
+  render(<Button onClick={handleClick}>Click</Button>);
+  fireEvent.click(screen.getByRole('button'));
+  expect(handleClick).toHaveBeenCalled();
+});
+```
+
+## Error Reference
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| Cannot find module | Missing dependency | `npm install` |
+| Timeout | Async not awaited | Add `async/await` |
+| Not wrapped in act | State update | Wrap in `act()` |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nomad-e/bluma-cli",
-	"version": "0.1.13",
+	"version": "0.1.16",
 	"description": "BluMa independent agent for automation and advanced software engineering.",
 	"author": "Alex Fonseca",
 	"license": "Apache-2.0",
@@ -31,7 +31,7 @@
 	"main": "dist/main.js",
 	"scripts": {
 		"build": "node scripts/build.js",
-		"start": "node dist/main.js",
+		"start": "node scripts/build.js && clear && node dist/main.js",
 		"test": "jest",
 		"test:watch": "jest --watch",
 		"lint": "eslint src --ext .ts,.tsx",