mirror of
https://github.com/proffesor-for-testing/agentic-qe.git
synced 2026-09-19 08:45:47 +08:00
Profa
2253d05618
Remove the nested v3/ subdirectory by moving all active source code, tests, configs, and assets directly to the project root. Archive v2/ (dead code, 847MB) to v2-archive.tar.gz. Key changes: - Move v3/src/ → src/, v3/tests/ → tests/, v3/packages/ → packages/ - Move v3/tsconfig.json, v3/vitest.config.ts to root - Merge v3/package.json into root package.json (ESM, scripts, deps, exports) - Merge v3/scripts/ into scripts/, v3/implementation/ into docs/implementation/ - Update all CI workflows to remove "cd v3 &&" and v3/ path prefixes - Fix all init installer path resolution (3-level-up → 2-level-up) - Fix hooks to use "node ./dist/cli/bundle.js" instead of bare "aqe" - Update settings.json ADR/DDD directories to docs/implementation/ - Fix helper scripts (statusline, adr-compliance, ddd-tracker, guidance-hooks) - Update 58 agent definitions: aqe/v3/ → aqe/ memory namespaces - Update 15 guidance shards: v3/src/ → src/ path references - Fix sync interfaces: remove v3/ and v2/ path references - Fix test path calculations (process.cwd() + '..' no longer needed) - Fix flaky perf test threshold (500ms → 1000ms for CI environments) - Fix complexity-analyzer test to match ADR-051 keyword-based eligibility Build passes, 17,901 tests pass, CLI and MCP bundles verified. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
135 lines
2.8 KiB
Markdown
135 lines
2.8 KiB
Markdown
# SPEC-041-A: Interactive Wizards
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| **Specification ID** | SPEC-041-A |
|
|
| **Parent ADR** | [ADR-041](../adrs/ADR-041-v3-qe-cli-enhancement.md) |
|
|
| **Version** | 1.0 |
|
|
| **Status** | Implemented |
|
|
| **Last Updated** | 2026-01-14 |
|
|
| **Author** | Claude Code |
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This specification defines the four interactive wizards for the QE CLI: test generation, coverage analysis, fleet initialization, and security scanning.
|
|
|
|
---
|
|
|
|
## Wizard Commands
|
|
|
|
### Test Generation Wizard
|
|
|
|
```bash
|
|
aqe test generate --wizard
|
|
# Prompts for:
|
|
# - Source file(s) to test
|
|
# - Test type (unit/integration/e2e)
|
|
# - Coverage target (%)
|
|
# - Framework preference
|
|
# - AI enhancement level
|
|
```
|
|
|
|
### Coverage Analysis Wizard
|
|
|
|
```bash
|
|
aqe coverage analyze --wizard
|
|
# Prompts for:
|
|
# - Target directory
|
|
# - Gap detection sensitivity
|
|
# - Report format
|
|
# - Priority focus areas
|
|
```
|
|
|
|
### Fleet Initialization Wizard
|
|
|
|
```bash
|
|
aqe fleet init --wizard
|
|
# Prompts for:
|
|
# - Topology type
|
|
# - Agent count
|
|
# - Domain focus
|
|
# - Memory allocation
|
|
```
|
|
|
|
### Security Scan Wizard
|
|
|
|
```bash
|
|
aqe security scan --wizard
|
|
# Prompts for:
|
|
# - Scan type (SAST/DAST/both)
|
|
# - Target paths
|
|
# - Severity threshold
|
|
# - Report format
|
|
```
|
|
|
|
---
|
|
|
|
## Configuration
|
|
|
|
```typescript
|
|
const QE_CLI_CONFIG = {
|
|
wizards: {
|
|
enabled: true,
|
|
themes: ['default', 'minimal', 'detailed'],
|
|
defaultTheme: 'default'
|
|
}
|
|
};
|
|
```
|
|
|
|
---
|
|
|
|
## Security Hardening
|
|
|
|
| Protection | Implementation |
|
|
|------------|----------------|
|
|
| Path traversal | Validation in test-wizard.ts |
|
|
| File size limits | YAML: 10K lines, JSON: 10MB |
|
|
| Prototype pollution | deepMerge() protection |
|
|
| Scheduler paths | home/cwd/tmp only |
|
|
|
|
---
|
|
|
|
## Implementation Files
|
|
|
|
| File | LOC | Description |
|
|
|------|-----|-------------|
|
|
| `test-wizard.ts` | ~700 | Test generation wizard |
|
|
| `coverage-wizard.ts` | ~500 | Coverage analysis wizard |
|
|
| `fleet-wizard.ts` | ~600 | Fleet initialization wizard |
|
|
| `security-wizard.ts` | ~450 | Security scan wizard |
|
|
| **Total** | 2715 | All wizards combined |
|
|
|
|
---
|
|
|
|
## Test Coverage
|
|
|
|
- 182 tests for interactive wizards
|
|
- All security validations tested
|
|
- Edge case handling verified
|
|
|
|
---
|
|
|
|
## Validation Rules
|
|
|
|
| Rule ID | Description | Severity |
|
|
|---------|-------------|----------|
|
|
| SPEC-041-A-001 | Wizard must validate all user inputs | Error |
|
|
| SPEC-041-A-002 | Path inputs must be sanitized | Error |
|
|
| SPEC-041-A-003 | Timeout must be enforced for prompts | Warning |
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
| Version | Date | Author | Changes |
|
|
|---------|------|--------|---------|
|
|
| 1.0 | 2026-01-14 | Claude Code | Initial specification |
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
- [Parent ADR](../adrs/ADR-041-v3-qe-cli-enhancement.md)
|