@senad-d/observme 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/.env.example +57 -0
  2. package/CHANGELOG.md +52 -0
  3. package/LICENSE +21 -0
  4. package/ObservMe-Production-Docs/00-README.md +79 -0
  5. package/ObservMe-Production-Docs/01-requirements-and-scope.md +207 -0
  6. package/ObservMe-Production-Docs/02-reference-architecture.md +306 -0
  7. package/ObservMe-Production-Docs/03-pi-event-and-session-model.md +266 -0
  8. package/ObservMe-Production-Docs/04-telemetry-semantic-conventions.md +722 -0
  9. package/ObservMe-Production-Docs/05-otel-pipeline-and-collector.md +355 -0
  10. package/ObservMe-Production-Docs/06-security-privacy-redaction.md +294 -0
  11. package/ObservMe-Production-Docs/07-extension-implementation-blueprint.md +447 -0
  12. package/ObservMe-Production-Docs/08-query-grafana-integration.md +276 -0
  13. package/ObservMe-Production-Docs/09-dashboards-alerts-slos.md +640 -0
  14. package/ObservMe-Production-Docs/10-testing-release-operations.md +319 -0
  15. package/ObservMe-Production-Docs/11-deployment-runbooks.md +203 -0
  16. package/ObservMe-Production-Docs/12-configuration-reference.md +337 -0
  17. package/ObservMe-Production-Docs/13-source-notes.md +33 -0
  18. package/ObservMe-Production-Docs/pi-session-format.md +427 -0
  19. package/README.md +356 -0
  20. package/SECURITY.md +45 -0
  21. package/dashboards/observme-agent-node-graphs.json +250 -0
  22. package/dashboards/observme-agents.json +1880 -0
  23. package/dashboards/observme-alerts.yaml +113 -0
  24. package/dashboards/observme-branches-compactions.json +1042 -0
  25. package/dashboards/observme-cost.json +1254 -0
  26. package/dashboards/observme-errors.json +1659 -0
  27. package/dashboards/observme-export-health.json +1802 -0
  28. package/dashboards/observme-latency.json +1494 -0
  29. package/dashboards/observme-llm-conversations.json +730 -0
  30. package/dashboards/observme-logs-llm.json +644 -0
  31. package/dashboards/observme-models.json +933 -0
  32. package/dashboards/observme-overview.json +2129 -0
  33. package/dashboards/observme-slo-health.json +737 -0
  34. package/dashboards/observme-slos.yaml +56 -0
  35. package/dashboards/observme-tools.json +902 -0
  36. package/dashboards/observme-trace-journey.json +1793 -0
  37. package/docs/STRUCTURE.md +49 -0
  38. package/docs/agent-subagent-observability-requirements.md +997 -0
  39. package/docs/compatibility-matrix.md +39 -0
  40. package/docs/configuration-tui-design-standard.md +767 -0
  41. package/docs/configuration.md +38 -0
  42. package/docs/review-validation.md +115 -0
  43. package/docs/validation-flow.md +117 -0
  44. package/examples/collector.yaml +123 -0
  45. package/examples/observme.yaml +131 -0
  46. package/img/demo.gif +0 -0
  47. package/img/icon.svg +47 -0
  48. package/package.json +103 -0
  49. package/src/commands/obs-agents-runtime.ts +150 -0
  50. package/src/commands/obs-agents.ts +491 -0
  51. package/src/commands/obs-args.ts +63 -0
  52. package/src/commands/obs-backfill.ts +1334 -0
  53. package/src/commands/obs-command-support.ts +43 -0
  54. package/src/commands/obs-cost.ts +228 -0
  55. package/src/commands/obs-diagnostics.ts +22 -0
  56. package/src/commands/obs-errors.ts +156 -0
  57. package/src/commands/obs-health.ts +301 -0
  58. package/src/commands/obs-link.ts +90 -0
  59. package/src/commands/obs-logs.ts +194 -0
  60. package/src/commands/obs-loki-summary.ts +184 -0
  61. package/src/commands/obs-session.ts +259 -0
  62. package/src/commands/obs-status.ts +359 -0
  63. package/src/commands/obs-tools.ts +274 -0
  64. package/src/commands/obs-trace.ts +411 -0
  65. package/src/commands/obs.ts +211 -0
  66. package/src/config/bootstrap-project-config.ts +300 -0
  67. package/src/config/defaults.ts +143 -0
  68. package/src/config/load-config.ts +631 -0
  69. package/src/config/project-paths.ts +61 -0
  70. package/src/config/schema.ts +405 -0
  71. package/src/config/validate.ts +456 -0
  72. package/src/constants.ts +4 -0
  73. package/src/diagnostics/sanitize.ts +6 -0
  74. package/src/extension.ts +38 -0
  75. package/src/otel/logs.ts +160 -0
  76. package/src/otel/metrics.ts +165 -0
  77. package/src/otel/otlp-endpoint.ts +10 -0
  78. package/src/otel/sdk.ts +114 -0
  79. package/src/otel/shutdown.ts +102 -0
  80. package/src/otel/traces.ts +166 -0
  81. package/src/pi/agent-lineage.ts +378 -0
  82. package/src/pi/agent-tree-tracker.ts +258 -0
  83. package/src/pi/event-handlers/agent-turn.ts +155 -0
  84. package/src/pi/event-handlers/lifecycle.ts +642 -0
  85. package/src/pi/event-handlers/llm.ts +115 -0
  86. package/src/pi/event-handlers/session-events.ts +159 -0
  87. package/src/pi/event-handlers/tool-bash.ts +275 -0
  88. package/src/pi/handler-internals.ts +2154 -0
  89. package/src/pi/handler-runtime.ts +633 -0
  90. package/src/pi/handler-types.ts +261 -0
  91. package/src/pi/handlers.ts +75 -0
  92. package/src/pi/subagent-spawn.ts +975 -0
  93. package/src/pi/subagent-types.ts +29 -0
  94. package/src/privacy/content-capture.ts +104 -0
  95. package/src/privacy/hash.ts +93 -0
  96. package/src/privacy/redact.ts +619 -0
  97. package/src/privacy/secret-patterns.ts +185 -0
  98. package/src/privacy/truncate.ts +69 -0
  99. package/src/query/grafana-readiness.ts +164 -0
  100. package/src/query/grafana-transport.ts +481 -0
  101. package/src/query/grafana.ts +371 -0
  102. package/src/query/loki.ts +332 -0
  103. package/src/query/prometheus.ts +388 -0
  104. package/src/query/tempo.ts +332 -0
  105. package/src/safety/sensitive-input.ts +208 -0
  106. package/src/semconv/attributes.ts +279 -0
  107. package/src/semconv/metrics.ts +146 -0
  108. package/src/semconv/spans.ts +19 -0
  109. package/src/semconv/values.ts +13 -0
  110. package/src/util/bounded-map.ts +97 -0
  111. package/tsconfig.json +15 -0
