docs: enterprise refactor plan with ralph specs

.ralph/specs/legacy/project-structure.md

@@ -0,0 +1,138 @@
+# ABE — Project Structure Specification
+
+## Árbol completo de archivos a crear
+```
+abe/
+├── src/
+│   ├── core/
+│   │   ├── interfaces.ts        ← TODAS las interfaces (IState, IAction, etc.)
+│   │   ├── StateGraph.ts        ← implementación del grafo de estados
+│   │   ├── ExplorationEngine.ts ← loop principal de exploración
+│   │   └── AnomalyDetector.ts   ← reglas heurísticas de detección
+│   ├── plugins/
+│   │   ├── agents/
+│   │   │   └── PlaywrightAgent.ts   ← implementa IInteractionAgent
+│   │   ├── collectors/
+│   │   │   ├── ScreenshotCollector.ts
+│   │   │   ├── NetworkCollector.ts
+│   │   │   └── DOMSnapshotCollector.ts
+│   │   ├── exporters/
+│   │   │   ├── MarkdownExporter.ts
+│   │   │   └── JSONExporter.ts
+│   │   └── reproducers/
+│   │       └── PlaywrightReproducer.ts
+│   └── index.ts                 ← punto de entrada, conecta todo
+│
+├── tests/
+│   ├── core/
+│   │   ├── StateGraph.test.ts
+│   │   ├── ExplorationEngine.test.ts
+│   │   └── AnomalyDetector.test.ts
+│   └── plugins/
+│       ├── agents/
+│       │   └── PlaywrightAgent.test.ts
+│       └── exporters/
+│           ├── MarkdownExporter.test.ts
+│           └── JSONExporter.test.ts
+│
+├── reports/                     ← generado en runtime, ignorado por git
+├── logs/                        ← generado en runtime, ignorado por git
+│
+├── package.json
+├── tsconfig.json
+├── jest.config.ts
+└── CLAUDE.md
+```
+
+---
+
+## Reglas de importación — MUY IMPORTANTE
+```
+✅ PERMITIDO:
+   src/core/ExplorationEngine.ts  →  importa de  src/core/interfaces.ts
+   src/plugins/agents/PlaywrightAgent.ts  →  importa de  src/core/interfaces.ts
+   src/index.ts  →  importa de  src/core/ Y src/plugins/
+
+❌ PROHIBIDO:
+   src/core/ExplorationEngine.ts  →  importa de  src/plugins/  (rompe el desacoplamiento)
+   src/plugins/agents/A.ts  →  importa de  src/plugins/exporters/B.ts  (plugins no se conocen entre sí)
+```
+
+---
+
+## Cómo se conecta todo en src/index.ts
+
+El archivo de entrada debe seguir este patrón:
+```typescript
+// src/index.ts
+import { ExplorationEngine } from './core/ExplorationEngine';
+import { StateGraph } from './core/StateGraph';
+import { PlaywrightAgent } from './plugins/agents/PlaywrightAgent';
+import { ScreenshotCollector } from './plugins/collectors/ScreenshotCollector';
+import { NetworkCollector } from './plugins/collectors/NetworkCollector';
+import { DOMSnapshotCollector } from './plugins/collectors/DOMSnapshotCollector';
+import { JSONExporter } from './plugins/exporters/JSONExporter';
+import { MarkdownExporter } from './plugins/exporters/MarkdownExporter';
+import { PlaywrightReproducer } from './plugins/reproducers/PlaywrightReproducer';
+
+const graph = new StateGraph();
+const agent = new PlaywrightAgent();
+const collectors = [new ScreenshotCollector(), new NetworkCollector(), new DOMSnapshotCollector()];
+const exporters = [new JSONExporter(), new MarkdownExporter()];
+const reproducer = new PlaywrightReproducer();
+
+const engine = new ExplorationEngine({ graph, agent, collectors, exporters, reproducer });
+
+engine.run({ url: process.argv[2] || 'http://localhost:3000', seed: 42 });
+```
+
+---
+
+## package.json — scripts obligatorios
+```json
+{
+  "name": "abe",
+  "version": "0.1.0",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ tests/",
+    "explore": "ts-node src/index.ts",
+    "replay": "ts-node src/replay.ts"
+  }
+}
+```
+
+---
+
+## tsconfig.json — configuración base
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}
+```
+
+---
+
+## jest.config.ts — configuración base
+```typescript
+export default {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/tests'],
+  testMatch: ['**/*.test.ts'],
+};
+```