theinterneti/TTA.dev / .claude/skills/generated/observability
observability
VerifiedObservability subsystem in TTA.dev: demo_hierarchical_trace, handle_api_active_agents, handle_api_agent_actions and related code. 115 symbols | 38 files | Cohesion: 73%
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
SKILL.md
View on GitHub---
name: observability
description: "Observability subsystem in TTA.dev: demo_hierarchical_trace, handle_api_active_agents, handle_api_agent_actions and related code. 115 symbols | 38 files | Cohesion: 73%"
---
# Observability
115 symbols | 38 files | Cohesion: 73%
## When to Use
- Working on `observability`-related functionality in TTA.dev
- Modifying `demo_hierarchical_trace`, `handle_api_active_agents`
- Navigating `ttadev/observability/server.py`, `ttadev/observability/project_session.py`
## Key Files
| File | Symbols |
|------|---------|
| `ttadev/observability/server.py` | _langfuse_creds, _estimate_cost, _v2_langfuse_session_cost, _v2_langfuse_scores, _init_state (+5) |
| `tests/observability/test_span_pipeline.py` | test_retry_succeeds_after_transient_failure, test_retry_exhausted_raises, test_retry_with_mock_primitive, test_cache_hit_skips_inner_primitive, _make_otel_span (+3) |
| `ttadev/observability/project_session.py` | join, get, get_by_id, add_member, assign_role (+2) |
| `ttadev/observability/span_processor.py` | from_activity_log, from_agent_tracker, extract_primitive_type, _normalize_provider, _parse_timestamp (+2) |
| `ttadev/observability/agent_tracker.py` | track_agent_action, log_activity, get_active_agents, get_recent_actions, get_tracker (+1) |
| `ttadev/primitives/observability/logging.py` | _log, debug, info, warning, error (+1) |
| `ttadev/observability/session_manager.py` | end_session_by_id, list_sessions, get_or_create_agent_session, update_session_project, _persist_session (+1) |
| `ttadev/observability/auto_instrument.py` | log_activity, log_tool_use, log_workflow_end, get_logger, log_workflow_start (+1) |
| `tests/observability/test_handoff_tracing.py` | _free_port, test_dag_endpoint_empty_when_no_handoffs, test_dag_endpoint_returns_nodes_and_edges, _make_agent_spec, test_handoff_span_emitted_with_required_attributes (+1) |
| `ttadev/observability/auto_track_copilot.py` | is_copilot_session, get_copilot_context, wrapper, track_workflow_execution, track_agent_activation |
## Entry Points
Start here when exploring this area:
- **`demo_hierarchical_trace`** (Function) — `examples/demo_hierarchical_traces.py:8`
- **`handle_api_active_agents`** (Function) — `ttadev/ui/observability_server.py:260`
- **`handle_api_agent_actions`** (Function) — `ttadev/ui/observability_server.py:270`
- **`track_agent_action`** (Function) — `ttadev/observability/agent_tracker.py:40`
- **`log_activity`** (Function) — `ttadev/observability/agent_tracker.py:68`
## Key Symbols
| Symbol | Type | File | Line |
|--------|------|------|------|
| `demo_hierarchical_trace` | Function | `examples/demo_hierarchical_traces.py` | 8 |
| `handle_api_active_agents` | Function | `ttadev/ui/observability_server.py` | 260 |
| `handle_api_agent_actions` | Function | `ttadev/ui/observability_server.py` | 270 |
| `track_agent_action` | Function | `ttadev/observability/agent_tracker.py` | 40 |
| `log_activity` | Function | `ttadev/observability/agent_tracker.py` | 68 |
| `get_active_agents` | Function | `ttadev/observability/agent_tracker.py` | 107 |
| `get_recent_actions` | Function | `ttadev/observability/agent_tracker.py` | 165 |
| `get_tracker` | Function | `ttadev/observability/agent_tracker.py` | 182 |
| `join` | Function | `ttadev/observability/project_session.py` | 51 |
| `get` | Function | `ttadev/observability/project_session.py` | 58 |
| `get_by_id` | Function | `ttadev/observability/project_session.py` | 68 |
| `add_member` | Function | `ttadev/observability/project_session.py` | 87 |
| `assign_role` | Function | `ttadev/observability/project_session.py` | 96 |
| `main` | Function | `examples/demo_full_observability.py` | 62 |
| `test_retry_succeeds_after_transient_failure` | Function | `tests/observability/test_span_pipeline.py` | 234 |
| `test_retry_exhausted_raises` | Function | `tests/observability/test_span_pipeline.py` | 261 |
| `test_retry_with_mock_primitive` | Function | `tests/observability/test_span_pipeline.py` | 275 |
| `test_cache_hit_skips_inner_primitive` | Function | `tests/observability/test_span_pipeline.py` | 367 |
| `execute` | Function | `ttadev/primitives/recovery/retry.py` | 81 |
| `root` | Function | `ttadev/primitives/core/base.py` | 217 |
## Execution Flows
| Flow | Type | Steps |
|------|------|-------|
| `Control_list_project_ownership → Get` | cross_community | 5 |
| `Demo_hierarchical_trace → _update_registry` | intra_community | 4 |
| `Main → Get_logger` | cross_community | 4 |
| `Wrapper → _update_registry` | cross_community | 4 |
| `Track_workflow_execution → _update_registry` | cross_community | 4 |
| `Track_agent_activation → _update_registry` | cross_community | 4 |
| `Control_list_project_ownership → _create_project_session_manager` | cross_community | 3 |
| `Control_list_session_ownership → Get_session` | cross_community | 3 |
| `Control_list_session_ownership → _create_session_manager` | cross_community | 3 |
| `Wrapper → Get_tracker` | cross_community | 3 |
## Connected Areas
| Area | Connections |
|------|-------------|
| Unit | 32 calls |
| Agents | 2 calls |
| Tools | 2 calls |
| Recovery | 1 calls |
| Control_plane | 1 calls |
## How to Explore
1. `gitnexus_context({name: "demo_hierarchical_trace"})` — see callers and callees
2. `gitnexus_query({query: "observability"})` — find related execution flows
3. Read key files listed above for implementation details
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |