ref-agents 1.0.0__py3-none-any.whl
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.
- ref_agents/__init__.py +9 -0
- ref_agents/api_keys.json.example +8 -0
- ref_agents/auth.py +129 -0
- ref_agents/codemap/..md +62 -0
- ref_agents/codemap/CODE_MAP.md +37 -0
- ref_agents/codemap/core.md +43 -0
- ref_agents/codemap/models.md +43 -0
- ref_agents/codemap/prompts.md +40 -0
- ref_agents/codemap/security.md +45 -0
- ref_agents/codemap/tools.md +94 -0
- ref_agents/codemap/tools_browser.md +44 -0
- ref_agents/codemap/utils.md +42 -0
- ref_agents/codemap/workflow.md +42 -0
- ref_agents/config/ai_patterns.yaml +101 -0
- ref_agents/config/frameworks/angular.yaml +104 -0
- ref_agents/config/frameworks/aspnet.yaml +84 -0
- ref_agents/config/frameworks/ef_core.yaml +81 -0
- ref_agents/config/frameworks/react.yaml +111 -0
- ref_agents/config/frameworks/spring_boot.yaml +117 -0
- ref_agents/config/languages/csharp.yaml +153 -0
- ref_agents/config/languages/java.yaml +188 -0
- ref_agents/config/languages/javascript.yaml +172 -0
- ref_agents/config/languages/python.yaml +153 -0
- ref_agents/config/languages/typescript.yaml +193 -0
- ref_agents/constants.py +553 -0
- ref_agents/core/__init__.py +15 -0
- ref_agents/core/config_loader.py +160 -0
- ref_agents/core/config_models.py +167 -0
- ref_agents/core/config_parsing.py +84 -0
- ref_agents/core/language_detector.py +388 -0
- ref_agents/core/validation_models.py +66 -0
- ref_agents/core/validation_primitives.py +176 -0
- ref_agents/errors.py +34 -0
- ref_agents/license_client.py +247 -0
- ref_agents/models/__init__.py +22 -0
- ref_agents/models/gherkin.py +45 -0
- ref_agents/models/hierarchy.py +80 -0
- ref_agents/models/invest.py +59 -0
- ref_agents/models/version.py +49 -0
- ref_agents/prompts/__init__.py +9 -0
- ref_agents/prompts/start_agent.py +772 -0
- ref_agents/rules/architecture/backend_patterns.md +43 -0
- ref_agents/rules/architecture/diagramming.md +100 -0
- ref_agents/rules/architecture/frontend_patterns.md +40 -0
- ref_agents/rules/architecture/impact_analysis.md +129 -0
- ref_agents/rules/architecture/migration_strategy.md +208 -0
- ref_agents/rules/architecture/regression_protocol.md +77 -0
- ref_agents/rules/architecture/system_design.md +97 -0
- ref_agents/rules/common/codemap_standard.md +97 -0
- ref_agents/rules/common/core_protocol.md +59 -0
- ref_agents/rules/common/prompt_engineering.md +294 -0
- ref_agents/rules/development/debugging.md +32 -0
- ref_agents/rules/development/implementation.md +205 -0
- ref_agents/rules/operations/completion.md +119 -0
- ref_agents/rules/operations/cutover_protocol.md +218 -0
- ref_agents/rules/operations/discovery.md +179 -0
- ref_agents/rules/operations/fix_workflow.md +87 -0
- ref_agents/rules/operations/forensics.md +278 -0
- ref_agents/rules/operations/platform.md +263 -0
- ref_agents/rules/operations/synchronous_flow.md +25 -0
- ref_agents/rules/product/ac_validation.md +25 -0
- ref_agents/rules/product/brainstorming.md +27 -0
- ref_agents/rules/product/ref_flow.md +101 -0
- ref_agents/rules/product/requirements_std.md +114 -0
- ref_agents/rules/product/spec_writing.md +235 -0
- ref_agents/rules/product/strategy.md +96 -0
- ref_agents/rules/quality/documentation_standards.md +46 -0
- ref_agents/rules/quality/parity_testing.md +234 -0
- ref_agents/rules/quality/project_documentation.md +56 -0
- ref_agents/rules/quality/qa_lead.md +111 -0
- ref_agents/rules/quality/test_design.md +146 -0
- ref_agents/rules/quality/testing_standards.md +293 -0
- ref_agents/rules/review/pr_review.md +116 -0
- ref_agents/rules/security/security_audit.md +83 -0
- ref_agents/security/__init__.py +22 -0
- ref_agents/security/dependency_audit.py +188 -0
- ref_agents/security/file_audit.py +208 -0
- ref_agents/security/network_scan.py +179 -0
- ref_agents/security/report_generator.py +313 -0
- ref_agents/security/secret_scan.py +252 -0
- ref_agents/security/url_scan.py +240 -0
- ref_agents/security_scan.py +236 -0
- ref_agents/server.py +1586 -0
- ref_agents/session.py +100 -0
- ref_agents/tool_names.py +55 -0
- ref_agents/tools/__init__.py +8 -0
- ref_agents/tools/agents_generator.py +315 -0
- ref_agents/tools/ai_pattern_detector.py +815 -0
- ref_agents/tools/brownfield_populator.py +529 -0
- ref_agents/tools/browser/__init__.py +50 -0
- ref_agents/tools/browser/evidence_verifier.py +302 -0
- ref_agents/tools/browser/execution_logger.py +249 -0
- ref_agents/tools/browser/playwright_mcp_client.py +259 -0
- ref_agents/tools/browser/screenshot_utils.py +184 -0
- ref_agents/tools/browser/test_executor.py +537 -0
- ref_agents/tools/code_quality_scanner.py +629 -0
- ref_agents/tools/codemap/..md +93 -0
- ref_agents/tools/codemap/CODE_MAP.md +30 -0
- ref_agents/tools/codemap/browser.md +44 -0
- ref_agents/tools/codemap.py +403 -0
- ref_agents/tools/codemap_freshness.py +234 -0
- ref_agents/tools/comment_smell_scanner.py +346 -0
- ref_agents/tools/complexity.py +436 -0
- ref_agents/tools/complexity_ast.py +333 -0
- ref_agents/tools/compliance.py +246 -0
- ref_agents/tools/compliance_remediation.py +846 -0
- ref_agents/tools/context_graph.py +839 -0
- ref_agents/tools/context_manager.py +550 -0
- ref_agents/tools/context_tools.py +121 -0
- ref_agents/tools/cross_repo_linker.py +393 -0
- ref_agents/tools/dead_code_scanner.py +637 -0
- ref_agents/tools/debt_scanner.py +1092 -0
- ref_agents/tools/dependency_graph.py +272 -0
- ref_agents/tools/discovery_audit.py +372 -0
- ref_agents/tools/docs_scanner.py +600 -0
- ref_agents/tools/evaluate_gate.py +119 -0
- ref_agents/tools/external_detector.py +524 -0
- ref_agents/tools/features_generator.py +282 -0
- ref_agents/tools/flow_gap_detector.py +373 -0
- ref_agents/tools/flow_mapper.py +327 -0
- ref_agents/tools/full_suite_runner.py +740 -0
- ref_agents/tools/gherkin_parser.py +227 -0
- ref_agents/tools/guard_tools.py +139 -0
- ref_agents/tools/handoff_tools.py +282 -0
- ref_agents/tools/health_scanner.py +1211 -0
- ref_agents/tools/hierarchy_manager.py +289 -0
- ref_agents/tools/invest_scorer.py +249 -0
- ref_agents/tools/jira_confluence_export.py +306 -0
- ref_agents/tools/json_output.py +76 -0
- ref_agents/tools/migration_mapper.py +946 -0
- ref_agents/tools/migration_readiness_scanner.py +209 -0
- ref_agents/tools/pattern_learner.py +522 -0
- ref_agents/tools/report_utils.py +155 -0
- ref_agents/tools/requirements_serializer.py +225 -0
- ref_agents/tools/security_audit_tool.py +106 -0
- ref_agents/tools/sequencing_engine.py +288 -0
- ref_agents/tools/summary_generator.py +275 -0
- ref_agents/tools/symbol_resolver.py +306 -0
- ref_agents/tools/symbol_smoke_runner.py +336 -0
- ref_agents/tools/test_plan_validator.py +189 -0
- ref_agents/tools/test_smell_walker.py +902 -0
- ref_agents/tools/tier1_fixer.py +502 -0
- ref_agents/tools/validators/__init__.py +419 -0
- ref_agents/tools/validators/architect.py +268 -0
- ref_agents/tools/validators/cutover_engineer.py +167 -0
- ref_agents/tools/validators/developer.py +180 -0
- ref_agents/tools/validators/discovery.py +150 -0
- ref_agents/tools/validators/forensic_engineer.py +191 -0
- ref_agents/tools/validators/impact_architect.py +181 -0
- ref_agents/tools/validators/migration_planner.py +166 -0
- ref_agents/tools/validators/parity_tester.py +155 -0
- ref_agents/tools/validators/platform_engineer.py +134 -0
- ref_agents/tools/validators/pr_reviewer.py +129 -0
- ref_agents/tools/validators/product_manager.py +291 -0
- ref_agents/tools/validators/qa_lead.py +172 -0
- ref_agents/tools/validators/scrum_master.py +212 -0
- ref_agents/tools/validators/security_owner.py +162 -0
- ref_agents/tools/validators/specifier.py +134 -0
- ref_agents/tools/validators/strategist.py +149 -0
- ref_agents/tools/validators/tester.py +121 -0
- ref_agents/tools/version_manager.py +202 -0
- ref_agents/tools/workflow_tools.py +1549 -0
- ref_agents/utils/__init__.py +21 -0
- ref_agents/utils/git_utils.py +351 -0
- ref_agents/utils/handoff_logger.py +368 -0
- ref_agents/utils/ignore_matcher.py +270 -0
- ref_agents/workflow/__init__.py +19 -0
- ref_agents/workflow/capabilities.py +328 -0
- ref_agents/workflow/state_machine.py +708 -0
- ref_agents/workflow/transitions.py +658 -0
- ref_agents-1.0.0.dist-info/METADATA +365 -0
- ref_agents-1.0.0.dist-info/RECORD +175 -0
- ref_agents-1.0.0.dist-info/WHEEL +4 -0
- ref_agents-1.0.0.dist-info/entry_points.txt +2 -0
- ref_agents-1.0.0.dist-info/licenses/LICENSE +115 -0
|
@@ -0,0 +1,365 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: ref-agents
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: REF Agents — AI-powered SDLC governance for the Relay Engineering Framework. 19 expert personas enforcing quality gates via Model Context Protocol (MCP).
|
|
5
|
+
Project-URL: Homepage, https://ref.dev
|
|
6
|
+
Project-URL: Repository, https://github.com/Mishtert/ref-agents
|
|
7
|
+
Project-URL: Bug Tracker, https://github.com/Mishtert/ref-agents/issues
|
|
8
|
+
Author-email: Mishtert T <Mishtert.Thangaraj@myridius.com>
|
|
9
|
+
License: Proprietary
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: agents,ai,code-quality,governance,mcp,relay-engineering,sdlc
|
|
12
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
13
|
+
Classifier: Environment :: Console
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: Other/Proprietary License
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
21
|
+
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
|
|
22
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
23
|
+
Requires-Python: >=3.12
|
|
24
|
+
Requires-Dist: fastmcp>=2.14.1
|
|
25
|
+
Requires-Dist: mcp>=1.25.0
|
|
26
|
+
Requires-Dist: networkx>=3.4
|
|
27
|
+
Requires-Dist: pydantic>=2.12.5
|
|
28
|
+
Requires-Dist: structlog>=25.5.0
|
|
29
|
+
Requires-Dist: tree-sitter-markdown>=0.3.0
|
|
30
|
+
Requires-Dist: tree-sitter-python>=0.21.0
|
|
31
|
+
Requires-Dist: tree-sitter-typescript>=0.21.0
|
|
32
|
+
Requires-Dist: tree-sitter>=0.21.0
|
|
33
|
+
Requires-Dist: watchdog>=4.0.0
|
|
34
|
+
Description-Content-Type: text/markdown
|
|
35
|
+
|
|
36
|
+
# REF Agents
|
|
37
|
+
|
|
38
|
+