@@ -0,0 +1,113 @@
1
+ groups:
2
+ - name: observme.alerts
3
+ rules:
4
+ - alert: ObservMeHighLlmErrorRate
5
+ expr: >-
6
+ sum(rate(observme_llm_errors_total[10m])) / clamp_min(sum(rate(observme_llm_requests_total[10m])), 1e-9) > 0.05
7
+ for: 10m
8
+ labels:
9
+ severity: warning
10
+ annotations:
11
+ summary: High LLM error rate
12
+ description: More than 5% of ObservMe LLM requests are failing over 10 minutes.
13
+ runbook: "Severity guidance from production docs: warning."
14
+ - alert: ObservMeHighToolFailureRate
15
+ expr: >-
16
+ sum(rate(observme_tool_failures_total[10m])) by (tool_name) / clamp_min(sum(rate(observme_tool_calls_total[10m])) by (tool_name), 1e-9) > 0.10
17
+ for: 10m
18
+ labels:
19
+ severity: warning
20
+ annotations:
21
+ summary: High tool failure rate
22
+ description: More than 10% of ObservMe tool calls are failing for one tool_name over 10 minutes.
23
+ runbook: "Severity guidance from production docs: warning."
24
+ - alert: ObservMeSubagentSpawnFailures
25
+ expr: >-
26
+ sum(rate(observme_subagent_spawn_failures_total[10m])) > 0
27
+ for: 10m
28
+ labels:
29
+ severity: warning
30
+ annotations:
31
+ summary: Subagent spawn failures detected
32
+ description: At least one ObservMe subagent spawn failure occurred in the last 10 minutes.
33
+ runbook: "Severity guidance from production docs: warning."
34
+ - alert: ObservMeExportDropsDetected
35
+ expr: >-
36
+ sum(rate(observme_telemetry_dropped_total[5m])) > 0
37
+ for: 5m
38
+ labels:
39
+ severity: warning
40
+ annotations:
41
+ summary: Export drops detected
42
+ description: ObservMe is locally dropping telemetry before export.
43
+ runbook: "Severity guidance from production docs: warning."
44
+ - alert: ObservMeCostSpike
45
+ expr: >-
46
+ sum(increase(observme_llm_cost_usd_total[1h])) > 50
47
+ for: 15m
48
+ labels:
49
+ severity: budget-dependent
50
+ annotations:
51
+ summary: LLM cost spike
52
+ description: ObservMe LLM spend increased by more than 50 USD in one hour.
53
+ runbook: "Severity guidance from production docs: depends on organization budget."
54
+ - alert: ObservMeRedactionFailures
55
+ expr: >-
56
+ sum(rate(observme_redaction_failures_total[5m])) > 0
57
+ for: 5m
58
+ labels:
59
+ severity: critical
60
+ annotations:
61
+ summary: Redaction failures detected
62
+ description: ObservMe redaction failures occurred; treat as critical when content capture is enabled.
63
+ runbook: "Severity guidance from production docs: critical if content capture is enabled."
64
+ - alert: ObservMeRunawayAgentFanOut
65
+ expr: >-
66
+ histogram_quantile(0.95, sum(rate(observme_agent_fanout_count_bucket[10m])) by (le)) > 20
67
+ for: 10m
68
+ labels:
69
+ severity: warning
70
+ annotations:
71
+ summary: Runaway agent fan-out
72
+ description: p95 ObservMe agent fan-out exceeded 20 over 10 minutes.
73
+ runbook: "Severity guidance from production docs: warning; tune the threshold to the organization's normal orchestrator workload."
74
+ - alert: ObservMeExcessiveAgentTreeDepth
75
+ expr: >-
76
+ histogram_quantile(0.95, sum(rate(observme_agent_tree_depth_bucket[10m])) by (le)) > 5
77
+ for: 10m
78
+ labels:
79
+ severity: warning
80
+ annotations:
81
+ summary: Excessive agent tree depth
82
+ description: p95 ObservMe agent tree depth exceeded 5 over 10 minutes.
83
+ runbook: "Severity guidance from production docs: warning; tune the threshold to expected maximum delegation depth."
84
+ - alert: ObservMeOrphanAgentsDetected
85
+ expr: >-
86
+ sum(rate(observme_orphan_agents_total[10m])) > 0
87
+ for: 10m
88
+ labels:
89
+ severity: warning
90
+ annotations:
91
+ summary: Orphan agents detected
92
+ description: ObservMe detected agent runtimes without usable parent lineage.
93
+ runbook: "Severity guidance from production docs: warning."
94
+ - alert: ObservMeTraceContextPropagationFailures
95
+ expr: >-
96
+ sum(rate(observme_trace_context_propagation_failures_total[10m])) > 0
97
+ for: 10m
98
+ labels:
99
+ severity: warning
100
+ annotations:
101
+ summary: Trace-context propagation failures
102
+ description: ObservMe failed to propagate or recover trace context for subagent work.
103
+ runbook: "Severity guidance from production docs: warning."
104
+ - alert: ObservMeActiveAgentsStuckHigh
105
+ expr: >-
106
+ sum(observme_active_agents) > 100
107
+ for: 30m
108
+ labels:
109
+ severity: deployment-dependent
110
+ annotations:
111
+ summary: Active agents stuck high
112
+ description: ObservMe active-agent gauge remains above 100.
113
+ runbook: "Severity guidance from production docs: depends on normal fleet size; tune per deployment."