mirror of
https://github.com/proffesor-for-testing/agentic-qe.git
synced 2026-09-19 08:45:47 +08:00
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>
5.9 KiB
5.9 KiB
SPEC-047-B: Phase Implementation
| Field | Value |
|---|---|
| Specification ID | SPEC-047-B |
| Parent ADR | ADR-047 |
| Version | 1.0 |
| Status | Implemented |
| Last Updated | 2026-01-17 |
| Author | Architecture Team |
Overview
Defines the phased implementation plan for MinCut self-organizing QE integration, including success metrics for each phase and agent assignments.
Specification Details
Section 1: Implementation Priorities
| Priority | Feature | Effort | Dependencies | Value |
|---|---|---|---|---|
| P0 | MinCut Health Metric | 2 days | None | Foundation for all else |
| P1 | Strange Loop Self-Healing | 1 week | P0, ADR-008 Queen | High - reduces manual intervention |
| P2 | Causal Test Failure Discovery | 1 week | ADR-035 STDP | High - instant root cause |
| P3 | Morphogenetic Test Generation | 2 weeks | ADR-005 TestGen | Medium - organic coverage |
| P4 | Time Crystal CI/CD | 1 week | ADR-032 | Medium - scheduler-free |
| P5 | Neural GOAP Optimizer | 2 weeks | ADR-046 GOAP | Medium - plan intelligence |
| P6 | Dream x Strange Loop | 3 weeks | ADR-046 Dreams, P1 | Experimental - meta-learning |
Section 2: Phase Success Metrics
P0: MinCut Health Metric
- MinCut value displayed in Queen status (
MinCutHealthMonitor) - Threshold alerts when connectivity drops below 2.0 (
MinCutAlert) - Graph visualization of swarm topology (
SwarmGraphwith vertex/edge tracking)
P1: Strange Loop Self-Healing
- Automatic agent spawning when MinCut < threshold (
StrangeLoopController) - Self-model prediction accuracy > 70% (
SelfModelPrediction) - Mean time to recovery < 30 seconds (
ReorganizationAction)
P2: Causal Test Failure Discovery
- Root cause identification in < 5 seconds (
TestFailureCausalGraph) - Causal graph accuracy > 80% (
CausalLinkwith STDP learning) - Integration with existing failure reporting (
RootCauseAnalysis,FixSuggestion)
P3: Morphogenetic Test Generation
- Tests grow organically based on code changes (
MorphogeneticController) - Coverage maintained above 80% automatically (
MorphogeneticFieldManager) - Signal diffusion propagates within 1 second (
GrowthPattern,MutationRule)
P4: Time Crystal CI/CD
- Scheduler-free test coordination achieved (
TimeCrystalController) - Phase synchronization within 10 cycles (
Kuramoto oscillators,TemporalAttractor) - No performance degradation vs traditional scheduler (
CrystalLattice)
P5: Neural GOAP Optimizer
- Plan costs learned from execution outcomes (
GOAPController,NeuralPlanner) - 20% improvement in plan efficiency after 100 executions (
GOAPPlanwith Q-learning) - Q-values persist across sessions (
PlanExecutionResultreplay buffer)
P6: Dream x Strange Loop Meta-Learning
- Hypothetical scenarios generated during idle time (
DreamMinCutController) - At least 3 actionable insights per dream cycle (
MetaLearningTracker) - Quality equilibrium convergence within 10 iterations (
StrangeLoopDreamIntegration)
Section 3: Agent Assignments
| Phase | Agents | Tasks |
|---|---|---|
| P0 | architect, coder | MinCut calculator, Queen integration |
| P1 | architect, coder, tester | Strange Loop healer, tests |
| P2 | coder, researcher | Causal graph, STDP integration |
| P3 | coder, tester | Morphogenetic signals, spawner |
| P4 | coder | Time Crystal integration |
| P5 | coder, ml-developer | Neural GOAP optimizer |
| P6 | architect, coder, researcher | Dream x Strange Loop |
Section 4: Source Files Created
| File | Description | LOC |
|---|---|---|
interfaces.ts |
Type definitions for all MinCut components | ~200 |
swarm-graph.ts |
Graph data structure for topology representation | ~300 |
mincut-calculator.ts |
MinCut algorithms (approximate, exact) | ~250 |
mincut-health-monitor.ts |
Real-time health monitoring and alerting | ~200 |
strange-loop.ts |
P1: Self-healing controller (observe->model->decide->act) | ~350 |
causal-discovery.ts |
P2: STDP-based causal test failure analysis | ~400 |
morphogenetic-growth.ts |
P3: Bio-inspired test generation | ~500 |
time-crystal.ts |
P4: Kuramoto oscillator CI/CD coordination | ~450 |
neural-goap.ts |
P5: Q-learning GOAP optimizer | ~400 |
dream-integration.ts |
P6: Dream x Strange Loop meta-learning | ~350 |
queen-integration.ts |
Queen Coordinator MinCut bridge | ~200 |
mincut-persistence.ts |
Persistence layer for graph state | ~150 |
shared-singleton.ts |
Shared state for MCP<->Queen integration | ~100 |
index.ts |
Barrel exports for all components | ~150 |
Validation Rules
| Rule ID | Description | Severity |
|---|---|---|
| SPEC-047-B-001 | Each phase must complete all success metrics before next phase | Error |
| SPEC-047-B-002 | 478+ unit tests required for full implementation | Error |
| SPEC-047-B-003 | MCP tools must be registered in tool registry | Warning |
Related Specifications
| Spec ID | Title | Relationship |
|---|---|---|
| SPEC-047-A | MinCut Architecture | Architecture overview |
| SPEC-047-C | Performance Metrics | Achieved metrics |
Changelog
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | 2026-01-17 | Architecture Team | Initial specification |
References
- Parent ADR
- ADR-008: Multi-Agent Hierarchical Coordination (Queen Coordinator)
- ADR-021: QE ReasoningBank for Pattern Learning
- ADR-046: V2 Feature Integration (GOAP, Dreams)