@teamscala/service-boot 0.23.326 → 0.23.327

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 (162) hide show
  1. package/package.json +532 -524
  2. package/src/agreement-gate.d.ts +19 -0
  3. package/src/agreement-gate.ts +3 -12
  4. package/src/asset-cache-key.d.ts +11 -0
  5. package/src/asset-optimize.d.ts +17 -0
  6. package/src/asset-proxy.d.ts +11 -0
  7. package/src/asset-social-card.d.ts +17 -0
  8. package/src/attach-agreement-magic.d.ts +20 -0
  9. package/src/attach-portal-members.d.ts +23 -0
  10. package/src/attach-proposal-accept.d.ts +26 -0
  11. package/src/attach-proposal-magic.d.ts +18 -0
  12. package/src/attach-transfers-upload.d.ts +27 -0
  13. package/src/auth-gate.d.ts +28 -0
  14. package/src/auth-gate.ts +6 -68
  15. package/src/bind-page-handler.d.ts +18 -0
  16. package/src/build-client-assets/input-hashing.d.ts +25 -0
  17. package/src/build-client-assets/source-candidates.d.ts +27 -0
  18. package/src/build-client-assets.d.ts +50 -0
  19. package/src/build-client-assets.test.ts +1 -1
  20. package/src/build-client-assets.ts +1 -1
  21. package/src/compose-page-title.d.ts +41 -0
  22. package/src/content-gate/access.d.ts +15 -0
  23. package/src/content-gate/config-types.d.ts +99 -0
  24. package/src/content-gate/gate.d.ts +13 -0
  25. package/src/content-gate/parse-cookie.d.ts +9 -0
  26. package/src/content-gate/token.d.ts +48 -0
  27. package/src/content-page-floor.d.ts +39 -0
  28. package/src/discover-blocks.d.ts +28 -0
  29. package/src/discover-blocks.ts +1 -1
  30. package/src/expand-roster.d.ts +34 -0
  31. package/src/fn-routers/agreement-completion-email.d.ts +14 -0
  32. package/src/fn-routers/agreement-send-router.d.ts +82 -0
  33. package/src/fn-routers/ai-health-router.d.ts +35 -0
  34. package/src/fn-routers/auth-router.d.ts +47 -0
  35. package/src/fn-routers/cache-admin-router.d.ts +57 -0
  36. package/src/fn-routers/chat-session-router.d.ts +219 -0
  37. package/src/fn-routers/email-defaults.d.ts +1 -0
  38. package/src/fn-routers/email-link-ttl.d.ts +1 -0
  39. package/src/fn-routers/index.d.ts +18 -0
  40. package/src/fn-routers/index.ts +0 -2
  41. package/src/fn-routers/panel-data-router.d.ts +19 -0
  42. package/src/fn-routers/persist-chat-messages.d.ts +36 -0
  43. package/src/fn-routers/plans-router.d.ts +25 -0
  44. package/src/fn-routers/proposal-send-router.d.ts +58 -0
  45. package/src/fn-routers/public-agreement-router.d.ts +289 -0
  46. package/src/fn-routers/public-assessment-router.d.ts +68 -0
  47. package/src/fn-routers/public-gpt-session-router.d.ts +143 -0
  48. package/src/fn-routers/sign-in-flow-router.d.ts +107 -0
  49. package/src/fn-routers/task-sync-assign.d.ts +305 -0
  50. package/src/fn-routers/task-sync-assign.test.ts +1 -2
  51. package/src/fn-routers/task-sync-assign.ts +4 -4
  52. package/src/fn-routers/task-sync-bind.test.ts +18 -18
  53. package/src/fn-routers/task-sync-brief.d.ts +96 -0
  54. package/src/fn-routers/task-sync-brief.test.ts +17 -20
  55. package/src/fn-routers/task-sync-brief.ts +14 -15
  56. package/src/fn-routers/task-sync-dispatch.d.ts +61 -0
  57. package/src/fn-routers/task-sync-dispatch.test.ts +33 -51
  58. package/src/fn-routers/task-sync-dispatch.ts +124 -0
  59. package/src/fn-routers/task-sync-lane.d.ts +49 -0
  60. package/src/fn-routers/task-sync-lane.ts +125 -0
  61. package/src/fn-routers/task-sync-projection.d.ts +121 -0
  62. package/src/fn-routers/task-sync-projection.test.ts +0 -26
  63. package/src/fn-routers/task-sync-projection.ts +0 -51
  64. package/src/fn-routers/task-sync-rename.d.ts +91 -0
  65. package/src/fn-routers/task-sync-router.d.ts +424 -0
  66. package/src/fn-routers/task-sync-router.test.ts +2 -14
  67. package/src/fn-routers/task-sync-router.ts +1106 -0
  68. package/src/fn-routers/tasks-router.d.ts +25 -0
  69. package/src/fn-routers/user-preferences-router.d.ts +77 -0
  70. package/src/fn-routers/work-items-router.d.ts +102 -0
  71. package/src/gate-ttls.d.ts +6 -0
  72. package/src/gpt-gate.d.ts +25 -0
  73. package/src/handlers/bun-stable-watch.d.ts +1 -0
  74. package/src/handlers/pane-outbox-drain.d.ts +1 -0
  75. package/src/handlers/projects-digest.d.ts +26 -0
  76. package/src/handlers/prune-stale-data.d.ts +30 -0
  77. package/src/handlers/registry-stale-inactive-sweep.d.ts +1 -0
  78. package/src/handlers/scala-tools-currency-watch.d.ts +1 -0
  79. package/src/handlers/singleton-tools-currency-watch.d.ts +1 -0
  80. package/src/handlers/singleton-tools-currency-watch.ts +11 -114
  81. package/src/handlers/sweep-event-log.d.ts +1 -0
  82. package/src/handlers/sweep-host-cache.d.ts +1 -0
  83. package/src/handlers/sweep-host-cache.ts +26 -143
  84. package/src/handlers/upstream-issue-sync.d.ts +1 -0
  85. package/src/handlers/whatsapp-liveness-logic.d.ts +34 -0
  86. package/src/handlers/whatsapp-liveness.d.ts +4 -0
  87. package/src/hono-error-handler.d.ts +25 -0
  88. package/src/install-harness.d.ts +45 -0
  89. package/src/install-logging.d.ts +34 -0
  90. package/src/install-logging.ts +0 -3
  91. package/src/load-service-install-row.d.ts +24 -0
  92. package/src/load-service-prisma-client.d.ts +18 -0
  93. package/src/mount-orpc-router.d.ts +15 -0
  94. package/src/mount-orpc-router.ts +1 -1
  95. package/src/mount-server-packages.d.ts +29 -0
  96. package/src/mount.d.ts +9 -0
  97. package/src/mutable-app-ref.d.ts +44 -0
  98. package/src/page-route-shell-types.d.ts +12 -0
  99. package/src/page-server-orpc/audit-revert-router.d.ts +37 -0
  100. package/src/page-server-orpc/hub-mcp-client.d.ts +12 -0
  101. package/src/page-server-orpc/portal-diagnostics-router.d.ts +49 -0
  102. package/src/page-server-orpc/puck-pages-router.d.ts +58 -0
  103. package/src/page-server-orpc/server-client.d.ts +16 -0
  104. package/src/page-server-orpc/templates-router.d.ts +34 -0
  105. package/src/page-server-orpc/user-preferences-router.d.ts +79 -0
  106. package/src/pg-boss-handler-registry.d.ts +27 -0
  107. package/src/pg-boss-mount.d.ts +42 -0
  108. package/src/proposal-authorized-emails.d.ts +28 -0
  109. package/src/proposal-chat-inject.d.ts +17 -0
  110. package/src/proposal-gate.d.ts +18 -0
  111. package/src/read-html-template.d.ts +38 -0
  112. package/src/read-viewport-from-request.d.ts +18 -0
  113. package/src/readiness-gate.d.ts +16 -0
  114. package/src/register-api-routes.d.ts +18 -0
  115. package/src/register-crash-handlers.d.ts +15 -0
  116. package/src/register-page-routes.d.ts +27 -0
  117. package/src/register-page-routes.ts +3 -0
  118. package/src/register-page-server-client.d.ts +11 -0
  119. package/src/register-registry-page-route/ai-chat-prefetch.d.ts +13 -0
  120. package/src/register-registry-page-route/graph-cache.d.ts +30 -0
  121. package/src/register-registry-page-route/meta-title.d.ts +2 -0
  122. package/src/register-registry-page-route/proposal-approval-email-token.d.ts +14 -0
  123. package/src/register-registry-page-route/proposal-brand-stamping.d.ts +28 -0
  124. package/src/register-registry-page-route/resolve-page-data.d.ts +1 -0
  125. package/src/register-registry-page-route.d.ts +27 -0
  126. package/src/register-static-assets.d.ts +13 -0
  127. package/src/register-ws-routes.d.ts +28 -0
  128. package/src/resolve-app-base-url.d.ts +13 -0
  129. package/src/resolve-brand-favicon.d.ts +28 -0
  130. package/src/resolve-brand-favicon.ts +1 -1
  131. package/src/resolve-from-loader-config.d.ts +32 -0
  132. package/src/resolve-service-context.d.ts +17 -0
  133. package/src/resolve-service-port.d.ts +75 -0
  134. package/src/resolve-theme-mode.d.ts +42 -0
  135. package/src/resolvers/fetch-org-brand.d.ts +2 -0
  136. package/src/resolvers/portal-route-paths.d.ts +39 -0
  137. package/src/resolvers/website-by-host-map.d.ts +12 -0
  138. package/src/resource-chat-inject.d.ts +46 -0
  139. package/src/resource-not-found.d.ts +60 -0
  140. package/src/resource-not-found.ts +0 -10
  141. package/src/run-boot-hook-list.d.ts +19 -0
  142. package/src/run-boot-hooks.d.ts +31 -0
  143. package/src/scala-tools-currency-watchdog.d.ts +10 -0
  144. package/src/security-headers.d.ts +12 -0
  145. package/src/serve/serve.d.ts +46 -0
  146. package/src/serve/stamp-transport-identity.d.ts +32 -0
  147. package/src/serve/stamp-transport-identity.ts +2 -14
  148. package/src/server-error-page.d.ts +29 -0
  149. package/src/start-scheduled-jobs.d.ts +18 -0
  150. package/src/two-phase-boot.d.ts +136 -0
  151. package/src/two-phase-boot.ts +17 -85
  152. package/src/two-phase-health-gate.test.ts +2 -13
  153. package/src/types.d.ts +46 -0
  154. package/src/ui-service.d.ts +46 -0
  155. package/src/ws-boot-self-test.d.ts +19 -0
  156. package/src/auth-gate.test.ts +0 -70
  157. package/src/fn-routers/task-sync-close.test.ts +0 -44
  158. package/src/fn-routers/task-sync-close.ts +0 -82
  159. package/src/fn-routers/task-sync-lane.test.ts +0 -36
  160. package/src/handlers/sweep-host-cache.test.ts +0 -133
  161. package/src/serve/stamp-transport-identity.test.ts +0 -24
  162. package/src/two-phase-health-gate-client-only.test.ts +0 -77
