my-opencode 1.0.0 → 1.2.0

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 (36) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +180 -163
  3. package/agents/architect.md +30 -30
  4. package/agents/code-reviewer.md +29 -29
  5. package/agents/executor.md +30 -30
  6. package/agents/fullstack-dev.md +57 -53
  7. package/agents/spec-writer.md +37 -37
  8. package/agents/team-lead.md +60 -60
  9. package/agents/tech-writer.md +30 -30
  10. package/agents/test-engineer.md +30 -30
  11. package/agents/verifier.md +33 -33
  12. package/bin/cli.js +311 -272
  13. package/opencode.json +167 -164
  14. package/package.json +48 -44
  15. package/scripts/postinstall.js +182 -0
  16. package/skills/adr/SKILL.md +91 -91
  17. package/skills/adr/references/templates.md +100 -100
  18. package/skills/adr/scripts/README.md +5 -5
  19. package/skills/dev-flow/SKILL.md +188 -188
  20. package/skills/dev-flow/references/code-phase.md +72 -72
  21. package/skills/dev-flow/references/contract-phase.md +81 -81
  22. package/skills/dev-flow/references/verify-phase.md +129 -129
  23. package/skills/dev-flow/scripts/README.md +3 -3
  24. package/skills/docs-gen/SKILL.md +162 -162
  25. package/skills/docs-gen/references/doc-styles.md +216 -216
  26. package/skills/docs-gen/scripts/README.md +5 -5
  27. package/skills/orchestrate/SKILL.md +112 -112
  28. package/skills/orchestrate/references/orchestration-patterns.md +56 -56
  29. package/skills/pr-review/SKILL.md +110 -110
  30. package/skills/pr-review/references/review-dimensions.md +117 -117
  31. package/skills/pr-review/references/security-checklist.md +122 -122
  32. package/skills/pr-review/scripts/README.md +5 -5
  33. package/skills/test-gen/SKILL.md +143 -143
  34. package/skills/test-gen/references/framework-detection.md +105 -105
  35. package/skills/test-gen/references/test-patterns.md +260 -260
  36. package/skills/test-gen/scripts/README.md +5 -5
