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>
125 lines
3.6 KiB
Markdown
125 lines
3.6 KiB
Markdown
# SPEC-031-C: Implementation Plan
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| **Specification ID** | SPEC-031-C |
|
|
| **Parent ADR** | [ADR-031](../adrs/ADR-031-strange-loop-self-awareness.md) |
|
|
| **Version** | 1.0 |
|
|
| **Status** | Accepted |
|
|
| **Last Updated** | 2026-01-10 |
|
|
| **Author** | Architecture Team |
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
Defines the phased implementation plan for Strange Loop self-awareness, including file structure, success metrics, and integration points with existing swarm coordinators.
|
|
|
|
---
|
|
|
|
## Specification Details
|
|
|
|
### Section 1: File Structure
|
|
|
|
```
|
|
v3/src/strange-loop/
|
|
+-- index.ts
|
|
+-- types.ts
|
|
+-- swarm-observer.ts # Collect swarm state
|
|
+-- topology-analyzer.ts # Analyze graph structure
|
|
+-- min-cut-calculator.ts # Find bottlenecks
|
|
+-- self-model.ts # SwarmSelfModel
|
|
+-- trend-analyzer.ts # Predict vulnerabilities
|
|
+-- history-store.ts # Observation persistence
|
|
+-- healing-controller.ts # SelfHealingController
|
|
+-- action-executor.ts # Execute healing actions
|
|
+-- strange-loop.ts # StrangeLoopOrchestrator
|
|
```
|
|
|
|
### Section 2: Implementation Phases
|
|
|
|
#### Phase 1: Observer Module (Days 1-2)
|
|
- `swarm-observer.ts` - Collect swarm state
|
|
- `topology-analyzer.ts` - Analyze graph structure
|
|
- `min-cut-calculator.ts` - Find bottlenecks
|
|
- `types.ts` - Core type definitions
|
|
|
|
#### Phase 2: Self-Model (Day 3)
|
|
- `self-model.ts` - SwarmSelfModel implementation
|
|
- `trend-analyzer.ts` - Predict vulnerabilities
|
|
- `history-store.ts` - Observation persistence
|
|
|
|
#### Phase 3: Self-Healing (Days 4-5)
|
|
- `healing-controller.ts` - SelfHealingController
|
|
- `action-executor.ts` - Execute healing actions
|
|
- `strange-loop.ts` - StrangeLoopOrchestrator
|
|
- `index.ts` - Barrel exports
|
|
|
|
### Section 3: Success Metrics
|
|
|
|
| Metric | Target |
|
|
|--------|--------|
|
|
| Swarm observation frequency | Every 5 seconds |
|
|
| Bottleneck detection latency | <100ms |
|
|
| Self-healing action execution | <1s |
|
|
| Trend prediction accuracy | >70% |
|
|
| Human intervention required | 0 for common issues |
|
|
| Unit test coverage | 60+ tests |
|
|
|
|
### Section 4: Integration Points
|
|
|
|
#### Queen Coordinator Integration
|
|
|
|
```typescript
|
|
// In queen-coordinator.ts
|
|
import { StrangeLoopOrchestrator } from '../strange-loop';
|
|
|
|
export class QueenCoordinator {
|
|
private strangeLoop: StrangeLoopOrchestrator;
|
|
|
|
async initialize(): Promise<void> {
|
|
this.strangeLoop = new StrangeLoopOrchestrator(this.swarm);
|
|
await this.strangeLoop.start();
|
|
}
|
|
|
|
async onSelfBottleneckDetected(): Promise<void> {
|
|
console.log('[Queen] I am a bottleneck. Promoting workers to sub-coordinators.');
|
|
await this.promoteWorkersToCoordinators();
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Validation Rules
|
|
|
|
| Rule ID | Description | Severity |
|
|
|---------|-------------|----------|
|
|
| SPEC-031-C-001 | All phases must complete before production deployment | Error |
|
|
| SPEC-031-C-002 | 60+ unit tests required before approval | Error |
|
|
| SPEC-031-C-003 | Integration tests with Queen Coordinator required | Warning |
|
|
|
|
---
|
|
|
|
## Related Specifications
|
|
|
|
| Spec ID | Title | Relationship |
|
|
|---------|-------|--------------|
|
|
| SPEC-031-A | Self-Observation Protocol | Technical specification |
|
|
| SPEC-031-B | Self-Healing Controller | Controller specification |
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
| Version | Date | Author | Changes |
|
|
|---------|------|--------|---------|
|
|
| 1.0 | 2026-01-10 | Architecture Team | Initial specification |
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
- [Parent ADR](../adrs/ADR-031-strange-loop-self-awareness.md)
|
|
- Self-organizing systems theory
|