@@ -1,36 +0,0 @@
1
- /**
2
- * @system service-boot
3
- * @status handwritten
4
- * @edit edit directly
5
- *
6
- * Behavioral tests for canonical CLI-session lane resolution.
7
- */
8
- import { describe, expect, it } from "bun:test";
9
- import { resolveLaneWorkName } from "./task-sync-lane.ts";
10
-
11
- describe("resolveLaneWorkName", () => {
12
- it("reads the visible label from the active cli_sessions route", async () => {
13
- let query: unknown;
14
- const name = await resolveLaneWorkName(
15
- {
16
- cli_sessions: {
17
- findFirst: async (args: unknown) => {
18
- query = args;
19
- return { id: "session-1", label: "ZeroStack" };
20
- },
21
- },
22
- } as never,
23
- "tmux:%7",
24
- );
25
- expect(name).toBe("ZeroStack");
26
- expect(query).toMatchObject({ where: { host_route: { path: ["pane_id"], equals: "tmux:%7" } } });
27
- });
28
-
29
- it("returns no unverified title when no active session owns the pane", async () => {
30
- const name = await resolveLaneWorkName(
31
- { cli_sessions: { findFirst: async () => null } } as never,
32
- "tmux:%8",
33
- );
34
- expect(name).toBeNull();
35
- });
36
- });
@@ -1,133 +0,0 @@
1
- /**
2
- * @system server-boot
3
- * @status handwritten
4
- * @edit edit directly
5
- *
6
- * Unit tests for the `retention_dirs` helpers (`expandGlob`, `checkDirStale`) —
7
- * the whole-directory prune that bounds Rust `target/` waste. The file-by-mtime
8
- * `retention` path is unchanged; these cover ONLY the new build-cache model:
9
- * (1) glob expansion reaches every repo's target dir; (2) an actively-built dir
10
- * is kept (short-circuits on a fresh file); (3) an abandoned dir is reported
11
- * stale with its full size. Lives next to the handler per co-located-test rule.
12
- */
13
- import { describe, expect, test, beforeEach, afterEach } from "bun:test";
14
- import { mkdtempSync, mkdirSync, writeFileSync, rmSync, utimesSync } from "node:fs";
15
- import { join } from "node:path";
16
- import { tmpdir } from "node:os";
17
- import { expandGlob, checkDirStale, parseRootDiskPct } from "./sweep-host-cache.ts";
18
-
19
- const DAY = 86_400_000;
20
- const now = Date.now();
21
- const daysAgo = (n: number) => new Date(now - n * DAY);
22
- const touch = (p: string, t: Date) => utimesSync(p, t, t);
23
-
24
- let root: string;
25
- beforeEach(() => {
26
- root = mkdtempSync(join(tmpdir(), "sweep-"));
27
- });
28
- afterEach(() => {
29
- rmSync(root, { recursive: true, force: true });
30
- });
31
-
32
- describe("expandGlob", () => {
33
- test("expands a single-segment wildcard to concrete dirs", () => {
34
- mkdirSync(join(root, "scala-rust", "target"), { recursive: true });
35
- mkdirSync(join(root, "scala-os", "target"), { recursive: true });
36
- mkdirSync(join(root, "scala-os", "src"), { recursive: true });
37
- const matches = expandGlob(`${root}/*/target`).sort();
38
- expect(matches).toEqual(
39
- [join(root, "scala-os", "target"), join(root, "scala-rust", "target")].sort(),
40
- );
41
- });
42
- test("literal segment matches only itself", () => {
43
- mkdirSync(join(root, "scala-rust", "target"), { recursive: true });
44
- mkdirSync(join(root, "other", "target"), { recursive: true });
45
- const matches = expandGlob(`${root}/scala-rust/target`);
46
- expect(matches).toEqual([join(root, "scala-rust", "target")]);
47
- });
48
- test("no matches when the wildcard segment has no children", () => {
49
- const matches = expandGlob(`${root}/does-not-exist/*/target`);
50
- expect(matches).toEqual([]);
51
- });
52
- });
53
-
54
- describe("checkDirStale", () => {
55
- test("stale dir: all files older than cutoff → stale + full size", async () => {
56
- const dir = join(root, "target");
57
- mkdirSync(join(dir, "debug", "deps"), { recursive: true });
58
- writeFileSync(join(dir, "debug", "deps", "a.o"), "x".repeat(40));
59
- writeFileSync(join(dir, "debug", "deps", "b.o"), "y".repeat(60));
60
- touch(join(dir, "debug", "deps", "a.o"), daysAgo(40));
61
- touch(join(dir, "debug", "deps", "b.o"), daysAgo(35));
62
- const res = await checkDirStale(dir, now - 30 * DAY);
63
- expect(res.stale).toBe(true);
64
- expect(res.fileCount).toBe(2);
65
- expect(res.bytes).toBe(100);
66
- });
67
- test("active dir: a file newer than cutoff → not stale (short-circuit)", async () => {
68
- const dir = join(root, "target");
69
- mkdirSync(join(dir, "debug"), { recursive: true });
70
- writeFileSync(join(dir, "debug", "old.o"), "x".repeat(40));
71
- touch(join(dir, "debug", "old.o"), daysAgo(40));
72
- writeFileSync(join(dir, "debug", "fresh.o"), "y".repeat(60));
73
- touch(join(dir, "debug", "fresh.o"), daysAgo(1));
74
- const res = await checkDirStale(dir, now - 30 * DAY);
75
- expect(res.stale).toBe(false);
76
- });
77
- test("empty dir → stale with zero bytes", async () => {
78
- const dir = join(root, "target");
79
- mkdirSync(dir, { recursive: true });
80
- const res = await checkDirStale(dir, now - 30 * DAY);
81
- expect(res.stale).toBe(true);
82
- expect(res.bytes).toBe(0);
83
- expect(res.fileCount).toBe(0);
84
- });
85
- });
86
-
87
- describe("parseRootDiskPct", () => {
88
- test("extracts root-fs Use% from df --output=pcent,target output", () => {
89
- const df =
90
- "Use% Mounted on\n" +
91
- " 97% /\n" +
92
- " 45% /home\n";
93
- expect(parseRootDiskPct(df)).toBe(97);
94
- });
95
- test("picks the root mount (/) over nested mounts", () => {
96
- const df =
97
- "Use% Mounted on\n" +
98
- " 10% /proc/x\n" +
99
- " 76% /\n";
100
- expect(parseRootDiskPct(df)).toBe(76);
101
- });
102
- test("returns null when no root-mount line present", () => {
103
- const df = "Use% Mounted on\n 40% /mnt/other\n";
104
- expect(parseRootDiskPct(df)).toBeNull();
105
- });
106
- test("returns null on empty / malformed output", () => {
107
- expect(parseRootDiskPct("")).toBeNull();
108
- expect(parseRootDiskPct("Use% Mounted on")).toBeNull();
109
- });
110
- });
111
-
112
- describe("disk-threshold early-warning regression lock", () => {
113
- const { readFileSync } = require("node:fs");
114
- // Source-shape lock (same pattern as singleton-tools-currency-watch.test.ts):
115
- // the df-check that rides this periodic sweep was once removed in favour of an
116
- // in-process interval watchdog — the wrong architecture (interval watchdogs
117
- // are forbidden; observability is event-driven). This asserts the corrected
118
- // shape survives: the sweep handler MUST carry the event-driven host.disk.high
119
- // emission (logger.warn -> GlitchTip) + the pure parseRootDiskPct helper that
120
- // backs it. Removing either fails this test. The asserted surface is the
121
- // disk early-warning cell of host-resources-have-complete-monitoring.
122
- const src = readFileSync(import.meta.dir + "/sweep-host-cache.ts", "utf-8");
123
- test("handler emits the host.disk.high event (event-driven, not an interval)", () => {
124
- expect(src).toContain('log.warn("host.disk.high"');
125
- expect(src).toContain('kind: "host.disk.high"');
126
- });
127
- test("handler reads df via the sanctioned spawn (no in-process poller)", () => {
128
- expect(src).toContain('command: ["df", "--output=pcent,target"]');
129
- });
130
- test("threshold parse is the exported pure helper", () => {
131
- expect(src).toContain("export function parseRootDiskPct");
132
- });
133
- });
@@ -1,24 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
- import { summariseLocalCommand } from "./stamp-transport-identity.ts";
3
-
4
- describe("local command attribution", () => {
5
- test("never copies command arguments into telemetry", () => {
6
- const token = "operator-token-must-not-appear";
7
- const summary = summariseLocalCommand([
8
- "curl",
9
- "-H",
10
- `x-operator-spawn-token: ${token}`,
11
- "http://127.0.0.1:3021/rpc/spawn",
12
- ]);
13
- expect(summary).toBe("curl [arguments redacted]");
14
- expect(summary).not.toContain(token);
15
- });
16
-
17
- test("keeps a lone executable name", () => {
18
- expect(summariseLocalCommand(["scala-picker"])).toBe("scala-picker");
19
- });
20
-
21
- test("omits an empty command line", () => {
22
- expect(summariseLocalCommand([])).toBeNull();
23
- });
24
- });
@@ -1,77 +0,0 @@
1
- /**
2
- * @system service-boot
3
- * @status handwritten
4
- * @edit edit directly
5
- *
6
- * A CLIENT-ONLY service (`render_mode=client`) must reach ready, even though it
7
- * never registers an SSR page handler.
8
- *
9
- * Separate file from `two-phase-health-gate.test.ts` on purpose: `fullAppReady`
10
- * is module state that only transitions false -> true and has no reset hook, so
11
- * the two ready-paths cannot both be exercised in one module instance. A reset
12
- * hook would exist only for tests.
13
- *
14
- * THE REGRESSION THIS LOCKS (measured 2026-08-07 on scala-agents-ui). Readiness
15
- * used to be flipped INSIDE `setPageHandler`, which was honest while every
16
- * service was SSR. `render_mode=client` made a service that completes phase 2
17
- * and never calls it, so `/health` answered `{"status":"starting"}` FOREVER
18
- * while the process was healthy and serving — boot completed in 5023ms, "Full
19
- * app built: 50 block(s)" logged, `GET /` correctly 302'd to sign-in, and three
20
- * untouched UI services reported ok beside it.
21
- *
22
- * That is precisely what `readiness-gated-boot` forbids ("binary: fully-ready or
23
- * cleanly-unavailable"): a permanently-un-ready health signal makes the
24
- * activator's wake gate and every health-gated router treat a working service as
25
- * down. Exercised through a real Hono request against the REAL exported handler
26
- * (`proxy-is-not-behaviour`) — a source grep would prove the call exists, never
27
- * that the endpoint answers 200.
28
- */
29
-
30
- import { beforeAll, describe, expect, test } from "bun:test";
31
- import { Hono } from "hono";
32
- import {
33
- __resetPhase2StateForTest,
34
- getPageHandlerState,
35
- healthHandler,
36
- markFullAppReady,
37
- } from "./two-phase-boot.ts";
38
-
39
- /** Mount the real handler exactly as buildMinimalApp does. */
40
- const app = new Hono().get("/health", healthHandler);
41
-
42
- describe("/health for a client-only service", () => {
43
- // Bun shares one module instance across every test file in a run, so the SSR
44
- // readiness test's setPageHandler leaks into this file when both run together.
45
- // Without this reset the suite passes file-by-file and fails in CI.
46
- beforeAll(() => {
47
- __resetPhase2StateForTest();
48
- });
49
-
50
- test("before phase 2 completes it reports 503, not ready", async () => {
51
- expect(getPageHandlerState().ready).toBe(false);
52
-
53
- const res = await app.request("/health");
54
-
55
- expect(res.status).toBe(503);
56
- expect(await res.json()).toEqual({ status: "starting" });
57
- });
58
-
59
- test("reaches ready without an SSR page handler", async () => {
60
- // The real client-only phase-2 path: buildFullApp finishes and marks the
61
- // app ready WITHOUT setPageHandler, because there is no SSR handler.
62
- markFullAppReady();
63
-
64
- const state = getPageHandlerState();
65
- expect(state.ready).toBe(true);
66
- // The discriminator: ready is true while hasHandler stays false. Asserting
67
- // both is what separates this from the SSR path — a fix that flipped ready
68
- // by registering a dummy handler would pass `ready` and fail here.
69
- expect(state.hasHandler).toBe(false);
70
-
71
- const res = await app.request("/health");
72
-
73
- expect(res.status).toBe(200);
74
- expect(res.ok).toBe(true);
75
- expect(await res.json()).toEqual({ status: "ok" });
76
- });
77
- });