Skip to content

Commit 24187b0

Browse files
cs-utilcs-util
authored
Merge pull request #1 from cs-util-com/feature/triangulationMode
Feature/triangulation mode
2 parents a7e1545 + feff176 commit 24187b0

40 files changed

+36876
-605
lines changed

‎.babelrc.js‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
/**
2+
* Babel Configuration Pointer File
3+
*
4+
* This file serves as the entry point for Babel configuration and MUST remain
5+
* in the project root directory. Here's why:
6+
*
7+
* What Babel does:
8+
* - Transpiles modern JavaScript (ES6+) to backwards-compatible code
9+
* - Enables use of latest JS features while maintaining browser/Node compatibility
10+
* - Currently configured for Node.js environment via @babel/preset-env
11+
*
12+
* Why this file is in the root:
13+
* - Babel's file discovery mechanism looks for config files starting from the
14+
* current directory and moving upward through parent directories
15+
* - Tools like Jest, bundlers, and other build tools expect to find Babel
16+
* config following this standard discovery pattern
17+
* - Moving this file would break automatic detection by these tools
18+
*
19+
* Project organization:
20+
* - This file acts as a lightweight pointer to the actual configuration
21+
* - Real config is in ./config/babel.config.js for better organization
22+
* - This approach keeps tooling compatibility while organizing configs centrally
23+
*
24+
* Used by: Jest (via babel-jest), and potentially other build tools
25+
*/
26+
module.exports = require('./config/babel.config.js');

‎.github/ISSUE_TEMPLATE/agent_task.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
name: Agent Task
3+
about: Task specifically designed for autonomous AI agents
4+
title: '[AGENT] '
5+
labels: ['agent-task', 'automation']
6+
assignees: ''
7+
---
8+
9+
## Task Overview
10+
**Objective:**
11+
<!-- Clear, specific description of what the agent should accomplish -->
12+
13+
**Priority:** <!-- High/Medium/Low -->
14+
15+
## Detailed Requirements
16+
17+
### Primary Goals
18+
- [ ] Goal 1
19+
- [ ] Goal 2
20+
- [ ] Goal 3
21+
22+
### Technical Constraints
23+
- [ ] Must maintain 100% test coverage
24+
- [ ] Must pass all quality gates (`npm run check:all`)
25+
- [ ] Must follow existing code patterns
26+
- [ ] Must not introduce breaking changes
27+
28+
### Success Criteria
29+
<!-- Very specific, measurable criteria for completion -->
30+
- [ ] All tests pass: `npm test`
31+
- [ ] Quality checks pass: `npm run check:all`
32+
- [ ] Mutation testing >50%: `npm run mutation`
33+
- [ ] Specific functionality works as described
34+
- [ ] Documentation is updated if needed
35+
36+
## Implementation Guidance
37+
38+
### Suggested Approach
39+
<!-- Step-by-step guidance for the agent -->
40+
1. Analyze existing code structure
41+
2. Write tests first (TDD approach)
42+
3. Implement incrementally
43+
4. Validate continuously
44+
45+
### Files to Consider
46+
<!-- List relevant files the agent should examine/modify -->
47+
```
48+
src/
49+
├── components/
50+
├── utils/
51+
├── index.js
52+
index.html
53+
package.json
54+
```
55+
56+
### Testing Strategy
57+
- **Unit tests:** Test individual functions/components
58+
- **Property tests:** Use fast-check for complex logic
59+
- **Integration tests:** Test component interactions
60+
- **Manual verification:** Test in browser if UI changes
61+
62+
## Quality Gates
63+
Before opening PR, ensure:
64+
```bash
65+
npm test # All tests pass
66+
npm run check:all # All quality checks pass
67+
npm run validate:all # Complete validation
68+
```
69+
70+
## Agent Instructions
71+
**Branch naming:** `agent/[issue-number]-[short-description]`
72+
73+
**Commit strategy:**
74+
- Small, focused commits
75+
- Clear commit messages
76+
- Reference this issue number
77+
78+
**Error handling:**
79+
- If tests fail, analyze each failure individually
80+
- Fix simplest issues first
81+
- Make minimal changes
82+
- Verify fixes immediately
83+
84+
---
85+
86+
**Ready for agent assignment:** Comment `@claude` or `/cursor start` to assign this task to an autonomous agent.

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
name: Bug Report
3+
about: Report a bug or issue with the template
4+
title: '[BUG] '
5+
labels: ['bug', 'needs-triage']
6+
assignees: ''
7+
---
8+
9+
## Bug Description
10+
**Current behavior:**
11+
<!-- Describe what is currently happening -->
12+
13+
**Expected behavior:**
14+
<!-- Describe what should happen instead -->
15+
16+
**Steps to reproduce:**
17+
1.
18+
2.
19+
3.
20+
21+
## Environment
22+
- Browser: <!-- e.g., Chrome 91, Firefox 89 -->
23+
- Node version: <!-- run `node --version` -->
24+
- NPM version: <!-- run `npm --version` -->
25+
- Operating System: <!-- e.g., Windows 10, macOS 11, Ubuntu 20.04 -->
26+
27+
## Code/Error Details
28+
**Error messages:**
29+
```
30+
<!-- Paste any error messages here -->
31+
```
32+
33+
**Relevant code:**
34+
```javascript
35+
// Paste relevant code here
36+
```
37+
38+
**Test failures:**
39+
```
40+
<!-- If tests are failing, paste the output -->
41+
```
42+
43+
## Investigation Notes
44+
**Files involved:**
45+
<!-- List files where the bug might be located -->
46+
47+
**Potential causes:**
48+
<!-- Any theories about what might be causing this -->
49+
50+
## Fix Requirements
51+
- [ ] Must fix the reported behavior
52+
- [ ] Must not break existing functionality
53+
- [ ] Must include test coverage for the fix
54+
- [ ] Must pass all quality gates
55+
56+
## Acceptance Criteria
57+
- [ ] Bug is resolved
58+
- [ ] Tests pass: `npm test`
59+
- [ ] Quality checks pass: `npm run check:all`
60+
- [ ] No regression in existing features
61+
62+
---
63+
64+
**For AI Agents:**
65+
To fix this bug, create a branch named `agent/[issue-number]-fix-[bug-description]` and:
66+
1. Write a failing test that reproduces the bug
67+
2. Implement the minimal fix
68+
3. Ensure all tests pass
69+
4. Run complete validation with `npm run validate:all`