@@ -1,260 +1,260 @@
1
- # Test Patterns — Language & Framework Specific
2
-
3
- ## TypeScript / JavaScript — Vitest
4
-
5
- ### Basic structure
6
- ```typescript
7
- import { describe, it, expect, beforeEach, vi } from 'vitest'
8
- import { userService } from './userService'
9
-
10
- describe('userService', () => {
11
- beforeEach(() => {
12
- vi.restoreAllMocks()
13
- })
14
-
15
- it('should create a user with valid data', async () => {
16
- const user = await userService.create({ name: 'Alice', email: 'alice@test.com' })
17
- expect(user).toMatchObject({ name: 'Alice' })
18
- expect(user.id).toBeDefined()
19
- })
20
-
21
- it('should reject duplicate emails', async () => {
22
- await userService.create({ name: 'Alice', email: 'dup@test.com' })
23
- await expect(userService.create({ name: 'Bob', email: 'dup@test.com' }))
24
- .rejects.toThrow('Email already exists')
25
- })
26
-
27
- it('should handle empty name', async () => {
28
- await expect(userService.create({ name: '', email: 'x@test.com' }))
29
- .rejects.toThrow('Name is required')
30
- })
31
- })
32
- ```
33
-
34
- ### Mocking external dependencies
35
- ```typescript
36
- import { describe, it, expect, vi } from 'vitest'
37
- import { sendEmail } from './emailService'
38
- import { emailClient } from './emailClient'
39
-
40
- vi.mock('./emailClient')
41
-
42
- it('should send welcome email', async () => {
43
- vi.mocked(emailClient.send).mockResolvedValue({ id: 'msg_123' })
44
- const result = await sendEmail('user@test.com', 'Welcome!')
45
- expect(result.success).toBe(true)
46
- expect(emailClient.send).toHaveBeenCalledWith(
47
- expect.objectContaining({ to: 'user@test.com' })
48
- )
49
- })
50
- ```
51
-
52
- ### Parametrized tests
53
- ```typescript
54
- it.each([
55
- { input: '', expected: false },
56
- { input: 'a@b', expected: true },
57
- { input: '@b.com', expected: false },
58
- ])('should validate email: $input', ({ input, expected }) => {
59
- expect(validateEmail(input)).toBe(expected)
60
- })
61
- ```
62
-
63
- ---
64
-
65
- ## TypeScript / JavaScript — Jest
66
-
67
- Same patterns as Vitest with these differences:
68
- - `jest.mock()` instead of `vi.mock()`
69
- - `jest.fn()` instead of `vi.fn()`
70
- - No built-in `it.each` (use `test.each` or `it.each` from `@jest/globals`)
71
-
72
- ```typescript
73
- jest.mock('./emailClient')
74
- jest.spyOn(console, 'error').mockImplementation(() => {})
75
- ```
76
-
77
- ---
78
-
79
- ## Python — Pytest
80
-
81
- ### Basic structure
82
- ```python
83
- import pytest
84
- from user_service import create_user
85
-
86
- def test_create_user_with_valid_data():
87
- user = create_user(name="Alice", email="alice@test.com")
88
- assert user.name == "Alice"
89
- assert user.id is not None
90
-
91
- def test_reject_duplicate_emails():
92
- create_user(name="Alice", email="dup@test.com")
93
- with pytest.raises(ValueError, match="Email already exists"):
94
- create_user(name="Bob", email="dup@test.com")
95
-
96
- def test_handle_empty_name():
97
- with pytest.raises(ValueError, match="Name is required"):
98
- create_user(name="", email="x@test.com")
99
- ```
100
-
101
- ### Fixtures
102
- ```python
103
- @pytest.fixture
104
- def db_session():
105
- session = create_test_session()
106
- yield session
107
- session.close()
108
-
109
- def test_user_query(db_session):
110
- users = db_session.query(User).all()
111
- assert len(users) > 0
112
- ```
113
-
114
- ### Parametrize
115
- ```python
116
- @pytest.mark.parametrize("email,expected", [
117
- ("", False),
118
- ("a@b", True),
119
- ("@b.com", False),
120
- ])
121
- def test_email_validation(email, expected):
122
- assert validate_email(email) == expected
123
- ```
124
-
125
- ### Mocking with mocker (pytest-mock)
126
- ```python
127
- def test_send_email(mocker):
128
- mock_client = mocker.patch("email_service.email_client.send")
129
- mock_client.return_value = {"id": "msg_123"}
130
- result = send_email("user@test.com", "Welcome!")
131
- assert result["success"] is True
132
- ```
133
-
134
- ---
135
-
136
- ## Python — unittest
137
-
138
- ```python
139
- import unittest
140
- from unittest.mock import patch
141
- from user_service import create_user
142
-
143
- class TestUserService(unittest.TestCase):
144
- def test_create_user_valid(self):
145
- user = create_user(name="Alice", email="alice@test.com")
146
- self.assertEqual(user.name, "Alice")
147
- self.assertIsNotNone(user.id)
148
-
149
- def test_reject_duplicate(self):
150
- create_user(name="Alice", email="dup@test.com")
151
- with self.assertRaises(ValueError):
152
- create_user(name="Bob", email="dup@test.com")
153
-
154
- @patch("email_service.email_client.send")
155
- def test_send_email(self, mock_send):
156
- mock_send.return_value = {"id": "msg_123"}
157
- result = send_email("user@test.com", "Welcome!")
158
- self.assertTrue(result["success"])
159
-
160
- if __name__ == "__main__":
161
- unittest.main()
162
- ```
163
-
164
- ---
165
-
166
- ## Rust
167
-
168
- ```rust
169
- #[cfg(test)]
170
- mod tests {
171
- use super::*;
172
-
173
- #[test]
174
- fn test_create_user_with_valid_data() {
175
- let user = User::new("Alice", "alice@test.com").unwrap();
176
- assert_eq!(user.name, "Alice");
177
- assert!(user.id.is_some());
178
- }
179
-
180
- #[test]
181
- fn test_reject_duplicate_emails() {
182
- User::new("Alice", "dup@test.com").unwrap();
183
- let result = User::new("Bob", "dup@test.com");
184
- assert!(result.is_err());
185
- assert_eq!(result.unwrap_err().to_string(), "Email already exists");
186
- }
187
-
188
- #[test]
189
- fn test_handle_empty_name() {
190
- let result = User::new("", "x@test.com");
191
- assert!(result.is_err());
192
- }
193
- }
194
- ```
195
-
196
- ---
197
-
198
- ## Go
199
-
200
- ```go
201
- package user
202
-
203
- import "testing"
204
-
205
- func TestCreateUser_ValidData(t *testing.T) {
206
- user, err := NewUser("Alice", "alice@test.com")
207
- if err != nil {
208
- t.Fatalf("unexpected error: %v", err)
209
- }
210
- if user.Name != "Alice" {
211
- t.Errorf("got name %q, want %q", user.Name, "Alice")
212
- }
213
- }
214
-
215
- func TestCreateUser_DuplicateEmail(t *testing.T) {
216
- NewUser("Alice", "dup@test.com")
217
- _, err := NewUser("Bob", "dup@test.com")
218
- if err == nil {
219
- t.Fatal("expected error for duplicate email")
220
- }
221
- }
222
-
223
- // Table-driven test
224
- func TestValidateEmail(t *testing.T) {
225
- tests := []struct {
226
- email string
227
- expected bool
228
- }{
229
- {"", false},
230
- {"a@b", true},
231
- {"@b.com", false},
232
- }
233
- for _, tc := range tests {
234
- got := ValidateEmail(tc.email)
235
- if got != tc.expected {
236
- t.Errorf("ValidateEmail(%q) = %v, want %v", tc.email, got, tc.expected)
237
- }
238
- }
239
- }
240
- ```
241
-
242
- ---
243
-
244
- ## Test Structure Decision Tree
245
-
246
- ```
247
- What kind of code?
248
- ├── Pure function / utility
249
- │ └── Unit test — test input/output pairs, edge cases
250
- ├── Service / business logic
251
- │ └── Unit test — mock external dependencies, test logic
252
- ├── API endpoint
253
- │ └── Integration test — hit the endpoint, check response
254
- ├── Database query
255
- │ └── Integration test — use test DB or in-memory DB
256
- ├── CLI command
257
- │ └── Integration test — invoke CLI, check output
258
- └── UI component
259
- └── Component test — render, interact, assert
260
- ```
1
+ # Test Patterns — Language & Framework Specific
2
+
3
+ ## TypeScript / JavaScript — Vitest
4
+
5
+ ### Basic structure
6
+ ```typescript
7
+ import { describe, it, expect, beforeEach, vi } from 'vitest'
8
+ import { userService } from './userService'
9
+
10
+ describe('userService', () => {
11
+ beforeEach(() => {
12
+ vi.restoreAllMocks()
13
+ })
14
+
15
+ it('should create a user with valid data', async () => {
16
+ const user = await userService.create({ name: 'Alice', email: 'alice@test.com' })
17
+ expect(user).toMatchObject({ name: 'Alice' })
18
+ expect(user.id).toBeDefined()
19
+ })
20
+
21
+ it('should reject duplicate emails', async () => {
22
+ await userService.create({ name: 'Alice', email: 'dup@test.com' })
23
+ await expect(userService.create({ name: 'Bob', email: 'dup@test.com' }))
24
+ .rejects.toThrow('Email already exists')
25
+ })
26
+
27
+ it('should handle empty name', async () => {
28
+ await expect(userService.create({ name: '', email: 'x@test.com' }))
29
+ .rejects.toThrow('Name is required')
30
+ })
31
+ })
32
+ ```
33
+
34
+ ### Mocking external dependencies
35
+ ```typescript
36
+ import { describe, it, expect, vi } from 'vitest'
37
+ import { sendEmail } from './emailService'
38
+ import { emailClient } from './emailClient'
39
+
40
+ vi.mock('./emailClient')
41
+
42
+ it('should send welcome email', async () => {
43
+ vi.mocked(emailClient.send).mockResolvedValue({ id: 'msg_123' })
44
+ const result = await sendEmail('user@test.com', 'Welcome!')
45
+ expect(result.success).toBe(true)
46
+ expect(emailClient.send).toHaveBeenCalledWith(
47
+ expect.objectContaining({ to: 'user@test.com' })
48
+ )
49
+ })
50
+ ```
51
+
52
+ ### Parametrized tests
53
+ ```typescript
54
+ it.each([
55
+ { input: '', expected: false },
56
+ { input: 'a@b', expected: true },
57
+ { input: '@b.com', expected: false },
58
+ ])('should validate email: $input', ({ input, expected }) => {
59
+ expect(validateEmail(input)).toBe(expected)
60
+ })
61
+ ```
62
+
63
+ ---
64
+
65
+ ## TypeScript / JavaScript — Jest
66
+
67
+ Same patterns as Vitest with these differences:
68
+ - `jest.mock()` instead of `vi.mock()`
69
+ - `jest.fn()` instead of `vi.fn()`
70
+ - No built-in `it.each` (use `test.each` or `it.each` from `@jest/globals`)
71
+
72
+ ```typescript
73
+ jest.mock('./emailClient')
74
+ jest.spyOn(console, 'error').mockImplementation(() => {})
75
+ ```
76
+
77
+ ---
78
+
79
+ ## Python — Pytest
80
+
81
+ ### Basic structure
82
+ ```python
83
+ import pytest
84
+ from user_service import create_user
85
+
86
+ def test_create_user_with_valid_data():
87
+ user = create_user(name="Alice", email="alice@test.com")
88
+ assert user.name == "Alice"
89
+ assert user.id is not None
90
+
91
+ def test_reject_duplicate_emails():
92
+ create_user(name="Alice", email="dup@test.com")
93
+ with pytest.raises(ValueError, match="Email already exists"):
94
+ create_user(name="Bob", email="dup@test.com")
95
+
96
+ def test_handle_empty_name():
97
+ with pytest.raises(ValueError, match="Name is required"):
98
+ create_user(name="", email="x@test.com")
99
+ ```
100
+
101
+ ### Fixtures
102
+ ```python
103
+ @pytest.fixture
104
+ def db_session():
105
+ session = create_test_session()
106
+ yield session
107
+ session.close()
108
+
109
+ def test_user_query(db_session):
110
+ users = db_session.query(User).all()
111
+ assert len(users) > 0
112
+ ```
113
+
114
+ ### Parametrize
115
+ ```python
116
+ @pytest.mark.parametrize("email,expected", [
117
+ ("", False),
118
+ ("a@b", True),
119
+ ("@b.com", False),
120
+ ])
121
+ def test_email_validation(email, expected):
122
+ assert validate_email(email) == expected
123
+ ```
124
+
125
+ ### Mocking with mocker (pytest-mock)
126
+ ```python
127
+ def test_send_email(mocker):
128
+ mock_client = mocker.patch("email_service.email_client.send")
129
+ mock_client.return_value = {"id": "msg_123"}
130
+ result = send_email("user@test.com", "Welcome!")
131
+ assert result["success"] is True
132
+ ```
133
+
134
+ ---
135
+
136
+ ## Python — unittest
137
+
138
+ ```python
139
+ import unittest
140
+ from unittest.mock import patch
141
+ from user_service import create_user
142
+
143
+ class TestUserService(unittest.TestCase):
144
+ def test_create_user_valid(self):
145
+ user = create_user(name="Alice", email="alice@test.com")
146
+ self.assertEqual(user.name, "Alice")
147
+ self.assertIsNotNone(user.id)
148
+
149
+ def test_reject_duplicate(self):
150
+ create_user(name="Alice", email="dup@test.com")
151
+ with self.assertRaises(ValueError):
152
+ create_user(name="Bob", email="dup@test.com")
153
+
154
+ @patch("email_service.email_client.send")
155
+ def test_send_email(self, mock_send):
156
+ mock_send.return_value = {"id": "msg_123"}
157
+ result = send_email("user@test.com", "Welcome!")
158
+ self.assertTrue(result["success"])
159
+
160
+ if __name__ == "__main__":
161
+ unittest.main()
162
+ ```
163
+
164
+ ---
165
+
166
+ ## Rust
167
+
168
+ ```rust
169
+ #[cfg(test)]
170
+ mod tests {
171
+ use super::*;
172
+
173
+ #[test]
174
+ fn test_create_user_with_valid_data() {
175
+ let user = User::new("Alice", "alice@test.com").unwrap();
176
+ assert_eq!(user.name, "Alice");
177
+ assert!(user.id.is_some());
178
+ }
179
+
180
+ #[test]
181
+ fn test_reject_duplicate_emails() {
182
+ User::new("Alice", "dup@test.com").unwrap();
183
+ let result = User::new("Bob", "dup@test.com");
184
+ assert!(result.is_err());
185
+ assert_eq!(result.unwrap_err().to_string(), "Email already exists");
186
+ }
187
+
188
+ #[test]
189
+ fn test_handle_empty_name() {
190
+ let result = User::new("", "x@test.com");
191
+ assert!(result.is_err());
192
+ }
193
+ }
194
+ ```
195
+
196
+ ---
197
+
198
+ ## Go
199
+
200
+ ```go
201
+ package user
202
+
203
+ import "testing"
204
+
205
+ func TestCreateUser_ValidData(t *testing.T) {
206
+ user, err := NewUser("Alice", "alice@test.com")
207
+ if err != nil {
208
+ t.Fatalf("unexpected error: %v", err)
209
+ }
210
+ if user.Name != "Alice" {
211
+ t.Errorf("got name %q, want %q", user.Name, "Alice")
212
+ }
213
+ }
214
+
215
+ func TestCreateUser_DuplicateEmail(t *testing.T) {
216
+ NewUser("Alice", "dup@test.com")
217
+ _, err := NewUser("Bob", "dup@test.com")
218
+ if err == nil {
219
+ t.Fatal("expected error for duplicate email")
220
+ }
221
+ }
222
+
223
+ // Table-driven test
224
+ func TestValidateEmail(t *testing.T) {
225
+ tests := []struct {
226
+ email string
227
+ expected bool
228
+ }{
229
+ {"", false},
230
+ {"a@b", true},
231
+ {"@b.com", false},
232
+ }
233
+ for _, tc := range tests {
234
+ got := ValidateEmail(tc.email)
235
+ if got != tc.expected {
236
+ t.Errorf("ValidateEmail(%q) = %v, want %v", tc.email, got, tc.expected)
237
+ }
238
+ }
239
+ }
240
+ ```
241
+
242
+ ---
243
+
244
+ ## Test Structure Decision Tree
245
+
246
+ ```
247
+ What kind of code?
248
+ ├── Pure function / utility
249
+ │ └── Unit test — test input/output pairs, edge cases
250
+ ├── Service / business logic
251
+ │ └── Unit test — mock external dependencies, test logic
252
+ ├── API endpoint
253
+ │ └── Integration test — hit the endpoint, check response
254
+ ├── Database query
255
+ │ └── Integration test — use test DB or in-memory DB
256
+ ├── CLI command
257
+ │ └── Integration test — invoke CLI, check output
258
+ └── UI component
259
+ └── Component test — render, interact, assert
260
+ ```
@@ -1,5 +1,5 @@
1
- # test-gen Scripts
2
-
3
- Placeholder for test generation utility scripts. Future candidates:
4
- - `detect-framework.py` — Detect project test framework from config files
5
- - `analyze-coverage.py` — Parse coverage report for untested areas
1
+ # test-gen Scripts
2
+
3
+ Placeholder for test generation utility scripts. Future candidates:
4
+ - `detect-framework.py` — Detect project test framework from config files
5
+ - `analyze-coverage.py` — Parse coverage report for untested areas