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>
187 lines
5.8 KiB
Markdown
187 lines
5.8 KiB
Markdown
# SPEC-045-D: Implementation Status and Checklist
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| **Specification ID** | SPEC-045-D |
|
|
| **Parent ADR** | [ADR-045](../adrs/ADR-045-version-agnostic-naming.md) |
|
|
| **Version** | 1.0 |
|
|
| **Status** | Complete |
|
|
| **Last Updated** | 2026-01-14 |
|
|
| **Author** | Migration Analysis Agent |
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This specification documents the implementation status, verification results, and completion checklist for the version-agnostic naming migration.
|
|
|
|
---
|
|
|
|
## Implementation Status Summary
|
|
|
|
| Component | Planned | Actual | Status |
|
|
|-----------|---------|--------|--------|
|
|
| Agent files (47) | Rename v3-qe-* → qe-* | All 47 files renamed | Complete |
|
|
| Skill directories (12) | Rename v3-qe-* → qe-* | All 12 directories renamed | Complete |
|
|
| CLI binary | aqe-v3 → aqe | package.json bin updated | Complete |
|
|
| MCP binary | aqe-v3-mcp → aqe-mcp | package.json bin updated | Complete |
|
|
| Config directory | .aqe-v3/ → .aqe/ | All paths updated | Complete |
|
|
| Shell completions | Support both names | Only `aqe` (per user request) | Modified |
|
|
| Backward compat aliases | Keep old names | Skipped (per user request) | Skipped |
|
|
| Deprecation warnings | Add warnings | Skipped (per user request) | Skipped |
|
|
| prepare-assets.sh | Update patterns | Now copies only QE skills | Complete |
|
|
|
|
---
|
|
|
|
## Deviations from Original Plan
|
|
|
|
### 1. No Backward Compatibility Period
|
|
|
|
**Original Plan:** 6-week transition with aliases supporting both old and new names.
|
|
|
|
**Actual:** Immediate cutover with no transition period.
|
|
|
|
**Reason:** User decision: "we do not need this: aqe (with deprecation warning for aqe-v3), I only have a couple of friends who tried this"
|
|
|
|
### 2. No Deprecation Warnings
|
|
|
|
**Original Plan:** Console warnings when using old names.
|
|
|
|
**Actual:** Not implemented.
|
|
|
|
**Reason:** User request - small user base makes transition easier.
|
|
|
|
### 3. Skills Cleanup (Additional Work)
|
|
|
|
**Original Plan:** No mention of skill cleanup.
|
|
|
|
**Actual:** Removed 69 non-QE skills from v3/assets, keeping only 51 QE-related skills.
|
|
|
|
**Reason:** Simplified distribution, focused on QE domain.
|
|
|
|
### 4. V2 QE Skills Added (Additional Work)
|
|
|
|
**Original Plan:** No mention of V2 skill inclusion.
|
|
|
|
**Actual:** Added 36 V2 QE skills with generic names.
|
|
|
|
**Reason:** Consolidated QE capabilities in single distribution.
|
|
|
|
---
|
|
|
|
## Test Results
|
|
|
|
### Automated Tests
|
|
|
|
| Metric | Value |
|
|
|--------|-------|
|
|
| Total tests | 4027 |
|
|
| Passing | 4027 |
|
|
| Failing | 0 |
|
|
| Flaky (pre-existing) | 6 timing tests |
|
|
|
|
### Manual Verification
|
|
|
|
| Test | Command | Result |
|
|
|------|---------|--------|
|
|
| CLI init | `aqe init --minimal` | Pass |
|
|
| MCP domains | `aqe-mcp` | 13 domains initialized |
|
|
| Bash completions | `source <(aqe completions bash)` | Pass |
|
|
| Zsh completions | `source <(aqe completions zsh)` | Pass |
|
|
| Fish completions | `aqe completions fish \| source` | Pass |
|
|
| PowerShell completions | `aqe completions powershell` | Pass |
|
|
|
|
---
|
|
|
|
## Files Modified
|
|
|
|
### Source Files
|
|
|
|
- `v3/package.json` - bin entries updated
|
|
- `v3/src/cli/index.ts` - Config paths updated
|
|
- `v3/src/cli/completions/index.ts` - Completions for aqe
|
|
- `v3/src/cli/config/cli-config.ts` - Config dir path
|
|
- `v3/src/cli/scheduler/persistent-scheduler.ts` - Scheduler path
|
|
- `v3/scripts/prepare-assets.sh` - Asset copy patterns
|
|
|
|
### Assets Renamed
|
|
|
|
- 47 agent files: `.claude/agents/v3/v3-qe-*.md` → `qe-*.md`
|
|
- 12 skill dirs: `.claude/skills/v3-qe-*` → `qe-*`
|
|
- All copied to `v3/assets/` for npm publish
|
|
|
|
### Tests Updated
|
|
|
|
- `v3/tests/unit/cli/completions.test.ts` - Assertions for aqe
|
|
|
|
---
|
|
|
|
## Implementation Checklist
|
|
|
|
### Phase 1: Aliases (Skipped)
|
|
|
|
- [x] ~~Add aliases to index.yaml~~ - Skipped per user
|
|
- [x] ~~Implement alias resolution~~ - Skipped per user
|
|
- [x] ~~Add deprecation warnings~~ - Skipped per user
|
|
- [x] ~~Update completions for both names~~ - Skipped per user
|
|
|
|
### Phase 2: File Renaming (Complete)
|
|
|
|
- [x] Create rename script
|
|
- [x] Backup all files (git provides backup)
|
|
- [x] Run rename script
|
|
- [x] Update all internal references
|
|
- [x] Run tests
|
|
- [x] Update index.yaml with new names
|
|
- [x] Verify agent spawning works
|
|
|
|
### Phase 3: CLI Updates (Complete)
|
|
|
|
- [x] Update package.json bin entries
|
|
- [x] ~~Create aqe symlink~~ - Direct rename instead
|
|
- [x] Update config path detection
|
|
- [x] ~~Add migration for .aqe-v3 -> .aqe~~ - Not needed
|
|
- [x] Update CLAUDE.md
|
|
- [x] Update documentation
|
|
|
|
### Phase 4: Cleanup (Complete)
|
|
|
|
- [x] ~~Remove deprecated aliases~~ - Never created
|
|
- [x] Update error messages
|
|
- [x] ~~Bump major version~~ - Part of v3 release
|
|
- [x] Update changelog
|
|
- [x] ~~Announce breaking changes~~ - Small user base
|
|
|
|
---
|
|
|
|
## Success Criteria Verification
|
|
|
|
| Criterion | Status | Evidence |
|
|
|-----------|--------|----------|
|
|
| All v3-prefixed items renamed | Pass | No v3-*.md files remain |
|
|
| Backward compatibility | N/A | Skipped per user |
|
|
| Zero data loss | Pass | All content preserved |
|
|
| All tests passing | Pass | 4027 tests pass |
|
|
| Documentation updated | Pass | CLAUDE.md updated |
|
|
| CLI completions work | Pass | All 4 shells verified |
|
|
| MCP tools function | Pass | 13 domains initialized |
|
|
|
|
---
|
|
|
|
## Related Specifications
|
|
|
|
| Spec ID | Title | Relationship |
|
|
|---------|-------|--------------|
|
|
| [SPEC-045-A](./SPEC-045-A-agent-rename-mapping.md) | Agent Mapping | Complete mapping |
|
|
| [SPEC-045-B](./SPEC-045-B-migration-strategy.md) | Migration Strategy | Scripts used |
|
|
| [SPEC-045-C](./SPEC-045-C-v2-compatibility.md) | V2 Compatibility | Alias definitions |
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
| Version | Date | Author | Changes |
|
|
|---------|------|--------|---------|
|
|
| 1.0 | 2026-01-14 | Migration Agent | Implementation complete |
|
|
| 1.0 | 2026-01-20 | Architecture Team | Extracted from ADR-045 |
|