@aaac/observability 0.1.13 → 0.1.15
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.
- package/README.md +33 -0
- package/dist/{chunk-RUVM5AAO.js → chunk-3DXZNA3E.js} +1024 -15
- package/dist/chunk-3DXZNA3E.js.map +1 -0
- package/dist/chunk-EKFRH7PX.js +266 -0
- package/dist/chunk-EKFRH7PX.js.map +1 -0
- package/dist/cli/global-record.d.ts +53 -0
- package/dist/cli/global-record.js +239 -0
- package/dist/cli/global-record.js.map +1 -0
- package/dist/cli/index.js +330 -210
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +385 -6
- package/dist/index.js +43 -3
- package/package.json +3 -2
- package/dist/chunk-RUVM5AAO.js.map +0 -1
package/README.md
CHANGED
|
@@ -43,11 +43,44 @@ aaac-observ record --event-type process.edit --lifecycle instant --attr edit.pat
|
|
|
43
43
|
aaac-observ query trace --trace-id <id>
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
+
## E2E Test Helpers (observability stack)
|
|
47
|
+
|
|
48
|
+
The `__tests__/e2e/stack/` directory contains a full E2E harness for the
|
|
49
|
+
aaac observability stack (ClickHouse / Tempo / Grafana). Follow-up issues
|
|
50
|
+
(`#163+`) can import the shared helpers:
|
|
51
|
+
|
|
52
|
+
```typescript
|
|
53
|
+
import {
|
|
54
|
+
seedAndBackfill,
|
|
55
|
+
queryClickHouse,
|
|
56
|
+
assertViewRow,
|
|
57
|
+
applyAnalysisViews,
|
|
58
|
+
waitForSeedData,
|
|
59
|
+
} from '@aaac/observability/__tests__/e2e/stack/helpers.js';
|
|
60
|
+
import { SEED_SESSION_ID } from
|
|
61
|
+
'@aaac/observability/__tests__/e2e/stack/__fixtures__/observability-stack-seed.js';
|
|
62
|
+
import { loadStackConfig } from '@aaac/observability/src/e2e/load-stack-config.js';
|
|
63
|
+
|
|
64
|
+
// Example usage in a follow-up E2E test:
|
|
65
|
+
const config = loadStackConfig();
|
|
66
|
+
const seed = await seedAndBackfill(config, { flushTimeoutMs: 30_000 });
|
|
67
|
+
await waitForSeedData(config, SEED_SESSION_ID);
|
|
68
|
+
const rows = await queryClickHouse<{ session_id: string }>(
|
|
69
|
+
config,
|
|
70
|
+
'SELECT session_id FROM aaac_agent_sessions LIMIT 1',
|
|
71
|
+
);
|
|
72
|
+
assertViewRow(rows, 'session_id', SEED_SESSION_ID);
|
|
73
|
+
await seed.cleanup();
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
See `docs/observability-setup.md` for full E2E run instructions.
|
|
77
|
+
|
|
46
78
|
## Documentation
|
|
47
79
|
|
|
48
80
|
- Event format and catalog: `docs/observability-spec/event-catalog.md`
|
|
49
81
|
- Architecture: `docs/observability-spec/architecture.md`
|
|
50
82
|
- 3-axis model: `docs/observability-spec/shift-left-guidline-v2.md`
|
|
83
|
+
- E2E setup and run: `docs/observability-setup.md`
|
|
51
84
|
|
|
52
85
|
## License
|
|
53
86
|
|