chore: rename cameleer3 to cameleer
Rename Java packages from net.siegeln.cameleer3 to net.siegeln.cameleer, update all references in workflows, Docker configs, docs, and bootstrap. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -3,7 +3,7 @@
|
||||
**Date:** 2026-03-29
|
||||
**Status:** Draft — Awaiting Review
|
||||
**Author:** Boardroom simulation (Strategist, Skeptic, Architect, Growth Hacker)
|
||||
**Gitea Issues:** cameleer/cameleer3 #57-#72 (label: MOAT)
|
||||
**Gitea Issues:** cameleer/cameleer #57-#72 (label: MOAT)
|
||||
|
||||
## Executive Summary
|
||||
|
||||
@@ -32,14 +32,14 @@ Week 8-14: Live Route Debugger (agent + server + UI)
|
||||
- #59 — Cross-Service Trace Correlation + Topology Map
|
||||
|
||||
**Debugger sub-issues:**
|
||||
- #60 — Protocol: Debug session command types (`cameleer3-common`)
|
||||
- #60 — Protocol: Debug session command types (`cameleer-common`)
|
||||
- #61 — Agent: DebugSessionManager + breakpoint InterceptStrategy integration
|
||||
- #62 — Agent: ExchangeStateSerializer + synthetic direct route wrapper
|
||||
- #63 — Server: DebugSessionService + WebSocket + REST API
|
||||
- #70 — UI: Debug session frontend components
|
||||
|
||||
**Lineage sub-issues:**
|
||||
- #64 — Protocol: Lineage command types (`cameleer3-common`)
|
||||
- #64 — Protocol: Lineage command types (`cameleer-common`)
|
||||
- #65 — Agent: LineageManager + capture mode integration
|
||||
- #66 — Server: LineageService + DiffEngine + REST API
|
||||
- #71 — UI: Lineage timeline + diff viewer components
|
||||
@@ -69,14 +69,14 @@ Browser (SaaS UI)
|
||||
WebSocket <--------------------------------------+
|
||||
| |
|
||||
v |
|
||||
cameleer3-server |
|
||||
cameleer-server |
|
||||
| POST /api/v1/debug/sessions |
|
||||
| POST /api/v1/debug/sessions/{id}/step |
|
||||
| POST /api/v1/debug/sessions/{id}/resume |
|
||||
| DELETE /api/v1/debug/sessions/{id} |
|
||||
| |
|
||||
v |
|
||||
SSE Command Channel --> cameleer3 agent |
|
||||
SSE Command Channel --> cameleer agent |
|
||||
| | |
|
||||
| "start-debug" | |
|
||||
| command v |
|
||||
@@ -101,7 +101,7 @@ SSE Command Channel --> cameleer3 agent |
|
||||
| Continue to next processor
|
||||
```
|
||||
|
||||
### 1.3 Protocol Additions (cameleer3-common)
|
||||
### 1.3 Protocol Additions (cameleer-common)
|
||||
|
||||
#### New SSE Commands
|
||||
|
||||
@@ -160,11 +160,11 @@ SSE Command Channel --> cameleer3 agent |
|
||||
}
|
||||
```
|
||||
|
||||
### 1.4 Agent Implementation (cameleer3-agent)
|
||||
### 1.4 Agent Implementation (cameleer-agent)
|
||||
|
||||
#### DebugSessionManager
|
||||
|
||||
- Location: `com.cameleer3.agent.debug.DebugSessionManager`
|
||||
- Location: `com.cameleer.agent.debug.DebugSessionManager`
|
||||
- Stores active sessions: `ConcurrentHashMap<sessionId, DebugSession>`
|
||||
- Enforces max concurrent sessions (default 3, configurable via `cameleer.debug.maxSessions`)
|
||||
- Allocates **dedicated Thread** per session (NOT from Camel thread pool)
|
||||
@@ -213,7 +213,7 @@ For non-direct routes (timer, jms, http, file):
|
||||
3. Debug exchange enters via `ProducerTemplate.send()`
|
||||
4. Remove temporary route on session completion
|
||||
|
||||
### 1.5 Server Implementation (cameleer3-server)
|
||||
### 1.5 Server Implementation (cameleer-server)
|
||||
|
||||
#### REST Endpoints
|
||||
|
||||
@@ -308,7 +308,7 @@ Capture the full transformation history of a message flowing through a route. At
|
||||
### 2.2 Architecture
|
||||
|
||||
```
|
||||
cameleer3 agent
|
||||
cameleer agent
|
||||
|
|
||||
| On lineage-enabled exchange:
|
||||
| Before processor: capture INPUT
|
||||
@@ -319,7 +319,7 @@ cameleer3 agent
|
||||
POST /api/v1/data/executions (processors carry full snapshots)
|
||||
|
|
||||
v
|
||||
cameleer3-server
|
||||
cameleer-server
|
||||
|
|
||||
| LineageService:
|
||||
| > Flatten processor tree to ordered list
|
||||
@@ -334,7 +334,7 @@ GET /api/v1/executions/{id}/lineage
|
||||
Browser: LineageTimeline + DiffViewer
|
||||
```
|
||||
|
||||
### 2.3 Protocol Additions (cameleer3-common)
|
||||
### 2.3 Protocol Additions (cameleer-common)
|
||||
|
||||
#### New SSE Commands
|
||||
|
||||
@@ -370,11 +370,11 @@ Browser: LineageTimeline + DiffViewer
|
||||
| `EXPRESSION` | Any exchange matching a Simple/JsonPath predicate |
|
||||
| `NEXT_N` | Next N exchanges on the route (countdown) |
|
||||
|
||||
### 2.4 Agent Implementation (cameleer3-agent)
|
||||
### 2.4 Agent Implementation (cameleer-agent)
|
||||
|
||||
#### LineageManager
|
||||
|
||||
- Location: `com.cameleer3.agent.lineage.LineageManager`
|
||||
- Location: `com.cameleer.agent.lineage.LineageManager`
|
||||
- Stores active configs: `ConcurrentHashMap<lineageId, LineageConfig>`
|
||||
- Tracks capture count per lineageId: auto-disables at `maxCaptures`
|
||||
- Duration timeout via `ScheduledExecutorService`: auto-disables after expiry
|
||||
@@ -412,7 +412,7 @@ cameleer.lineage.maxBodySize=65536 # 64KB for lineage captures (vs 4KB normal
|
||||
cameleer.lineage.enabled=true # master switch
|
||||
```
|
||||
|
||||
### 2.5 Server Implementation (cameleer3-server)
|
||||
### 2.5 Server Implementation (cameleer-server)
|
||||
|
||||
#### LineageService
|
||||
|
||||
@@ -548,7 +548,7 @@ New (added):
|
||||
| Direct/SEDA | URI prefix `direct:`, `seda:`, `vm:` | Exchange property (in-process) |
|
||||
| File/FTP | URI prefix `file:`, `ftp:` | Not propagated (async) |
|
||||
|
||||
### 3.3 Agent Implementation (cameleer3-agent)
|
||||
### 3.3 Agent Implementation (cameleer-agent)
|
||||
|
||||
#### Outgoing Propagation (InterceptStrategy)
|
||||
|
||||
@@ -597,7 +597,7 @@ execution.setHopIndex(...); // depth in distributed trace
|
||||
- Parse failure: log warning, continue without context (no exchange failure)
|
||||
- Only inject on outgoing processors, never on FROM consumers
|
||||
|
||||
### 3.4 Server Implementation: Trace Assembly (cameleer3-server)
|
||||
### 3.4 Server Implementation: Trace Assembly (cameleer-server)
|
||||
|
||||
#### CorrelationService
|
||||
|
||||
@@ -665,7 +665,7 @@ CREATE INDEX idx_executions_parent_span
|
||||
- **Fan-out:** parallel multicast creates multiple children from same processor
|
||||
- **Circular calls:** detected via hopIndex (max depth 20)
|
||||
|
||||
### 3.5 Server Implementation: Topology Graph (cameleer3-server)
|
||||
### 3.5 Server Implementation: Topology Graph (cameleer-server)
|
||||
|
||||
#### DependencyGraphService
|
||||
|
||||
@@ -799,11 +799,11 @@ Reserve `sourceTenantHash` in TraceContext for future use:
|
||||
|
||||
| Work | Repo | Issue |
|
||||
|------|------|-------|
|
||||
| Service topology materialized view | cameleer3-server | #69 |
|
||||
| Topology REST API | cameleer3-server | #69 |
|
||||
| ServiceTopologyGraph.tsx | cameleer3-server + saas | #72 |
|
||||
| WebSocket infrastructure (for debugger) | cameleer3-server | #63 |
|
||||
| TraceContext DTO in cameleer3-common | cameleer3 | #67 |
|
||||
| Service topology materialized view | cameleer-server | #69 |
|
||||
| Topology REST API | cameleer-server | #69 |
|
||||
| ServiceTopologyGraph.tsx | cameleer-server + saas | #72 |
|
||||
| WebSocket infrastructure (for debugger) | cameleer-server | #63 |
|
||||
| TraceContext DTO in cameleer-common | cameleer | #67 |
|
||||
|
||||
**Ship:** Topology graph visible from existing data. Zero agent changes. Immediate visual payoff.
|
||||
|
||||
@@ -811,10 +811,10 @@ Reserve `sourceTenantHash` in TraceContext for future use:
|
||||
|
||||
| Work | Repo | Issue |
|
||||
|------|------|-------|
|
||||
| Lineage protocol DTOs | cameleer3-common | #64 |
|
||||
| LineageManager + capture integration | cameleer3-agent | #65 |
|
||||
| LineageService + DiffEngine | cameleer3-server | #66 |
|
||||
| Lineage UI components | cameleer3-server + saas | #71 |
|
||||
| Lineage protocol DTOs | cameleer-common | #64 |
|
||||
| LineageManager + capture integration | cameleer-agent | #65 |
|
||||
| LineageService + DiffEngine | cameleer-server | #66 |
|
||||
| Lineage UI components | cameleer-server + saas | #71 |
|
||||
|
||||
**Ship:** Payload flow lineage independently usable.
|
||||
|
||||
@@ -822,10 +822,10 @@ Reserve `sourceTenantHash` in TraceContext for future use:
|
||||
|
||||
| Work | Repo | Issue |
|
||||
|------|------|-------|
|
||||
| Trace context header propagation | cameleer3-agent | #67 |
|
||||
| Executions table migration (new columns) | cameleer3-server | #68 |
|
||||
| CorrelationService + trace assembly | cameleer3-server | #68 |
|
||||
| DistributedTraceView + TraceSearch UI | cameleer3-server + saas | #72 |
|
||||
| Trace context header propagation | cameleer-agent | #67 |
|
||||
| Executions table migration (new columns) | cameleer-server | #68 |
|
||||
| CorrelationService + trace assembly | cameleer-server | #68 |
|
||||
| DistributedTraceView + TraceSearch UI | cameleer-server + saas | #72 |
|
||||
|
||||
**Ship:** Distributed traces + topology — full correlation story.
|
||||
|
||||
@@ -833,11 +833,11 @@ Reserve `sourceTenantHash` in TraceContext for future use:
|
||||
|
||||
| Work | Repo | Issue |
|
||||
|------|------|-------|
|
||||
| Debug protocol DTOs | cameleer3-common | #60 |
|
||||
| DebugSessionManager + InterceptStrategy | cameleer3-agent | #61 |
|
||||
| ExchangeStateSerializer + synthetic wrapper | cameleer3-agent | #62 |
|
||||
| DebugSessionService + WS + REST | cameleer3-server | #63 |
|
||||
| Debug UI components | cameleer3-server + saas | #70 |
|
||||
| Debug protocol DTOs | cameleer-common | #60 |
|
||||
| DebugSessionManager + InterceptStrategy | cameleer-agent | #61 |
|
||||
| ExchangeStateSerializer + synthetic wrapper | cameleer-agent | #62 |
|
||||
| DebugSessionService + WS + REST | cameleer-server | #63 |
|
||||
| Debug UI components | cameleer-server + saas | #70 |
|
||||
|
||||
**Ship:** Full browser-based route debugger with integration to lineage and correlation.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user