sporades 0.9.30 โ†’ 0.9.31

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 (103) hide show
  1. package/CHANGES.md +69 -5
  2. package/README.md +3 -0
  3. package/bin/sporades-host-helper.js +1431 -552
  4. package/bin/sporades.js +19258 -2610
  5. package/dist/bundle-pipeline.d.ts +7 -1
  6. package/dist/bundle-pipeline.d.ts.map +1 -1
  7. package/dist/bundle-pipeline.js +11 -6
  8. package/dist/bundle-pipeline.js.map +1 -1
  9. package/dist/cli/cli-help.d.ts +7 -5
  10. package/dist/cli/cli-help.d.ts.map +1 -1
  11. package/dist/cli/cli-help.js +39 -0
  12. package/dist/cli/cli-help.js.map +1 -1
  13. package/dist/cli/cli-version.d.ts +1 -1
  14. package/dist/cli/cli-version.js +1 -1
  15. package/dist/cli/host-autostart.d.ts +15 -0
  16. package/dist/cli/host-autostart.d.ts.map +1 -0
  17. package/dist/cli/host-autostart.js +61 -0
  18. package/dist/cli/host-autostart.js.map +1 -0
  19. package/dist/cli/host-helper-requests.d.ts +13 -3
  20. package/dist/cli/host-helper-requests.d.ts.map +1 -1
  21. package/dist/cli/host-metrics.d.ts +27 -0
  22. package/dist/cli/host-metrics.d.ts.map +1 -0
  23. package/dist/cli/host-metrics.js +269 -0
  24. package/dist/cli/host-metrics.js.map +1 -0
  25. package/dist/cli/host-telemetry-relay.d.ts +120 -0
  26. package/dist/cli/host-telemetry-relay.d.ts.map +1 -0
  27. package/dist/cli/host-telemetry-relay.js +271 -0
  28. package/dist/cli/host-telemetry-relay.js.map +1 -0
  29. package/dist/cli/hosted-capsule-contract.d.ts +6 -0
  30. package/dist/cli/hosted-capsule-contract.d.ts.map +1 -1
  31. package/dist/cli/hosted-telemetry-coverage.d.ts +29 -0
  32. package/dist/cli/hosted-telemetry-coverage.d.ts.map +1 -0
  33. package/dist/cli/hosted-telemetry-coverage.js +25 -0
  34. package/dist/cli/hosted-telemetry-coverage.js.map +1 -0
  35. package/dist/cli/monitoring-stack.d.ts +16 -0
  36. package/dist/cli/monitoring-stack.d.ts.map +1 -0
  37. package/dist/cli/monitoring-stack.js +110 -0
  38. package/dist/cli/monitoring-stack.js.map +1 -0
  39. package/dist/cli/project-config.d.ts.map +1 -1
  40. package/dist/cli/project-config.js +3 -0
  41. package/dist/cli/project-config.js.map +1 -1
  42. package/dist/cli/sporades-host-helper.js +246 -11
  43. package/dist/cli/sporades-host-helper.js.map +1 -1
  44. package/dist/cli/sporades.js +872 -302
  45. package/dist/cli/sporades.js.map +1 -1
  46. package/dist/cli/telemetry-profile.d.ts +31 -0
  47. package/dist/cli/telemetry-profile.d.ts.map +1 -0
  48. package/dist/cli/telemetry-profile.js +161 -0
  49. package/dist/cli/telemetry-profile.js.map +1 -0
  50. package/dist/dev-clamav-sidecar.d.ts.map +1 -1
  51. package/dist/dev-clamav-sidecar.js +11 -1
  52. package/dist/dev-clamav-sidecar.js.map +1 -1
  53. package/dist/file-storage-runtime.d.ts.map +1 -1
  54. package/dist/file-storage-runtime.js +12 -9
  55. package/dist/file-storage-runtime.js.map +1 -1
  56. package/dist/generated-source-manifest.json +42 -2
  57. package/dist/http-runtime.d.ts.map +1 -1
  58. package/dist/http-runtime.js +2 -1
  59. package/dist/http-runtime.js.map +1 -1
  60. package/dist/jobs-runtime.d.ts +5 -1
  61. package/dist/jobs-runtime.d.ts.map +1 -1
  62. package/dist/jobs-runtime.js +9 -3
  63. package/dist/jobs-runtime.js.map +1 -1
  64. package/dist/log-envelope.d.ts +2 -0
  65. package/dist/log-envelope.d.ts.map +1 -1
  66. package/dist/log-envelope.js +13 -4
  67. package/dist/log-envelope.js.map +1 -1
  68. package/dist/runtime-request-context.d.ts +10 -0
  69. package/dist/runtime-request-context.d.ts.map +1 -0
  70. package/dist/runtime-request-context.js +8 -0
  71. package/dist/runtime-request-context.js.map +1 -0
  72. package/dist/runtime-telemetry.d.ts +42 -0
  73. package/dist/runtime-telemetry.d.ts.map +1 -0
  74. package/dist/runtime-telemetry.js +369 -0
  75. package/dist/runtime-telemetry.js.map +1 -0
  76. package/dist/team-billing-management.d.ts.map +1 -1
  77. package/dist/team-billing-management.js +10 -4
  78. package/dist/team-billing-management.js.map +1 -1
  79. package/dist/templates/client-runtime-template.d.ts.map +1 -1
  80. package/dist/templates/client-runtime-template.js +58 -15
  81. package/dist/templates/client-runtime-template.js.map +1 -1
  82. package/dist/templates/server-bundle-entry.d.ts.map +1 -1
  83. package/dist/templates/server-bundle-entry.js +34 -4
  84. package/dist/templates/server-bundle-entry.js.map +1 -1
  85. package/monitoring/trace/.dockerignore +3 -0
  86. package/monitoring/trace/.env.example +15 -0
  87. package/monitoring/trace/Dockerfile.gateway +5 -0
  88. package/monitoring/trace/README.md +53 -0
  89. package/monitoring/trace/api-dashboard.json +261 -0
  90. package/monitoring/trace/caddy-dashboard.json +363 -0
  91. package/monitoring/trace/collector.yaml +47 -0
  92. package/monitoring/trace/compose.yaml +129 -0
  93. package/monitoring/trace/gateway.mjs +184 -0
  94. package/monitoring/trace/gitignore.template +6 -0
  95. package/monitoring/trace/grafana-dashboard-provider.yaml +10 -0
  96. package/monitoring/trace/grafana-datasource.yaml +9 -0
  97. package/monitoring/trace/host-dashboard.json +726 -0
  98. package/monitoring/trace/jaeger.yaml +42 -0
  99. package/monitoring/trace/prometheus.yaml +11 -0
  100. package/monitoring/trace/resource-dashboard.json +484 -0
  101. package/monitoring/trace/setup.mjs +109 -0
  102. package/monitoring/trace/smoke.mjs +61 -0
  103. package/package.json +9 -1
