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.
Files changed (175) hide show
  1. ref_agents/__init__.py +9 -0
  2. ref_agents/api_keys.json.example +8 -0
  3. ref_agents/auth.py +129 -0
  4. ref_agents/codemap/..md +62 -0
  5. ref_agents/codemap/CODE_MAP.md +37 -0
  6. ref_agents/codemap/core.md +43 -0
  7. ref_agents/codemap/models.md +43 -0
  8. ref_agents/codemap/prompts.md +40 -0
  9. ref_agents/codemap/security.md +45 -0
  10. ref_agents/codemap/tools.md +94 -0
  11. ref_agents/codemap/tools_browser.md +44 -0
  12. ref_agents/codemap/utils.md +42 -0
  13. ref_agents/codemap/workflow.md +42 -0
  14. ref_agents/config/ai_patterns.yaml +101 -0
  15. ref_agents/config/frameworks/angular.yaml +104 -0
  16. ref_agents/config/frameworks/aspnet.yaml +84 -0
  17. ref_agents/config/frameworks/ef_core.yaml +81 -0
  18. ref_agents/config/frameworks/react.yaml +111 -0
  19. ref_agents/config/frameworks/spring_boot.yaml +117 -0
  20. ref_agents/config/languages/csharp.yaml +153 -0
  21. ref_agents/config/languages/java.yaml +188 -0
  22. ref_agents/config/languages/javascript.yaml +172 -0
  23. ref_agents/config/languages/python.yaml +153 -0
  24. ref_agents/config/languages/typescript.yaml +193 -0
  25. ref_agents/constants.py +553 -0
  26. ref_agents/core/__init__.py +15 -0
  27. ref_agents/core/config_loader.py +160 -0
  28. ref_agents/core/config_models.py +167 -0
  29. ref_agents/core/config_parsing.py +84 -0
  30. ref_agents/core/language_detector.py +388 -0
  31. ref_agents/core/validation_models.py +66 -0
  32. ref_agents/core/validation_primitives.py +176 -0
  33. ref_agents/errors.py +34 -0
  34. ref_agents/license_client.py +247 -0
  35. ref_agents/models/__init__.py +22 -0
  36. ref_agents/models/gherkin.py +45 -0
  37. ref_agents/models/hierarchy.py +80 -0
  38. ref_agents/models/invest.py +59 -0
  39. ref_agents/models/version.py +49 -0
  40. ref_agents/prompts/__init__.py +9 -0
  41. ref_agents/prompts/start_agent.py +772 -0
  42. ref_agents/rules/architecture/backend_patterns.md +43 -0
  43. ref_agents/rules/architecture/diagramming.md +100 -0
  44. ref_agents/rules/architecture/frontend_patterns.md +40 -0
  45. ref_agents/rules/architecture/impact_analysis.md +129 -0
  46. ref_agents/rules/architecture/migration_strategy.md +208 -0
  47. ref_agents/rules/architecture/regression_protocol.md +77 -0
  48. ref_agents/rules/architecture/system_design.md +97 -0
  49. ref_agents/rules/common/codemap_standard.md +97 -0
  50. ref_agents/rules/common/core_protocol.md +59 -0
  51. ref_agents/rules/common/prompt_engineering.md +294 -0
  52. ref_agents/rules/development/debugging.md +32 -0
  53. ref_agents/rules/development/implementation.md +205 -0
  54. ref_agents/rules/operations/completion.md +119 -0
  55. ref_agents/rules/operations/cutover_protocol.md +218 -0
  56. ref_agents/rules/operations/discovery.md +179 -0
  57. ref_agents/rules/operations/fix_workflow.md +87 -0
  58. ref_agents/rules/operations/forensics.md +278 -0
  59. ref_agents/rules/operations/platform.md +263 -0
  60. ref_agents/rules/operations/synchronous_flow.md +25 -0
  61. ref_agents/rules/product/ac_validation.md +25 -0
  62. ref_agents/rules/product/brainstorming.md +27 -0
  63. ref_agents/rules/product/ref_flow.md +101 -0
  64. ref_agents/rules/product/requirements_std.md +114 -0
  65. ref_agents/rules/product/spec_writing.md +235 -0
  66. ref_agents/rules/product/strategy.md +96 -0
  67. ref_agents/rules/quality/documentation_standards.md +46 -0
  68. ref_agents/rules/quality/parity_testing.md +234 -0
  69. ref_agents/rules/quality/project_documentation.md +56 -0
  70. ref_agents/rules/quality/qa_lead.md +111 -0
  71. ref_agents/rules/quality/test_design.md +146 -0
  72. ref_agents/rules/quality/testing_standards.md +293 -0
  73. ref_agents/rules/review/pr_review.md +116 -0
  74. ref_agents/rules/security/security_audit.md +83 -0
  75. ref_agents/security/__init__.py +22 -0
  76. ref_agents/security/dependency_audit.py +188 -0
  77. ref_agents/security/file_audit.py +208 -0
  78. ref_agents/security/network_scan.py +179 -0
  79. ref_agents/security/report_generator.py +313 -0
  80. ref_agents/security/secret_scan.py +252 -0
  81. ref_agents/security/url_scan.py +240 -0
  82. ref_agents/security_scan.py +236 -0
  83. ref_agents/server.py +1586 -0
  84. ref_agents/session.py +100 -0
  85. ref_agents/tool_names.py +55 -0
  86. ref_agents/tools/__init__.py +8 -0
  87. ref_agents/tools/agents_generator.py +315 -0
  88. ref_agents/tools/ai_pattern_detector.py +815 -0
  89. ref_agents/tools/brownfield_populator.py +529 -0
  90. ref_agents/tools/browser/__init__.py +50 -0
  91. ref_agents/tools/browser/evidence_verifier.py +302 -0
  92. ref_agents/tools/browser/execution_logger.py +249 -0
  93. ref_agents/tools/browser/playwright_mcp_client.py +259 -0
  94. ref_agents/tools/browser/screenshot_utils.py +184 -0
  95. ref_agents/tools/browser/test_executor.py +537 -0
  96. ref_agents/tools/code_quality_scanner.py +629 -0
  97. ref_agents/tools/codemap/..md +93 -0
  98. ref_agents/tools/codemap/CODE_MAP.md +30 -0
  99. ref_agents/tools/codemap/browser.md +44 -0
  100. ref_agents/tools/codemap.py +403 -0
  101. ref_agents/tools/codemap_freshness.py +234 -0
  102. ref_agents/tools/comment_smell_scanner.py +346 -0
  103. ref_agents/tools/complexity.py +436 -0
  104. ref_agents/tools/complexity_ast.py +333 -0
  105. ref_agents/tools/compliance.py +246 -0
  106. ref_agents/tools/compliance_remediation.py +846 -0
  107. ref_agents/tools/context_graph.py +839 -0
  108. ref_agents/tools/context_manager.py +550 -0
  109. ref_agents/tools/context_tools.py +121 -0
  110. ref_agents/tools/cross_repo_linker.py +393 -0
  111. ref_agents/tools/dead_code_scanner.py +637 -0
  112. ref_agents/tools/debt_scanner.py +1092 -0
  113. ref_agents/tools/dependency_graph.py +272 -0
  114. ref_agents/tools/discovery_audit.py +372 -0
  115. ref_agents/tools/docs_scanner.py +600 -0
  116. ref_agents/tools/evaluate_gate.py +119 -0
  117. ref_agents/tools/external_detector.py +524 -0
  118. ref_agents/tools/features_generator.py +282 -0
  119. ref_agents/tools/flow_gap_detector.py +373 -0
  120. ref_agents/tools/flow_mapper.py +327 -0
  121. ref_agents/tools/full_suite_runner.py +740 -0
  122. ref_agents/tools/gherkin_parser.py +227 -0
  123. ref_agents/tools/guard_tools.py +139 -0
  124. ref_agents/tools/handoff_tools.py +282 -0
  125. ref_agents/tools/health_scanner.py +1211 -0
  126. ref_agents/tools/hierarchy_manager.py +289 -0
  127. ref_agents/tools/invest_scorer.py +249 -0
  128. ref_agents/tools/jira_confluence_export.py +306 -0
  129. ref_agents/tools/json_output.py +76 -0
  130. ref_agents/tools/migration_mapper.py +946 -0
  131. ref_agents/tools/migration_readiness_scanner.py +209 -0
  132. ref_agents/tools/pattern_learner.py +522 -0
  133. ref_agents/tools/report_utils.py +155 -0
  134. ref_agents/tools/requirements_serializer.py +225 -0
  135. ref_agents/tools/security_audit_tool.py +106 -0
  136. ref_agents/tools/sequencing_engine.py +288 -0
  137. ref_agents/tools/summary_generator.py +275 -0
  138. ref_agents/tools/symbol_resolver.py +306 -0
  139. ref_agents/tools/symbol_smoke_runner.py +336 -0
  140. ref_agents/tools/test_plan_validator.py +189 -0
  141. ref_agents/tools/test_smell_walker.py +902 -0
  142. ref_agents/tools/tier1_fixer.py +502 -0
  143. ref_agents/tools/validators/__init__.py +419 -0
  144. ref_agents/tools/validators/architect.py +268 -0
  145. ref_agents/tools/validators/cutover_engineer.py +167 -0
  146. ref_agents/tools/validators/developer.py +180 -0
  147. ref_agents/tools/validators/discovery.py +150 -0
  148. ref_agents/tools/validators/forensic_engineer.py +191 -0
  149. ref_agents/tools/validators/impact_architect.py +181 -0
  150. ref_agents/tools/validators/migration_planner.py +166 -0
  151. ref_agents/tools/validators/parity_tester.py +155 -0
  152. ref_agents/tools/validators/platform_engineer.py +134 -0
  153. ref_agents/tools/validators/pr_reviewer.py +129 -0
  154. ref_agents/tools/validators/product_manager.py +291 -0
  155. ref_agents/tools/validators/qa_lead.py +172 -0
  156. ref_agents/tools/validators/scrum_master.py +212 -0
  157. ref_agents/tools/validators/security_owner.py +162 -0
  158. ref_agents/tools/validators/specifier.py +134 -0
  159. ref_agents/tools/validators/strategist.py +149 -0
  160. ref_agents/tools/validators/tester.py +121 -0
  161. ref_agents/tools/version_manager.py +202 -0
  162. ref_agents/tools/workflow_tools.py +1549 -0
  163. ref_agents/utils/__init__.py +21 -0
  164. ref_agents/utils/git_utils.py +351 -0
  165. ref_agents/utils/handoff_logger.py +368 -0
  166. ref_agents/utils/ignore_matcher.py +270 -0
  167. ref_agents/workflow/__init__.py +19 -0
  168. ref_agents/workflow/capabilities.py +328 -0
  169. ref_agents/workflow/state_machine.py +708 -0
  170. ref_agents/workflow/transitions.py +658 -0
  171. ref_agents-1.0.0.dist-info/METADATA +365 -0
  172. ref_agents-1.0.0.dist-info/RECORD +175 -0
  173. ref_agents-1.0.0.dist-info/WHEEL +4 -0
  174. ref_agents-1.0.0.dist-info/entry_points.txt +2 -0
  175. 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
+ ![Security Scan](https://github.com/Mishtert/ref-agents/actions/workflows/security-scan.yml/badge.svg)
39
+ ![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)
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,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.30.1
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ ref-agents = ref_agents.server:main
@@ -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