|
|
39
|
+

|
|
40
|
+
|
|
41
|
+
**AI-Powered Guidance for the Relay Engineering Framework**
|
|
42
|
+
|
|
43
|
+
REF Agents provides agent-based AI guidance, codebase mapping, and quality enforcement for the Relay Engineering Framework (REF).
|
|
44
|
+
|
|
45
|
+
> *Built on [Anthropic's Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for universal AI assistant compatibility.*
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Table of Contents
|
|
50
|
+
|
|
51
|
+
- [What This Does](#what-this-does)
|
|
52
|
+
- [Features](#features)
|
|
53
|
+
- [Security](#security)
|
|
54
|
+
- [Installation](#installation)
|
|
55
|
+
- [Configuration](#configuration)
|
|
56
|
+
- [Local Development](#local-development)
|
|
57
|
+
- [Quick Start](#quick-start)
|
|
58
|
+
- [Contributing](#contributing)
|
|
59
|
+
- [About](#about)
|
|
60
|
+
- [License](#license)
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## What This Does
|
|
65
|
+
|
|
66
|
+
REF Agents is an **MCP server** that connects to your AI assistant (Cursor, Claude Desktop, Windsurf). Once connected, it provides:
|
|
67
|
+
|
|
68
|
+
1. **Agent-based prompts** — Specialized guidance for 13 agents (10 SDLC + 3 utility)
|
|
69
|
+
2. **Quality enforcement tools** — Scan code for compliance, debt, security
|
|
70
|
+
3. **Workflow orchestration** — Track story state, dependencies, handoffs
|
|
71
|
+
|
|
72
|
+
**Important:** This is not a standalone app. It requires an MCP-compatible AI assistant.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Features
|
|
77
|
+
|
|
78
|
+
### Agent-Based Guidance (13 Agents)
|
|
79
|
+
|
|
80
|
+
#### SDLC Workflow Agents (10)
|
|
81
|
+
|
|
82
|
+
| Agent | Function |
|
|
83
|
+
|------|----------|
|
|
84
|
+
| `discovery` | Brownfield codebase scanning, CODE_MAP generation |
|
|
85
|
+
| `product_manager` | Requirements, acceptance criteria |
|
|
86
|
+
| `qa_lead` | Validates AC *before* development begins |
|
|
87
|
+
| `architect` | System design, boundaries, integration points |
|
|
88
|
+
| `developer` | Elite Code Quality Protocol enforcement |
|
|
89
|
+
| `tester` | Test standards, real-execution tests |
|
|
90
|
+
| `pr_reviewer` | PR review, AI anti-pattern detection |
|
|
91
|
+
| `scrum_master` | Process orchestration, handoff tracking |
|
|
92
|
+
| `security_owner` | Security audit, vulnerability scanning |
|
|
93
|
+
| `test_designer` | Conceptual test design, BDD architecture |
|
|
94
|
+
|
|
95
|
+
#### Utility Agents (3) — On-Demand
|
|
96
|
+
|
|
97
|
+
| Agent | Function |
|
|
98
|
+
|------|----------|
|
|
99
|
+
| `forensic_engineer` | Incident investigation, 5 Whys, post-mortems |
|
|
100
|
+
| `strategist` | Solution brainstorming, trade-off analysis |
|
|
101
|
+
| `platform_engineer` | DevEx, health scanning, code quality enforcement |
|
|
102
|
+
|
|
103
|
+
### Quality Tools
|
|
104
|
+
|
|
105
|
+
| Tool | What It Does |
|
|
106
|
+
|------|--------------|
|
|
107
|
+
| `generate_codemap` | Auto-document directory structure |
|
|
108
|
+
| `validate_compliance` | Check code against REF standards |
|
|
109
|
+
| `detect_ai_patterns` | Find AI-generated code smells |
|
|
110
|
+
| `scan_debt` | Detect technical debt (TODOs, bare exceptions, etc.) |
|
|
111
|
+
| `scan_external_dependencies` | Find env vars, API clients, external URLs |
|
|
112
|
+
| `scan_code_quality` | AST-based pe_rules enforcement (bare except, types, logging) |
|
|
113
|
+
| `scan_health` | Unified health report across all quality dimensions |
|
|
114
|
+
|
|
115
|
+
### Workflow Tools
|
|
116
|
+
|
|
117
|
+
| Tool | What It Does |
|
|
118
|
+
|------|--------------|
|
|
119
|
+
| `init_workflow` | Start tracking a story |
|
|
120
|
+
| `get_workflow_state` | See current phase, blockers, artifacts |
|
|
121
|
+
| `suggest_next_agent` | Auto-suggest agent transitions |
|
|
122
|
+
| `generate_story_dependency_graph` | Visualize story dependencies |
|
|
123
|
+
| `detect_flow_gaps` | Find broken E2E flows |
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## Security
|
|
128
|
+
|
|
129
|
+
REF Agents is designed with security as a core principle:
|
|
130
|
+
|
|
131
|
+
- ✅ **No Network Calls**: Contains no HTTP clients, sockets, or external communication
|
|
132
|
+
- ✅ **No Data Exfiltration**: All operations are local-only
|
|
133
|
+
- ✅ **No Hardcoded Secrets**: Scanned for credentials and API keys
|
|
134
|
+
- ✅ **Audited Dependencies**: All dependencies use permissive OSS licenses
|
|
135
|
+
- ✅ **Stdio Transport Only**: Communication via standard input/output streams
|
|
136
|
+
|
|
137
|
+
### Run Security Audit
|
|
138
|
+
|
|
139
|
+
Enterprise customers can verify these claims:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
# Run full security audit
|
|
143
|
+
uv run python -m ref_agents.security_scan
|
|
144
|
+
|
|
145
|
+
# Output JSON for CI/CD
|
|
146
|
+
uv run python -m ref_agents.security_scan --format json
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
See [SECURITY.md](SECURITY.md) for full security policy and architecture details.
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## Installation
|
|
154
|
+
|
|
155
|
+
### Prerequisites
|
|
156
|
+
- `uv` or `uvx` ([Install uv](https://docs.astral.sh/uv/getting-started/installation/))
|
|
157
|
+
- Python 3.12+ (Windows users: see [WINDOWS_TROUBLESHOOTING.md](WINDOWS_TROUBLESHOOTING.md) if encountering installation issues)
|
|
158
|
+
|
|
159
|
+
### Client Compatibility
|
|
160
|
+
REF Agents uses **stdio** transport (Standard Input/Output). It works with:
|
|
161
|
+
- Claude Desktop
|
|
162
|
+
- Cursor
|
|
163
|
+
- Windsurf
|
|
164
|
+
- Any MCP-compatible client supporting `stdio`
|
|
165
|
+
|
|
166
|
+
> **Note**: Gemini and GitHub Copilot do not currently support MCP.
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## Configuration
|
|
171
|
+
|
|
172
|
+
**Simple installation** — works like Playwright MCP. No cloning required.
|
|
173
|
+
|
|
174
|
+
### Cursor (Recommended)
|
|
175
|
+
|
|
176
|
+
Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-local):
|
|
177
|
+
|
|
178
|
+
```json
|
|
179
|
+
{
|
|
180
|
+
"mcpServers": {
|
|
181
|
+
"ref-agents": {
|
|
182
|
+
"command": "uvx",
|
|
183
|
+
"args": ["ref-agents"]
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
**Via UI:**
|
|
190
|
+
1. Settings → MCP → + Add New MCP Server
|
|
191
|
+
2. Name: `ref-agents`
|
|
192
|
+
3. Type: `command`
|
|
193
|
+
4. Command: `uvx ref-agents`
|
|
194
|
+
|
|
195
|
+
### Claude Desktop
|
|
196
|
+
|
|
197
|
+
Add to `claude_desktop_config.json`:
|
|
198
|
+
|
|
199
|
+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
200
|
+
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
201
|
+
|
|
202
|
+
```json
|
|
203
|
+
{
|
|
204
|
+
"mcpServers": {
|
|
205
|
+
"ref-agents": {
|
|
206
|
+
"command": "uvx",
|
|
207
|
+
"args": ["ref-agents"]
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
### Windsurf
|
|
214
|
+
|
|
215
|
+
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
216
|
+
|
|
217
|
+
```json
|
|
218
|
+
{
|
|
219
|
+
"mcpServers": {
|
|
220
|
+
"ref-agents": {
|
|
221
|
+
"command": "uvx",
|
|
222
|
+
"args": ["ref-agents"]
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
### How `uvx` Resolves the Package
|
|
229
|
+
|
|
230
|
+
`uvx ref-agents` requires **no prior installation**. Here's what happens:
|
|
231
|
+
|
|
232
|
+
1. `uvx` receives the package name `ref-agents`
|
|
233
|
+
2. Queries PyPI (`https://pypi.org/simple/`) — the default registry, same as `pip`
|
|
234
|
+
3. Downloads the latest wheel into an isolated temporary environment
|
|
235
|
+
4. Runs the `ref-agents` entry point
|
|
236
|
+
5. Nothing persists in your global Python environment
|
|
237
|
+
|
|
238
|
+
You only need `uv` installed. The package is fetched on demand.
|
|
239
|
+
|
|
240
|
+
To pin a specific version:
|
|
241
|
+
|
|
242
|
+
```json
|
|
243
|
+
{
|
|
244
|
+
"mcpServers": {
|
|
245
|
+
"ref-agents": {
|
|
246
|
+
"command": "uvx",
|
|
247
|
+
"args": ["ref-agents==3.15.0"]
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
### Install from GitHub (Development/Unpublished)
|
|
254
|
+
|
|
255
|
+
If not yet published to PyPI, use GitHub:
|
|
256
|
+
|
|
257
|
+
```json
|
|
258
|
+
{
|
|
259
|
+
"mcpServers": {
|
|
260
|
+
"ref-agents": {
|
|
261
|
+
"command": "uvx",
|
|
262
|
+
"args": [
|
|
263
|
+
"--from",
|
|
264
|
+
"git+https://github.com/Mishtert/ref-agents",
|
|
265
|
+
"ref-agents"
|
|
266
|
+
]
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
**Note for Windows users:** If you encounter `pywin32` access denied errors, see [WINDOWS_TROUBLESHOOTING.md](WINDOWS_TROUBLESHOOTING.md) for solutions. Prefer using PyPI version (`uvx ref-agents`) when available.
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## Local Development
|
|
277
|
+
|
|
278
|
+
For contributors or local testing:
|
|
279
|
+
|
|
280
|
+
```bash
|
|
281
|
+
git clone https://github.com/Mishtert/ref-agents.git
|
|
282
|
+
cd ref-agents
|
|
283
|
+
uv sync
|
|
284
|
+
uv run ref-agents
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
---
|
|
288
|
+
|
|
289
|
+
## Quick Start
|
|
290
|
+
|
|
291
|
+
### 1. Verify Connection
|
|
292
|
+
|
|
293
|
+
After adding the config, restart your AI assistant. In Cursor:
|
|
294
|
+
- Open Settings → MCP
|
|
295
|
+
- Look for `ref-agents` with a green status indicator
|
|
296
|
+
|
|
297
|
+
### 2. Try These Commands
|
|
298
|
+
|
|
299
|
+
Type these in your AI assistant to verify it's working:
|
|
300
|
+
|
|
301
|
+
```
|
|
302
|
+
"What REF agents are available?"
|
|
303
|
+
```
|
|
304
|
+
**Expected:** List of 13 agents with descriptions.
|
|
305
|
+
|
|
306
|
+
```
|
|
307
|
+
"Set my agent to developer"
|
|
308
|
+
```
|
|
309
|
+
**Expected:** Elite Code Quality Protocol injected. AI now enforces coding standards.
|
|
310
|
+
|
|
311
|
+
```
|
|
312
|
+
"Generate a codemap for this directory"
|
|
313
|
+
```
|
|
314
|
+
**Expected:** CODE_MAP.md structure with files, purposes, dependencies.
|
|
315
|
+
|
|
316
|
+
```
|
|
317
|
+
"Scan this directory for technical debt"
|
|
318
|
+
```
|
|
319
|
+
**Expected:** Report of TODOs, bare exceptions, missing types, long functions.
|
|
320
|
+
|
|
321
|
+
### 3. Full Workflow Example
|
|
322
|
+
|
|
323
|
+
```
|
|
324
|
+
1. "Set agent to discovery" → Scans codebase, generates documentation
|
|
325
|
+
2. "Set agent to product_manager" → Write requirements with testable AC
|
|
326
|
+
3. "Set agent to qa_lead" → Validate AC before development
|
|
327
|
+
4. "Set agent to developer" → Implement with quality enforcement
|
|
328
|
+
5. "Set agent to pr_reviewer" → Review for compliance + AI patterns
|
|
329
|
+
```
|
|
330
|
+
|
|
331
|
+
### Troubleshooting
|
|
332
|
+
|
|
333
|
+
| Issue | Solution |
|
|
334
|
+
|-------|----------|
|
|
335
|
+
| MCP not connecting | Restart AI assistant after config change |
|
|
336
|
+
| `uvx` not found | Install uv: `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
|
|
337
|
+
| Tools not appearing | Check MCP status in settings; verify JSON syntax |
|
|
338
|
+
| Agent not activating | Use exact agent name: `developer` |
|
|
339
|
+
|
|
340
|
+
---
|
|
341
|
+
|
|
342
|
+
## Contributing
|
|
343
|
+
|
|
344
|
+
We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
|
|
345
|
+
|
|
346
|
+
- Code of conduct
|
|
347
|
+
- Development setup
|
|
348
|
+
- PR submission guidelines
|
|
349
|
+
- Testing requirements
|
|
350
|
+
|
|
351
|
+
**Version History:** See [GitHub Releases](https://github.com/Mishtert/ref-agents/releases) for changelog.
|
|
352
|
+
|
|
353
|
+
---
|
|
354
|
+
|
|
355
|
+
## About
|
|
356
|
+
|
|
357
|
+
REF Agents implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), an open standard developed by Anthropic for connecting AI assistants to external tools and data sources. This ensures compatibility with a wide ecosystem of AI development tools.
|
|
358
|
+
|
|
359
|
+
**REF Agents** is part of the **Relay Engineering Framework (REF)** — a methodology for collapsing the software delivery lifecycle through intelligent parallelism and agent orchestration.
|
|
360
|
+
|
|
361
|
+
---
|
|
362
|
+
|
|
363
|
+
## License
|
|
364
|
+
|
|
365
|
+
Proprietary. All rights reserved.
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
ref_agents/__init__.py,sha256=rJ3Z2pkjO9VtGDiuSd9OvcYCZkVdRY-8VlxpVfvhQ-Y,272
|
|
2
|
+
ref_agents/api_keys.json.example,sha256=At2bAk6-qzSdojHxsJg0E0f_YUQztF8XXC07P62ti3c,211
|
|
3
|
+
ref_agents/auth.py,sha256=iGk6ati0VntfvvgqtO3gKmNhuEC5cf3AMDN7gOwWVi0,4431
|
|
4
|
+
ref_agents/constants.py,sha256=CXqGenC1vMrjhVY8-RgsZaIsfRkSOqh8UW0cX0u_Yks,18260
|
|
5
|
+
ref_agents/errors.py,sha256=EyzeybM3z7OliEmuhYsa-535A3WU_0pJeC4-g7aF9t8,1073
|
|
6
|
+
ref_agents/license_client.py,sha256=Tev-TIyfTH_NM9yqwJUEEjQtwcaEZzgb53_SG0d9Ipg,8219
|
|
7
|
+
ref_agents/security_scan.py,sha256=qmhP6tAk2udOgGeutOrFckLKvah3N60wW546lalI9UY,7144
|
|
8
|
+
ref_agents/server.py,sha256=jUGGogMA1fQ1BREZRQXAlHa7Lf0q1a0Yz1vNC5kQJYM,56917
|
|
9
|
+
ref_agents/session.py,sha256=dXKYzbihWABmuE5TJLy9rESD22jdmGbumjIkP8R5S0U,3167
|
|
10
|
+
ref_agents/tool_names.py,sha256=ud0iS0mxHc6AZw5ZT_iMfMClN5qrlGffeAhHoZRZVpM,2821
|
|
11
|
+
ref_agents/codemap/..md,sha256=HcDquy37KsVDRMsuK8_3okoMFoKSAfeFhIakzPpJqdw,1688
|
|
12
|
+
ref_agents/codemap/CODE_MAP.md,sha256=T98VljPrVNNSdzOXJkhvUa1Udhx6ZmlgOYLtclFEf68,889
|
|
13
|
+
ref_agents/codemap/core.md,sha256=EbCGf4GrPm6cA4E50i1_z16lcmtr1zx3piDjNdOpOMA,1046
|
|
14
|
+
ref_agents/codemap/models.md,sha256=ZeOY8VyGquy1s4xlOheb9_eTT88wppRYORrFVeWJVgw,1020
|
|
15
|
+
ref_agents/codemap/prompts.md,sha256=quA6mi3aLUUu3HV1w0TPRe24-c42PO-KSG3LjoFpIUQ,913
|
|
16
|
+
ref_agents/codemap/security.md,sha256=W4vEQ0NCTymSbG2y6E4MBxP1YljYPJ7x-ThgkPbBWJ8,1126
|
|
17
|
+
ref_agents/codemap/tools.md,sha256=X8DOU-Hg2djle4MAE7t1MEXTS8q1nhsd7f2qlW6D6gY,3301
|
|
18
|
+
ref_agents/codemap/tools_browser.md,sha256=exst2wBQLs-wkJuCmuMfv4sjmXVWGgefbYNxC2fbacw,1111
|
|
19
|
+
ref_agents/codemap/utils.md,sha256=Q8cgcBYFO6Uu62pvGxNzNdwMfd50r90FCCjiOniOKhs,997
|
|
20
|
+
ref_agents/codemap/workflow.md,sha256=s1Mv-3TocgxrRe5Xs-JTIDbZJMcOrJvxkmKB8nSyBhE,999
|
|
21
|
+
ref_agents/config/ai_patterns.yaml,sha256=RjdgS_u4vze3H2Kid81hhGkTMxthIOp8JZL8iASFRiA,2508
|
|
22
|
+
ref_agents/config/frameworks/angular.yaml,sha256=ejwLYg9QKqAWLrHOPHjVBT-fJPQ9_YVly6XqpCIa45M,3188
|
|
23
|
+
ref_agents/config/frameworks/aspnet.yaml,sha256=C5vMCLDDW7fmq_guUemzMwZHfpLr1C5lk4JmqxWAnH8,3531
|
|
24
|
+
ref_agents/config/frameworks/ef_core.yaml,sha256=XtAo372lO41EKKPUpx6sERp9-yIA6kgePRBUrgo9aMo,3565
|
|
25
|
+
ref_agents/config/frameworks/react.yaml,sha256=4mlf121VQjIiVUljbOh8NoA1QMx5IkNSDaxIetb8sLA,3451
|
|
26
|
+
ref_agents/config/frameworks/spring_boot.yaml,sha256=mcjOCR7rT1ahKiNHWNQgkAhBdo9v5FvpkA_gZX_O7e8,3804
|
|
27
|
+
ref_agents/config/languages/csharp.yaml,sha256=KT22fVsgmvGs1NQj27Pc5pQYtfXCoOEpPqdQtRWm4oc,5244
|
|
28
|
+
ref_agents/config/languages/java.yaml,sha256=Noi21aUa9BQx_cJOse2ImV_1Cx0GD9NqaUMNucxfM8Y,5693
|
|
29
|
+
ref_agents/config/languages/javascript.yaml,sha256=0WcM-gfsuP6sFFW8N6Vy8baU_8l-88hmWU6dFOyjwro,4621
|
|
30
|
+
ref_agents/config/languages/python.yaml,sha256=TJPQ9k0QhFy4bUCfAjEpiEXwmf4X8fanvje7RDv1--Q,4004
|
|
31
|
+
ref_agents/config/languages/typescript.yaml,sha256=RIEstHa6mylYKK0wP-opQiuXgoPU3seuNfCpDU8Tq1g,5807
|
|
32
|
+
ref_agents/core/__init__.py,sha256=bj-bNnYsO9XfVVyhMOvBQD0vwP-M2DTQJWM0UhweFwc,398
|
|
33
|
+
ref_agents/core/config_loader.py,sha256=e6zeHGu9uPOPSTUMoYkzBQW_zGyFAmDFYvdvNnIKFWg,4702
|
|
34
|
+
ref_agents/core/config_models.py,sha256=ZQpITVsEL9YGbjzndx1a8inRM3DTQqPAh5HOn-VcL_w,5949
|
|
35
|
+
ref_agents/core/config_parsing.py,sha256=Pbutktk6r2i1-PboGDtNn34k3rZUV1eOU76OMpd4pno,2982
|
|
36
|
+
ref_agents/core/language_detector.py,sha256=Fh78GkbiO4kZVXGsCTLS05HP8h7oqn4msVsyapW5kL8,12131
|
|
37
|
+
ref_agents/core/validation_models.py,sha256=Kb1dKF-rvmm_Evfu5TR9E4Jfz-AWnwbQG3rx5q-BmGI,1857
|
|
38
|
+
ref_agents/core/validation_primitives.py,sha256=H3ZlHKL6eW9YRmzIndou6KfO3rKmuso2g0PInyY6I_Q,5346
|
|
39
|
+
ref_agents/models/__init__.py,sha256=jOTgXEVX6850P6zyRRTWiZHq43qRZ3dHdqinfQ4UlqE,597
|
|
40
|
+
ref_agents/models/gherkin.py,sha256=cXy9h8wuIhJav0ywseHLvzpuwA93caQGhn9qnQ0fAlY,1413
|
|
41
|
+
ref_agents/models/hierarchy.py,sha256=ozoa9jnGn73K1-iD92ewtNmmFAgJGZxEvna6H69AuXE,2903
|
|
42
|
+
ref_agents/models/invest.py,sha256=1zhGv-_1hCCP44dMP8oa-DFzZEZ9KQ0L7TnC0lCP4SE,1753
|
|
43
|
+
ref_agents/models/version.py,sha256=PNAapHoh2RzPx8IdNjuUwzUFWSVRhpobR8JtSZlgqGg,1611
|
|
44
|
+
ref_agents/prompts/__init__.py,sha256=seB_Hpys5wxkoscLroor0r7GM_CaxZ8pLzCYf-ShBok,254
|
|
45
|
+
ref_agents/prompts/start_agent.py,sha256=RgA_xo0x_EjIHLftQKBAbSWdAb3CcefPwuq12otRxIA,31520
|
|
46
|
+
ref_agents/rules/architecture/backend_patterns.md,sha256=rSGCauwKMSEgDsgCULcSEMvGBkJBvvwCnjhuMl5PHYk,1751
|
|
47
|
+
ref_agents/rules/architecture/diagramming.md,sha256=hCsAnNWAPzYjL56coSIer7USG_n5rJHsX825EBampFQ,2505
|
|
48
|
+
ref_agents/rules/architecture/frontend_patterns.md,sha256=xz93e8l-Lilb7S5taFIMUwsh7e-7HskoAFtawlYVVMA,1472
|
|
49
|
+
ref_agents/rules/architecture/impact_analysis.md,sha256=8gXev-k5jXsGAS8d5Ya5Omck7KJEUxuWCStozt52PAA,6102
|
|
50
|
+
ref_agents/rules/architecture/migration_strategy.md,sha256=16zk1QTiB-apD6oulHObcKckD26R4DqlxQ1Qo1ceLZE,6011
|
|
51
|
+
ref_agents/rules/architecture/regression_protocol.md,sha256=sF44tzKoRgFCjVdESm6JOkR_v6wWDbOYvRp1QPJ-Rqw,2514
|
|
52
|
+
ref_agents/rules/architecture/system_design.md,sha256=EhqEdpm6i1aLELUD5SOf-YGcYn3aSRUImRTO9Jodaa8,4861
|
|
53
|
+
ref_agents/rules/common/codemap_standard.md,sha256=kpJIsbIC5yxF4vv8q0jIIdl9ar0cT6WRgd4hAeCrKD8,4499
|
|
54
|
+
ref_agents/rules/common/core_protocol.md,sha256=oQSP4PWN2rxg0INuYvUofgw1C6AbWq_2XNu9PbLNgFo,4133
|
|
55
|
+
ref_agents/rules/common/prompt_engineering.md,sha256=mxRDJEIxA9QZ_4cXU5jnBv2ZE_rbAwTjAq9grQ6Z42M,7595
|
|
56
|
+
ref_agents/rules/development/debugging.md,sha256=96Tg1YNFeBl4IA9T5NYr8VxZXFPUNPnZldoUTIr0vSY,772
|
|
57
|
+
ref_agents/rules/development/implementation.md,sha256=M1K3pFFBJVC90cfDgr0czmQiX__Z0kfrIgNG-K9kY7M,14589
|
|
58
|
+
ref_agents/rules/operations/completion.md,sha256=bajEeLfhXEPHMOH7kZWS0EmevuiGA3tuy2Gl-thvCgE,4693
|
|
59
|
+
ref_agents/rules/operations/cutover_protocol.md,sha256=0GKQkSzQQ4f_AHBMx0fH-U7p8oD_kvX2m1xgM_CDlSk,7372
|
|
60
|
+
ref_agents/rules/operations/discovery.md,sha256=qL0Xs-mGOj6WrF8ACS2myIG3fHpDHZTpE2BfFBhweks,6367
|
|
61
|
+
ref_agents/rules/operations/fix_workflow.md,sha256=lt9NhQJZwURkjIjw4UQoGgInlM5nGlM7sCUkV7B_jRA,2893
|
|
62
|
+
ref_agents/rules/operations/forensics.md,sha256=gKweKifZFBjR82ldnw7CDfwGP3JCYLiFX3lHFIvME1s,9776
|
|
63
|
+
ref_agents/rules/operations/platform.md,sha256=sJo0vyTFVwaUvRnuhzs74fQMTHT4zCRN5V9azWobbLE,10064
|
|
64
|
+
ref_agents/rules/operations/synchronous_flow.md,sha256=3Kl4bmsUn2SxJV1V_BFcaQo7Ohm49iZccP3P1V2cSmk,1004
|
|
65
|
+
ref_agents/rules/product/ac_validation.md,sha256=3_117GFu8lwwFFp1mUFKo59JY7lGuixAlxYkD6MmSgA,980
|
|
66
|
+
ref_agents/rules/product/brainstorming.md,sha256=rxUvyBc_qc7I2VU0AbAUXwTNolQ9cgMsIuF6qTTaMak,838
|
|
67
|
+
ref_agents/rules/product/ref_flow.md,sha256=lkf3yPv-t2pFNA4ey5cDAj7uvgvKXvrrsCDFBw27Jmk,4292
|
|
68
|
+
ref_agents/rules/product/requirements_std.md,sha256=m5K-B5rxEznQmbVjBUudxDg5Tmc3B9d7a8dZ1ZGrM1s,4334
|
|
69
|
+
ref_agents/rules/product/spec_writing.md,sha256=m7BDqvKJuEf55OAc9LiTPGMbajFeUQVd0aiDpibDjys,9025
|
|
70
|
+
ref_agents/rules/product/strategy.md,sha256=7mFAh613QGFUZvwrfzguAlyNBXzTKoGKYtxURT0TdC4,4411
|
|
71
|
+
ref_agents/rules/quality/documentation_standards.md,sha256=rjBxxEqaaOvTUIRtFAleubuamxTtwKDRBV6JM6_x6rk,1680
|
|
72
|
+
ref_agents/rules/quality/parity_testing.md,sha256=TLNwzcAXv8qvxbw-HsiY60gaVOFNucAbya46DE1x6qM,7829
|
|
73
|
+
ref_agents/rules/quality/project_documentation.md,sha256=_Fz1dxhmYmI2PDMM8F47LlQSgodM10vUtIxcrN7PDGs,2621
|
|
74
|
+
ref_agents/rules/quality/qa_lead.md,sha256=HYIJZMTzfkMJlA32ouX11yXuJuCx7QILaahKzM4OXsk,4133
|
|
75
|
+
ref_agents/rules/quality/test_design.md,sha256=2G3-Iw2dsYNH7izJMU81BAQfyV8CjnCxGZPJmS3IPrs,6930
|
|
76
|
+
ref_agents/rules/quality/testing_standards.md,sha256=8WvpJH1LbVocoCUf4SlEgAgBGVgVBspBFAJt3M7fCYw,14742
|
|
77
|
+
ref_agents/rules/review/pr_review.md,sha256=008TnviX-IlDfkr4IhJFhRT-iO5tS9tfWe_VnvbeMBo,6220
|
|
78
|
+
ref_agents/rules/security/security_audit.md,sha256=f0vTowEph6ml0U2BDkn8SXNFp44oGe8qfVdPpfCEhh0,2691
|
|
79
|
+
ref_agents/security/__init__.py,sha256=lZ2cinFI1dK6sJq-ALTy12JREYym1uCuOIUTVJu_WbA,742
|
|
80
|
+
ref_agents/security/dependency_audit.py,sha256=pQhUfVWHv2I8q0whP9ezs729cx8X91_1P-5mkpECQo4,5194
|
|
81
|
+
ref_agents/security/file_audit.py,sha256=XQ4I61nWd4vWQdm_nsQ7ZJBjqGa_BZ4qTml4sNz97j8,5549
|
|
82
|
+
ref_agents/security/network_scan.py,sha256=XBAkCBTszVuy4JzQMxwBOXWLr76wQs4RCTkyz2c4M_Q,4828
|
|
83
|
+
ref_agents/security/report_generator.py,sha256=1cWEVK4qKc0nAaZ26-h8Smo3VvzdzjXF3zNL7pIjgJk,12332
|
|
84
|
+
ref_agents/security/secret_scan.py,sha256=1TZZ3o7Y4WvotEIvrjctSoAocq3NMnd040XeVcYf7lQ,7069
|
|
85
|
+
ref_agents/security/url_scan.py,sha256=JwHF7suv8VzqvoR2mc70fQThK9VLf9_j31b6ztnDamM,8126
|
|
86
|
+
ref_agents/tools/__init__.py,sha256=Ydx7sl0DxJw-bOrgugMe39DHHXSbFuEJN05QFNIaV1g,218
|
|
87
|
+
ref_agents/tools/agents_generator.py,sha256=OYruy2BHitawh0mgZHsFdrWL3h-qsSZECKQZ0Sba-gU,14878
|
|
88
|
+
ref_agents/tools/ai_pattern_detector.py,sha256=x20IqBWVTdlakuH34MJHLjV07gOFbIsLPSiQJKlDb4I,27799
|
|
89
|
+
ref_agents/tools/brownfield_populator.py,sha256=bH9f9CDe256YYJ1LlAXQRlhNfderRvzNv9c16VLkYeI,18292
|
|
90
|
+
ref_agents/tools/code_quality_scanner.py,sha256=MJX9TKtSEwMvF5zV52cknHOWQJxyjw-a6dI-pa43wsM,20746
|
|
91
|
+
ref_agents/tools/codemap.py,sha256=jhWTyWmwI0cYxuT60-a2ywERp0iGFGw6GmO5yvRy9oE,11445
|
|
92
|
+
ref_agents/tools/codemap_freshness.py,sha256=S6YUu_3F8JhTQ0SLBlcDpof9VhCpDzEruubAbQGSrdI,7996
|
|
93
|
+
ref_agents/tools/comment_smell_scanner.py,sha256=VcyP-u1HKZCTuJ3myWrRyE9c2fGx_g7szCbHxldkfmI,10615
|
|
94
|
+
ref_agents/tools/complexity.py,sha256=3j0NN1lOvQU3pDjimH3EvL7opwaSwfO4UhTvNSRkEME,15676
|
|
95
|
+
ref_agents/tools/complexity_ast.py,sha256=9k-UpUtt-Em047ejlu0L3p9l6bCTk-F2WFB7vHTY48o,10622
|
|
96
|
+
ref_agents/tools/compliance.py,sha256=jg6a6BqR07oFbcPfnZqDuYCrTg6wpKsQbW33flQSwow,9402
|
|
97
|
+
ref_agents/tools/compliance_remediation.py,sha256=sXuJDtMOQt6gw_hWtrjUcFhPj6DSY4HtZwXrFNSQaGQ,28831
|
|
98
|
+
ref_agents/tools/context_graph.py,sha256=-HZH6h1_SottBLg89o6Y0k0OP-CEwxC8nnVX9Lt6b8Y,27533
|
|
99
|
+
ref_agents/tools/context_manager.py,sha256=RukCWABgnp6qaxV4mWvkKA_QhQmyajG8CsIF5RGUEis,17756
|
|
100
|
+
ref_agents/tools/context_tools.py,sha256=rObRJhK3aJpqiqbccDvnubZMsvIC2uqUzE8MtyarBPA,4333
|
|
101
|
+
ref_agents/tools/cross_repo_linker.py,sha256=TWm2EWzaYDyBhLEsDBYDpQclWu8iZ6zfEEFqagxzSmM,12018
|
|
102
|
+
ref_agents/tools/dead_code_scanner.py,sha256=8r5I_E8lqG9moOmiraLAOM_Z976CKBSa2oTW0ElbGho,21362
|
|
103
|
+
ref_agents/tools/debt_scanner.py,sha256=9yPjiPbL_FyQaot4ZbMd8x27vGIJhS6ZAX8PJibfccE,34182
|
|
104
|
+
ref_agents/tools/dependency_graph.py,sha256=QSwJ25uAVXoHem-2kkGex-Yp0cFyHBlF1VOw4LezWWQ,7799
|
|
105
|
+
ref_agents/tools/discovery_audit.py,sha256=qjTYxUZo0qToYFf6LIqGDWLT_9dSn4asbDNQR5bDU2U,11406
|
|
106
|
+
ref_agents/tools/docs_scanner.py,sha256=ocwXgt2ZpHeqeAyqu0MSaw48_n2veqkg-gTphA2z4Wc,20928
|
|
107
|
+
ref_agents/tools/evaluate_gate.py,sha256=B04IxDL-wSbyanjoEOoZ-WadYepzlp1Hj0e6kRgKpF0,3565
|
|
108
|
+
ref_agents/tools/external_detector.py,sha256=WYP7eKFsXFVJG-jrUPQeEAF3B5o5IcJ850JTGX6-77E,16425
|
|
109
|
+
ref_agents/tools/features_generator.py,sha256=Y8vKxaipqBjMMfceWChhhd7gXnR8xmO_ibTCe2YoRMs,7240
|
|
110
|
+
ref_agents/tools/flow_gap_detector.py,sha256=r2CS-oLfriEOnjJE_-CejATvXsze_m1a_uP8HGVaZeA,12301
|
|
111
|
+
ref_agents/tools/flow_mapper.py,sha256=KRQi9hedmeC9iskI2g2PdAuNeg1vc4mmpDFcLK1vYy8,9866
|
|
112
|
+
ref_agents/tools/full_suite_runner.py,sha256=7lnIPl03_JRE6D6y-MSff_aAOj73RpCofS6PTxsZ_z4,23608
|
|
113
|
+
ref_agents/tools/gherkin_parser.py,sha256=BttoR1R7eKLkAfOhwGOHmgW6X3HyFP1I1jXdP_LVzU8,6790
|
|
114
|
+
ref_agents/tools/guard_tools.py,sha256=EMWcKVhcDf4uAswY8fqITPvmhOOIOoYqyrjbUA8PE3U,5093
|
|
115
|
+
ref_agents/tools/handoff_tools.py,sha256=f9OOvpQnFVUAlA-U4tRhYhyhWuxZHMnmXth8cjLDMJ4,8349
|
|
116
|
+
ref_agents/tools/health_scanner.py,sha256=HxtF8zpWJokpMq4DFdIYKZKA7ayjQCqtnS8eqdWzaAs,41300
|
|
117
|
+
ref_agents/tools/hierarchy_manager.py,sha256=gKVPwCoc-nrrs_o6rG3boCOVIlPAQLJ4CgHFr-aHndk,7796
|
|
118
|
+
ref_agents/tools/invest_scorer.py,sha256=9nI2U8CjubulrK0gXzpEouxvAGwS3Ry4k67D_6WJgRA,7843
|
|
119
|
+
ref_agents/tools/jira_confluence_export.py,sha256=zq_sTlciKM2aTxUdbA39EB9BQW8bvpzto6iGBcjjgLY,9055
|
|
120
|
+
ref_agents/tools/json_output.py,sha256=QtwVEBo0vAL-bqDa0LMD67pIhNK6upDqvQUHbVW5c-w,2031
|
|
121
|
+
ref_agents/tools/migration_mapper.py,sha256=3O66IeduPEAvDhC4pFXRTEMMbyJhonttYLnvvlxKDAs,30993
|
|
122
|
+
ref_agents/tools/migration_readiness_scanner.py,sha256=W3b99DiX0CXz3mdQmpKAoLE60c-DyM6Gi1AeXb_8ptk,6394
|
|
123
|
+
ref_agents/tools/pattern_learner.py,sha256=ORcjDHYYlpeiu_jBllwgaKz3TLgp2oj6tRkwHX14f_U,16368
|
|
124
|
+
ref_agents/tools/report_utils.py,sha256=xr5miY3SQPd25ro960O8dBINVyTtAApvnVU6dZNhPqQ,4451
|
|
125
|
+
ref_agents/tools/requirements_serializer.py,sha256=FGBIBHOCLhWhxsYpnH7G040FEY93QnSauYlAVkwIRzE,7447
|
|
126
|
+
ref_agents/tools/security_audit_tool.py,sha256=dz8tIOS0UzoBG6TyRujiQ39K9QFmfssgRBWYxY66yRM,3503
|
|
127
|
+
ref_agents/tools/sequencing_engine.py,sha256=-Hby_s9YYRq-t_aeWGWRntPUE7PoWWJIy43L8BPaI_o,7749
|
|
128
|
+
ref_agents/tools/summary_generator.py,sha256=0CVh6c8zn4ff-Dke6fbtMxlzyHy2__Il-iYTkCLyd9k,8103
|
|
129
|
+
ref_agents/tools/symbol_resolver.py,sha256=Z_oUhV81SsjNaQ-RnodaLZdM-Mhx0QqREXBDU21bsYQ,9980
|
|
130
|
+
ref_agents/tools/symbol_smoke_runner.py,sha256=1Qwil_Kk4hn7mTwU7zX8WjKGYiXJL61Rwl2D5YuPGoY,11604
|
|
131
|
+
ref_agents/tools/test_plan_validator.py,sha256=q_BBdsYzFYMzllu5lKPJTSMD-sc5a61NCqPft1_lMsE,5825
|
|
132
|
+
ref_agents/tools/test_smell_walker.py,sha256=Ef82nj1Dsm2rQLW8jZgYeKPOFWKYd6WvLNI7mBDzOPw,31356
|
|
133
|
+
ref_agents/tools/tier1_fixer.py,sha256=jWspsVtVNZaTr-8LDQVm-rSMeZYuCyDQKQ0ohSNTP8I,16181
|
|
134
|
+
ref_agents/tools/version_manager.py,sha256=R8MQORJY-onYH3QqNvleAVmN5X-8AW_wrNmULj5dbik,6110
|
|
135
|
+
ref_agents/tools/workflow_tools.py,sha256=oJnFA9FYuO_AGtPon8okrIcPkGkIqGdfW6_dVcLOHYQ,53356
|
|
136
|
+
ref_agents/tools/browser/__init__.py,sha256=a0UU-p8nCODiLWkjCH3WuNyp6g-E1cytabEcch0T_sQ,1383
|
|
137
|
+
ref_agents/tools/browser/evidence_verifier.py,sha256=TUaFAH5wkPfqui8BnrO0MYr3hAJqQ8FvaK8pbxaczZw,10107
|
|
138
|
+
ref_agents/tools/browser/execution_logger.py,sha256=8UFeGgUzri7zQmEauy_WqZ0UhYmZsQoR7Fuc4ki85CY,7509
|
|
139
|
+
ref_agents/tools/browser/playwright_mcp_client.py,sha256=be3x3ihIazAisGGex_x_73u5Y_p4tLigR5KG6cSdjdc,7532
|
|
140
|
+
ref_agents/tools/browser/screenshot_utils.py,sha256=3Ambhy9GAvUOlu4q_MAr8f6VJQOz_yWJdO6ALswgEU8,4996
|
|
141
|
+
ref_agents/tools/browser/test_executor.py,sha256=A0V8iNiz5zr51S690vJThaaIURgV8MmVIDedQEG2WoU,17462
|
|
142
|
+
ref_agents/tools/codemap/..md,sha256=7XdTbQGh-GVCJiCtKgZ-e7bU7sz4dn_aG9An1dDVHQ8,3248
|
|
143
|
+
ref_agents/tools/codemap/CODE_MAP.md,sha256=jfJ0P5lYPSMp7M2ORQdZcOjLyjtSb6rO0f7ZD8GjDYI,547
|
|
144
|
+
ref_agents/tools/codemap/browser.md,sha256=SiUVjGTulmsC08idNBFsgZuEuP2vGczsFr5VATkjqAE,1105
|
|
145
|
+
ref_agents/tools/validators/__init__.py,sha256=9C6rZe84hdPzFmTJF0-thtVgX_7o77OFA_FqA3C0fH8,13983
|
|
146
|
+
ref_agents/tools/validators/architect.py,sha256=R0ODCsRj6QdUn0gfbe5Ak6bmKUc-SAWZloTJaZBgJs0,8017
|
|
147
|
+
ref_agents/tools/validators/cutover_engineer.py,sha256=ABTEFVbChVzGuRGecikRYKVz-SBxzWnB0MEagMZeZhc,5101
|
|
148
|
+
ref_agents/tools/validators/developer.py,sha256=NB_bMx7xVxuqW2Di1Hfvw6Rjfi7dKjkSSRlMlNMzHMk,5757
|
|
149
|
+
ref_agents/tools/validators/discovery.py,sha256=tV_rnwutYRWRcyZc-Iaw8pXxJmHLi24m2aP3OXIbB94,4952
|
|
150
|
+
ref_agents/tools/validators/forensic_engineer.py,sha256=IkCeg8fYMeWpH_MfB21Cv677IO_7f-pLl0TnleDfjY0,5763
|
|
151
|
+
ref_agents/tools/validators/impact_architect.py,sha256=PMu8KjB36HDN2WteCyfcSZb_73m60TcUW8-Ul_4VqPo,5634
|
|
152
|
+
ref_agents/tools/validators/migration_planner.py,sha256=vj2V9wVdzd7y0nRxG5RKF6PAKdZhgbD-lRrJcoQw2EE,5088
|
|
153
|
+
ref_agents/tools/validators/parity_tester.py,sha256=klK7l4dLLrVb70jo5dhyQENcyLy3pvmoj4UOIjBzZfg,5079
|
|
154
|
+
ref_agents/tools/validators/platform_engineer.py,sha256=sZjgAhF9Dn6nVLZvHFAg-4XcoB9PQRlzDtFO-J_jhkw,4111
|
|
155
|
+
ref_agents/tools/validators/pr_reviewer.py,sha256=14XmUMiqZR3f6hv6W5CMp0sBbP9h5f1MB2xMhVlmaEE,3903
|
|
156
|
+
ref_agents/tools/validators/product_manager.py,sha256=x7aTz7OX1W3Rvazif4RyLJIFi6Ff56J1OYGG9nZuAbc,8756
|
|
157
|
+
ref_agents/tools/validators/qa_lead.py,sha256=0_oOj_wpYQIbTIFzVIexsTPLiQNG0hh5FbArXsU0xjw,5279
|
|
158
|
+
ref_agents/tools/validators/scrum_master.py,sha256=ayd_CjniY2lQzeNxEjBLYH8DXkkJf5gxzeUaoq3XiyU,6835
|
|
159
|
+
ref_agents/tools/validators/security_owner.py,sha256=uPUOzO9oYUU24lAEZ0bYoYsmTDws85NmPQ9Q3x5Z48M,4883
|
|
160
|
+
ref_agents/tools/validators/specifier.py,sha256=Yhba2bOZLBe3AXKT1sOpKvlMW7VAOx8CQJtRmlkgPyE,4127
|
|
161
|
+
ref_agents/tools/validators/strategist.py,sha256=bY38IJ9k4D8PGIKD71q_4067U1e62kPZ5O0jjCr7uBA,4348
|
|
162
|
+
ref_agents/tools/validators/tester.py,sha256=4QoliPg7tveU4Ay3GOn0XSQcvPeLsHM64_m3gHjeXZ0,3649
|
|
163
|
+
ref_agents/utils/__init__.py,sha256=ublncKGmSJOsXN_qzD4F0LJpgKHKtna1IspH3iuaqAE,387
|
|
164
|
+
ref_agents/utils/git_utils.py,sha256=2oEdEShwsl1hQIjyDYf8SXxsBvBOOLH1sh3hcdAUQWE,9942
|
|
165
|
+
ref_agents/utils/handoff_logger.py,sha256=hyMLEX8RBvvWxaCBSJgmYV-Lb2-7c9SQ-Rl61IrxaTk,9973
|
|
166
|
+
ref_agents/utils/ignore_matcher.py,sha256=dieJENDa-qjxv6nKEyLMfPUheTpk_Ed_-dN6o9Mmfos,8207
|
|
167
|
+
ref_agents/workflow/__init__.py,sha256=OX0kYr_ASBCLyNRTBs0w37H1B_HVGehITj6rs8yUQl4,548
|
|
168
|
+
ref_agents/workflow/capabilities.py,sha256=DMugYKG0V15AeFrGXJNn9UruVmi66JBvdg1NRQgpOYA,10867
|
|
169
|
+
ref_agents/workflow/state_machine.py,sha256=A061QrODnD9eJWV1Df-2bZxvV1meIHG3TZXoI4nxIXE,21404
|
|
170
|
+
ref_agents/workflow/transitions.py,sha256=2QtHvBWHPFQdtZN88Cw6-OJTvQ00pTrCCd2SLUxhP70,23590
|
|
171
|
+
ref_agents-1.0.0.dist-info/METADATA,sha256=UfUFMgMy5uySsTtZFV11FCbkRDCE8b9Nmi_vcAE0xNo,10661
|
|
172
|
+
ref_agents-1.0.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
|
|
173
|
+
ref_agents-1.0.0.dist-info/entry_points.txt,sha256=dZte1RKehYEDXwet29Umx1Oqdng-DpzS6SuZv8GfihI,54
|
|
174
|
+
ref_agents-1.0.0.dist-info/licenses/LICENSE,sha256=kSBj8tHjtzMKwLkQ5nFoEjPYpzEgkw_imyMELcnoBGA,8162
|
|
175
|
+
ref_agents-1.0.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
REF AGENTS — END USER LICENSE AGREEMENT (EULA)
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Mishtert T. All rights reserved.
|
|
4
|
+
|
|
5
|
+
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE INSTALLING OR USING THIS SOFTWARE.
|
|
6
|
+
BY INSTALLING, COPYING, OR OTHERWISE USING REF AGENTS, YOU AGREE TO BE BOUND
|
|
7
|
+
BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT INSTALL OR USE THE
|
|
8
|
+
SOFTWARE.
|
|
9
|
+
|
|
10
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
11
|
+
1. DEFINITIONS
|
|
12
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
13
|
+
|
|
14
|
+
"Software" means REF Agents and all associated files, documentation, and
|
|
15
|
+
updates provided under this Agreement.
|
|
16
|
+
|
|
17
|
+
"Licensor" means Mishtert T, the sole copyright holder.
|
|
18
|
+
|
|
19
|
+
"Subscriber" means any individual or entity that has purchased an active
|
|
20
|
+
paid subscription to REF Agents through the official channel (ref.dev).
|
|
21
|
+
|
|
22
|
+
"Free User" means any individual using the Software under the free tier
|
|
23
|
+
without a paid subscription.
|
|
24
|
+
|
|
25
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
26
|
+
2. GRANT OF LICENSE
|
|
27
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
28
|
+
|
|
29
|
+
Subject to the terms of this Agreement, Licensor grants you a limited,
|
|
30
|
+
non-exclusive, non-transferable, non-sublicensable license to:
|
|
31
|
+
|
|
32
|
+
(a) FREE TIER: Install and use the Software's scanner tools and workflow
|
|
33
|
+
features for personal, evaluation, or commercial projects. Free tier
|
|
34
|
+
features are available without a subscription.
|
|
35
|
+
|
|
36
|
+
(b) PAID TIER (Subscribers only): Access the full Software including all
|
|
37
|
+
19 expert agent personas, governance rules, and premium configurations,
|
|
38
|
+
subject to maintaining an active paid subscription at ref.dev.
|
|
39
|
+
|
|
40
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
41
|
+
3. RESTRICTIONS
|
|
42
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
43
|
+
|
|
44
|
+
You may NOT, without express prior written permission from Licensor:
|
|
45
|
+
|
|
46
|
+
(a) Copy, modify, merge, publish, distribute, sublicense, or sell copies
|
|
47
|
+
of the Software or any portion of it;
|
|
48
|
+
|
|
49
|
+
(b) Reverse engineer, decompile, or disassemble the Software;
|
|
50
|
+
|
|
51
|
+
(c) Remove or alter any proprietary notices, labels, or marks;
|
|
52
|
+
|
|
53
|
+
(d) Use the Software to build a competing product or service;
|
|
54
|
+
|
|
55
|
+
(e) Share, transfer, or resell your API key or subscription credentials;
|
|
56
|
+
|
|
57
|
+
(f) Circumvent, disable, or interfere with license enforcement mechanisms.
|
|
58
|
+
|
|
59
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
60
|
+
4. SUBSCRIPTION AND PAYMENT
|
|
61
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
62
|
+
|
|
63
|
+
Paid tier features require an active subscription purchased at ref.dev.
|
|
64
|
+
Subscriptions are billed monthly or annually. Cancellation takes effect at
|
|
65
|
+
the end of the current billing period. Licensor reserves the right to modify
|
|
66
|
+
pricing with 30 days notice to active subscribers.
|
|
67
|
+
|
|
68
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
69
|
+
5. INTELLECTUAL PROPERTY
|
|
70
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
71
|
+
|
|
72
|
+
The Software, including all agent prompts, governance rules, configurations,
|
|
73
|
+
algorithms, and documentation, is and remains the sole and exclusive property
|
|
74
|
+
of Licensor. This Agreement does not transfer any ownership rights.
|
|
75
|
+
|
|
76
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
77
|
+
6. DISCLAIMER OF WARRANTIES
|
|
78
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
79
|
+
|
|
80
|
+
THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
81
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
|
|
82
|
+
FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
|
|
83
|
+
|
|
84
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
85
|
+
7. LIMITATION OF LIABILITY
|
|
86
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
87
|
+
|
|
88
|
+
IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
|
|
89
|
+
CONSEQUENTIAL, OR PUNITIVE DAMAGES ARISING OUT OF OR RELATED TO YOUR USE OF
|
|
90
|
+
THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. LICENSOR'S
|
|
91
|
+
TOTAL LIABILITY SHALL NOT EXCEED THE AMOUNT PAID BY YOU IN THE 12 MONTHS
|
|
92
|
+
PRECEDING THE CLAIM.
|
|
93
|
+
|
|
94
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
95
|
+
8. TERMINATION
|
|
96
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
97
|
+
|
|
98
|
+
This Agreement is effective until terminated. Licensor may terminate this
|
|
99
|
+
Agreement immediately if you breach any of its terms. Upon termination, you
|
|
100
|
+
must cease all use and destroy all copies of the Software.
|
|
101
|
+
|
|
102
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
103
|
+
9. GOVERNING LAW
|
|
104
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
105
|
+
|
|
106
|
+
This Agreement shall be governed by and construed in accordance with
|
|
107
|
+
applicable law. Any disputes shall be resolved in the jurisdiction where
|
|
108
|
+
Licensor is domiciled.
|
|
109
|
+
|
|
110
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
111
|
+
10. CONTACT
|
|
112
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
113
|
+
|
|
114
|
+
For licensing inquiries: Mishtert.Thangaraj@myridius.com
|
|
115
|
+
Subscriptions and pricing: https://ref.dev
|