‎.github/ISSUE_TEMPLATE/feature_request.md‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
name: Feature Request
3+
about: Suggest a new feature for the template
4+
title: '[FEATURE] '
5+
labels: ['enhancement', 'needs-specification']
6+
assignees: ''
7+
---
8+
9+
## Feature Description
10+
**Brief description of the feature:**
11+
<!-- Provide a clear and concise description of what you want to add -->
12+
13+
**Problem it solves:**
14+
<!-- Explain what problem this feature addresses -->
15+
16+
## Requirements
17+
18+
### Functional Requirements
19+
<!-- What should this feature do? -->
20+
- [ ] Requirement 1
21+
- [ ] Requirement 2
22+
- [ ] Requirement 3
23+
24+
### Technical Requirements
25+
<!-- Any specific technical constraints or considerations -->
26+
- [ ] Must maintain 100% test coverage
27+
- [ ] Must follow existing code structure
28+
- [ ] Must not break existing functionality
29+
30+
### Acceptance Criteria
31+
<!-- How will we know this feature is complete and working? -->
32+
- [ ] Criteria 1
33+
- [ ] Criteria 2
34+
- [ ] Criteria 3
35+
36+
## Implementation Notes
37+
**Suggested approach:**
38+
<!-- If you have ideas about how to implement this -->
39+
40+
**Files likely to be affected:**
41+
<!-- List files that might need changes -->
42+
- `src/`
43+
- `index.html`
44+
- `package.json`
45+
46+
## Testing Strategy
47+
<!-- How should this feature be tested? -->
48+
- [ ] Unit tests for core functionality
49+
- [ ] Property-based tests for complex logic
50+
- [ ] Integration tests if needed
51+
- [ ] Manual testing scenarios
52+
53+
## Additional Context
54+
<!-- Add any other context, mockups, or examples -->
55+
56+
---
57+
58+
**For AI Agents:**
59+
To implement this feature, create a branch named `agent/[issue-number]-[short-description]` and ensure all quality gates pass before opening a PR.
60+
61+
Test commands:
62+
- `npm test` - Run all tests
63+
- `npm run check:all` - Run quality checks
64+
- `npm run validate:all` - Complete validation

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# Pull Request
2+
3+
> For AI assistants and contributors: see `AGENTS.md` for repo workflows, validation, and guardrails.
4+
5+
## Description
6+
**Summary of changes:**
7+
<!-- Brief description of what this PR accomplishes -->
8+
9+
**Related issue:** Closes #[issue-number]
10+
11+
**Type of change:**
12+
- [ ] Bug fix (non-breaking change which fixes an issue)
13+
- [ ] New feature (non-breaking change which adds functionality)
14+
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
15+
- [ ] Documentation update
16+
- [ ] Code quality improvement
17+
18+
## Implementation Details
19+
20+
### Changes Made
21+
<!-- List the key changes in this PR -->
22+
-
23+
-
24+
-
25+
26+
### Files Modified
27+
<!-- List the main files that were changed -->
28+
- `src/`
29+
- `index.html`
30+
- Other files...
31+
32+
## Testing
33+
34+
### Test Results
35+
```bash
36+
# Paste output of npm test
37+
```
38+
39+
### Quality Checks
40+
```bash
41+
# Paste output of npm run check:all
42+
```
43+
44+
### Mutation Testing (if applicable)
45+
```bash
46+
# Paste output of npm run mutation (if new code was added)
47+
```
48+
49+
## Manual Testing
50+
<!-- Describe any manual testing performed -->
51+
- [ ] Tested in browser
52+
- [ ] Verified functionality works as expected
53+
- [ ] Checked for edge cases
54+
55+
## Breaking Changes
56+
<!-- List any breaking changes and migration steps -->
57+
- None
58+
59+
## Documentation
60+
- [ ] Code is self-documenting or includes appropriate comments
61+
- [ ] README.md updated (if applicable)
62+
- [ ] API documentation updated (if applicable)
63+
64+
## Checklist
65+
- [ ] My code follows the project's coding standards
66+
- [ ] I have performed a self-review of my code
67+
- [ ] All tests pass (`npm test`)
68+
- [ ] All quality checks pass (`npm run check:all`)
69+
- [ ] I have added tests that prove my fix/feature works
70+
- [ ] New and existing tests pass locally
71+
- [ ] Any dependent changes have been merged and published
72+
73+
## Additional Context
74+
<!-- Add any other context about the PR here -->
75+
76+
---
77+
78+
**For reviewers:**
79+
- Verify all quality gates pass
80+
- Check test coverage remains at 100%
81+
- Ensure mutation testing passes
82+
- Review code for maintainability

0 commit comments

Comments
 (0)