package/CHANGES.md CHANGED
@@ -1,17 +1,81 @@
1
1
  # Changes
2
2
 
3
- ## Unreleased - 2026-09-24
3
+ ## Unreleased - 2026-10-02
4
4
 
5
- Changes since v0.9.29.
5
+ Changes since v0.9.30.
6
+
7
+ ### ๐Ÿš€ Features
8
+
9
+ - Open telemetry docs (a1ef804f).
10
+ - Enable Host-owned telemetry coverage for Hosted Capsules (7b1af535).
11
+ - Add shared remote Host telemetry relay transport (f13f233a).
12
+ - Add GC and event-loop pressure telemetry (2d40feb9).
13
+ - Add periodic Capsule process resource telemetry (372ea49c).
14
+ - Add installed CLI generation for monitoring trace stack (6c17d973).
15
+ - Add standalone authenticated trace Compose stack for telemetry (1f814483).
6
16
 
7
17
  ### ๐Ÿ› Bug Fixes
8
18
 
9
- - Refresh only live queries that read a written table (6942754d).
10
- - Detect Promise combinators from call sites, not formatted stacks (a55a4fd3).
19
+ - Bound ClamAV proxy Unix socket paths (#184) (a8369517).
20
+ - Fix upload, billing, browser and Host recovery ownership (1c9c74cd).
21
+ - Retain event loop stalls across metric collection (400f8961).
22
+ - Report event loop lag beyond sampling interval (6da7bc39).
23
+ - Fix bounded HTTP telemetry shutdown flush and 4xx span status (975fc10b).
24
+ - Fix telemetry status on pre-header HTTP abort (5d3a5e73).
25
+ - Reject normalized smoke origin inputs (dc1b6bc5).
26
+ - Accept canonical smoke origin spellings (82e1a9d5).
27
+ - Use certificate hostname for trace smoke origin (7c342a9f).
28
+ - Fix monitoring UI proxy lifecycle and resource p95 abort filter (5fe52461).
29
+ - Fix monitoring stack credentials, selectors, and trace retention (8cfb29d0).
30
+
31
+ ### ๐Ÿ“ Documentation
32
+
33
+ - Resume Hosted Capsules after Host startup through shared bootstrap (66b3cfb2).
34
+ - Monitor Host pressure and Caddy through the telemetry relay (a3cc4c6c).
35
+ - Document Hosted telemetry opt-out in Host help (d2774a66).
36
+ - Report unverified Hosted telemetry coverage separately (88f56f08).
37
+ - Serialize relay reconciliation and retain Host telemetry settings (0c3bb23a).
38
+ - Export reset-gap max when native histogram has no samples (c89fad6b).
39
+ - Preserve event-loop pressure across histogram reset gap (22f78582).
40
+ - Clarify local telemetry selection ownership (b4a52e9d).
41
+ - Preserve legacy Container bundle during Dev and Host publication (140c2d6d).
42
+ - Pin telemetry exporter policy to selected profile (66f43dc2).
43
+ - Keep local Container telemetry across Dev bundle rebuilds (b643f0e2).
44
+ - Reconcile staged telemetry CA after interrupted Container deploy (ea02a390).
45
+ - Validate and stage Container telemetry CA before replacement (1db92c8a).
46
+ - Detach runtime background logs from HTTP request identity (fe6101ff).
47
+ - Harden telemetry gateway uploads and readiness (59863d33).
48
+ - Report metric export failures through telemetry diagnostics (e7a8ac4d).
49
+ - Keep telemetry dashboards readable at sparse export intervals (398ed840).
50
+ - Correlate existing logs with HTTP trace identities (0fb9ccbd).
51
+ - Clarify shipped API metrics in telemetry roadmap (09290f93).
52
+ - Measure Capsule API traffic with portable Prometheus and Grafana stack (e96a84a5).
53
+ - Report bounded local telemetry export failures (2a279361).
54
+ - Trace local Container HTTP requests with explicit telemetry profiles (94fc09d0).
55
+ - Trace Dev HTTP requests through operator Telemetry profiles (c8f34e4e).
56
+ - Harden monitoring stack initialization and prerequisite checks (52fdd593).
57
+ - Keep trace gateway non-root after root setup (44826c0f).
58
+ - Constrain trace UI proxy and preserve literal stack credentials (ffcb64ea).
59
+
60
+ ### ๐Ÿงช Tests
61
+
62
+ - Expect Host-owned telemetry input in failed start fixture (c2d2b0b9).
63
+ - Expect unverified coverage from legacy Host fixture (52c02c9c).
64
+ - Flush telemetry after failed shutdown and classify CA chain errors (24d35576).
65
+ - Clean up Dev startup when watcher setup fails (eb20c57d).
66
+ - Clean up private Dev action bundles across session lifecycle (6c651120).
67
+ - Prove Container identity after Dev rebuild in Docker acceptance (db9ea7e0).
68
+ - Journal bound telemetry CA across forced replacement (f5e8ad8f).
69
+ - Journal replacement when retiring a bound telemetry CA (d6678b9e).
70
+ - Close incomplete UI upload sockets after proxy response (505642fc).
71
+ - Account for request context in Bundle census (3a78fa47).
72
+ - Support frozen injected runtime clocks (d6c51994).
73
+ - Preserve injected runtime clock receivers (fece8d3d).
74
+ - Guard Telemetry profile names and cover Bundle module census (1e9e3e61).
11
75
 
12
76
  ### ๐Ÿ“ฆ Packaging
13
77
 
14
- - Regenerate runtime artifacts for scoped live query refresh (14235222).
78
+ - Sync npm lock with telemetry metrics dependencies (3e706c67).
15
79
 
16
80
  ## v0.9.11 - 2026-09-02
17
81
 
package/README.md CHANGED
@@ -217,6 +217,9 @@ Sporades currently includes:
217
217
  - Local Docker Container sessions for production-like staging tests.
218
218
  - Hosted Capsules on SSH-reachable Host servers, routed through Caddy and run in
219
219
  hardened Docker containers.
220
+ - A [standalone trace stack](monitoring/trace/README.md), generated by `sporades monitoring stack init --dir <path>`, with authenticated
221
+ OTLP/HTTP ingestion, persistent Jaeger storage, and protected trace UI.
222
+ - Opt-in Dev and local Container HTTP request tracing through [operator Telemetry profiles](https://mgscox.github.io/sporades/reference/projects-and-configuration#local-http-tracing), with bounded route labels and no Capsule instrumentation import.
220
223
  - Runtime-owned auth with anonymous sessions, email auth, Google OAuth,
221
224
  Microsoft OpenID Connect, Sign in with Apple, Facebook Login, and
222
225
  local identity simulation for tests and agents.