sentinelayer-cli 0.6.2 → 0.8.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 (159) hide show
  1. package/README.md +996 -996
  2. package/bin/create-sentinelayer.js +5 -5
  3. package/bin/sentinelayer-cli.js +4 -4
  4. package/bin/sl.js +5 -5
  5. package/package.json +64 -63
  6. package/src/agents/jules/config/definition.js +160 -160
  7. package/src/agents/jules/config/system-prompt.js +182 -182
  8. package/src/agents/jules/error-intake.js +51 -51
  9. package/src/agents/jules/fix-cycle.js +17 -17
  10. package/src/agents/jules/loop.js +457 -450
  11. package/src/agents/jules/pulse.js +10 -10
  12. package/src/agents/jules/stream.js +187 -186
  13. package/src/agents/jules/swarm/file-scanner.js +74 -74
  14. package/src/agents/jules/swarm/index.js +11 -11
  15. package/src/agents/jules/swarm/orchestrator.js +362 -362
  16. package/src/agents/jules/swarm/pattern-hunter.js +123 -123
  17. package/src/agents/jules/swarm/sub-agent.js +311 -309
  18. package/src/agents/jules/tools/aidenid-email.js +189 -189
  19. package/src/agents/jules/tools/auth-audit.js +1699 -1691
  20. package/src/agents/jules/tools/dispatch.js +340 -335
  21. package/src/agents/jules/tools/file-edit.js +2 -2
  22. package/src/agents/jules/tools/file-read.js +2 -2
  23. package/src/agents/jules/tools/frontend-analyze.js +570 -570
  24. package/src/agents/jules/tools/glob.js +2 -2
  25. package/src/agents/jules/tools/grep.js +2 -2
  26. package/src/agents/jules/tools/index.js +29 -29
  27. package/src/agents/jules/tools/path-guards.js +2 -2
  28. package/src/agents/jules/tools/runtime-audit.js +507 -507
  29. package/src/agents/jules/tools/shell.js +2 -2
  30. package/src/agents/jules/tools/url-policy.js +100 -100
  31. package/src/agents/persona-visuals.js +64 -61
  32. package/src/agents/shared-tools/dispatch-core.js +320 -315
  33. package/src/agents/shared-tools/file-edit.js +180 -180
  34. package/src/agents/shared-tools/file-read.js +100 -100
  35. package/src/agents/shared-tools/glob.js +168 -168
  36. package/src/agents/shared-tools/grep.js +228 -228
  37. package/src/agents/shared-tools/index.js +46 -46
  38. package/src/agents/shared-tools/path-guards.js +161 -161
  39. package/src/agents/shared-tools/shell.js +383 -383
  40. package/src/ai/aidenid.js +1021 -1009
  41. package/src/ai/client.js +553 -553
  42. package/src/ai/domain-target-store.js +268 -268
  43. package/src/ai/identity-store.js +270 -270
  44. package/src/ai/proxy.js +137 -137
  45. package/src/ai/site-store.js +145 -145
  46. package/src/audit/agents/architecture.js +180 -180
  47. package/src/audit/agents/compliance.js +179 -179
  48. package/src/audit/agents/documentation.js +165 -165
  49. package/src/audit/agents/performance.js +145 -145
  50. package/src/audit/agents/security.js +215 -215
  51. package/src/audit/agents/testing.js +172 -172
  52. package/src/audit/orchestrator.js +557 -557
  53. package/src/audit/package.js +204 -204
  54. package/src/audit/registry.js +284 -284
  55. package/src/audit/replay.js +103 -103
  56. package/src/auth/gate.js +400 -371
  57. package/src/auth/http.js +681 -611
  58. package/src/auth/service.js +1106 -1106
  59. package/src/auth/session-store.js +813 -813
  60. package/src/cli.js +257 -252
  61. package/src/commands/ai/identity-lifecycle.js +1338 -1338
  62. package/src/commands/ai/provision-governance.js +1272 -1272
  63. package/src/commands/ai/shared.js +147 -147
  64. package/src/commands/ai.js +11 -11
  65. package/src/commands/apply.js +12 -12
  66. package/src/commands/audit.js +1171 -1166
  67. package/src/commands/auth.js +419 -419
  68. package/src/commands/chat.js +191 -191
  69. package/src/commands/config.js +184 -184
  70. package/src/commands/cost.js +311 -311
  71. package/src/commands/daemon/core.js +850 -850
  72. package/src/commands/daemon/extended.js +1048 -1048
  73. package/src/commands/daemon/shared.js +213 -213
  74. package/src/commands/daemon.js +11 -11
  75. package/src/commands/guide.js +174 -174
  76. package/src/commands/ingest.js +58 -58
  77. package/src/commands/init.js +55 -55
  78. package/src/commands/legacy-args.js +10 -10
  79. package/src/commands/mcp.js +461 -461
  80. package/src/commands/omargate.js +29 -29
  81. package/src/commands/persona.js +20 -20
  82. package/src/commands/plugin.js +260 -260
  83. package/src/commands/policy.js +132 -132
  84. package/src/commands/prompt.js +238 -238
  85. package/src/commands/review.js +704 -704
  86. package/src/commands/scan.js +872 -872
  87. package/src/commands/session.js +590 -0
  88. package/src/commands/spec.js +778 -716
  89. package/src/commands/swarm.js +651 -651
  90. package/src/commands/telemetry.js +202 -202
  91. package/src/commands/watch.js +511 -511
  92. package/src/config/agent-dictionary.js +182 -182
  93. package/src/config/io.js +56 -56
  94. package/src/config/paths.js +18 -18
  95. package/src/config/schema.js +55 -55
  96. package/src/config/service.js +184 -184
  97. package/src/cost/budget.js +235 -235
  98. package/src/cost/history.js +188 -188
  99. package/src/cost/tracker.js +171 -171
  100. package/src/daemon/artifact-lineage.js +534 -534
  101. package/src/daemon/assignment-ledger.js +966 -770
  102. package/src/daemon/ast-parser-layer.js +258 -258
  103. package/src/daemon/budget-governor.js +633 -633
  104. package/src/daemon/callgraph-overlay.js +646 -646
  105. package/src/daemon/error-worker.js +1209 -626
  106. package/src/daemon/fix-cycle.js +384 -377
  107. package/src/daemon/hybrid-mapper.js +929 -929
  108. package/src/daemon/ingest-refresh.js +10 -9
  109. package/src/daemon/jira-lifecycle.js +767 -632
  110. package/src/daemon/operator-control.js +657 -657
  111. package/src/daemon/pulse.js +327 -327
  112. package/src/daemon/reliability-lane.js +471 -471
  113. package/src/daemon/scope-engine.js +1068 -0
  114. package/src/daemon/watchdog.js +971 -971
  115. package/src/events/schema.js +190 -0
  116. package/src/guide/generator.js +316 -316
  117. package/src/ingest/engine.js +918 -918
  118. package/src/interactive/index.js +97 -97
  119. package/src/legacy-cli.js +3161 -2994
  120. package/src/mcp/registry.js +695 -695
  121. package/src/memory/blackboard.js +301 -301
  122. package/src/memory/retrieval.js +581 -581
  123. package/src/plugin/manifest.js +553 -553
  124. package/src/policy/packs.js +144 -144
  125. package/src/prompt/generator.js +136 -118
  126. package/src/review/ai-review.js +679 -679
  127. package/src/review/local-review.js +1351 -1305
  128. package/src/review/omargate-interactive.js +68 -68
  129. package/src/review/omargate-orchestrator.js +404 -300
  130. package/src/review/persona-prompts.js +296 -296
  131. package/src/review/replay.js +235 -235
  132. package/src/review/report.js +664 -664
  133. package/src/review/scan-modes.js +48 -42
  134. package/src/review/spec-binding.js +487 -487
  135. package/src/scaffold/generator.js +67 -67
  136. package/src/scaffold/templates.js +150 -150
  137. package/src/scan/generator.js +418 -418
  138. package/src/scan/gh-secrets.js +107 -107
  139. package/src/session/agent-registry.js +352 -0
  140. package/src/session/daemon.js +801 -0
  141. package/src/session/paths.js +33 -0
  142. package/src/session/runtime-bridge.js +739 -0
  143. package/src/session/store.js +388 -0
  144. package/src/session/stream.js +325 -0
  145. package/src/spec/generator.js +619 -519
  146. package/src/spec/regenerate.js +237 -237
  147. package/src/spec/templates.js +91 -91
  148. package/src/swarm/dashboard.js +247 -247
  149. package/src/swarm/factory.js +363 -363
  150. package/src/swarm/pentest.js +934 -934
  151. package/src/swarm/registry.js +419 -419
  152. package/src/swarm/report.js +158 -158
  153. package/src/swarm/runtime.js +576 -576
  154. package/src/swarm/scenario-dsl.js +272 -272
  155. package/src/telemetry/ledger.js +302 -302
  156. package/src/telemetry/session-tracker.js +234 -234
  157. package/src/telemetry/sync.js +203 -203
  158. package/src/ui/command-hints.js +13 -13
  159. package/src/ui/markdown.js +220 -220
package/src/ai/proxy.js CHANGED
@@ -1,137 +1,137 @@
1
- /**
2
- * SentinelLayer LLM proxy provider.
3
- *
4
- * Routes LLM calls through POST /api/v1/proxy/llm using the stored
5
- * sentinelayer_token. Users never need their own OpenAI/Anthropic key.
6
- *
7
- * Request: { model, system_prompt, user_content, max_tokens, temperature }
8
- * Response: { content, usage: { model, provider, tokens_in, tokens_out, cost_usd, latency_ms } }
9
- */
10
-
11
- import { resolveActiveAuthSession } from "../auth/service.js";
12
- import { authLoginHint } from "../ui/command-hints.js";
13
-
14
- const DEFAULT_PROXY_MODEL = "gpt-5.3-codex";
15
- const PROXY_TIMEOUT_MS = 120_000;
16
- const PROXY_MAX_RETRIES = 2;
17
- const PROXY_RETRY_STATUSES = new Set([429, 502, 503, 504]);
18
-
19
- /**
20
- * Invoke LLM via SentinelLayer proxy.
21
- *
22
- * @param {object} options
23
- * @param {string} options.prompt - The user content / prompt text
24
- * @param {string} [options.systemPrompt] - System prompt
25
- * @param {string} [options.model] - Model ID (default: gpt-5.3-codex)
26
- * @param {number} [options.maxTokens] - Max output tokens (default: 4096)
27
- * @param {number} [options.temperature] - Temperature (default: 0.1)
28
- * @param {string} [options.apiUrl] - Override API URL
29
- * @param {string} [options.token] - Override Bearer token
30
- * @returns {Promise<{ text: string, usage: { inputTokens: number, outputTokens: number, costUsd: number, model: string, provider: string, latencyMs: number } }>}
31
- */
32
- export async function invokeViaProxy({
33
- prompt,
34
- systemPrompt = "",
35
- model = DEFAULT_PROXY_MODEL,
36
- maxTokens = 4096,
37
- temperature = 0.1,
38
- apiUrl = "",
39
- token = "",
40
- } = {}) {
41
- // Resolve credentials from session if not provided
42
- let resolvedApiUrl = String(apiUrl || "").trim();
43
- let resolvedToken = String(token || "").trim();
44
-
45
- if (!resolvedApiUrl || !resolvedToken) {
46
- const session = await resolveActiveAuthSession({
47
- cwd: process.cwd(),
48
- env: process.env,
49
- autoRotate: false,
50
- });
51
- if (!session || !session.token) {
52
- throw new Error(
53
- `SentinelLayer LLM proxy requires authentication. Run '${authLoginHint()}' first.`
54
- );
55
- }
56
- if (!resolvedApiUrl) resolvedApiUrl = String(session.apiUrl || "https://api.sentinelayer.com").trim();
57
- if (!resolvedToken) resolvedToken = String(session.token).trim();
58
- }
59
-
60
- const url = `${resolvedApiUrl.replace(/\/+$/, "")}/api/v1/proxy/llm`;
61
-
62
- const body = JSON.stringify({
63
- model,
64
- system_prompt: systemPrompt || "You are a code reviewer.",
65
- user_content: String(prompt || ""),
66
- max_tokens: maxTokens,
67
- temperature,
68
- });
69
-
70
- let response = null;
71
- let lastError = null;
72
-
73
- for (let attempt = 0; attempt <= PROXY_MAX_RETRIES; attempt++) {
74
- try {
75
- const controller = new AbortController();
76
- const timeoutHandle = setTimeout(() => controller.abort(), PROXY_TIMEOUT_MS);
77
- try {
78
- response = await fetch(url, {
79
- method: "POST",
80
- headers: {
81
- "Content-Type": "application/json",
82
- Authorization: `Bearer ${resolvedToken}`,
83
- Accept: "application/json",
84
- },
85
- body,
86
- signal: controller.signal,
87
- });
88
- } finally {
89
- clearTimeout(timeoutHandle);
90
- }
91
-
92
- if (PROXY_RETRY_STATUSES.has(response.status) && attempt < PROXY_MAX_RETRIES) {
93
- const retryAfter = response.headers.get("Retry-After");
94
- const delay = retryAfter && !isNaN(retryAfter) ? Math.min(Number(retryAfter), 5) * 1000 : 500 * (attempt + 1);
95
- await new Promise((r) => setTimeout(r, delay));
96
- continue;
97
- }
98
-
99
- break;
100
- } catch (err) {
101
- lastError = err;
102
- if (attempt >= PROXY_MAX_RETRIES) break;
103
- await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
104
- }
105
- }
106
-
107
- if (!response) {
108
- throw new Error(`SentinelLayer LLM proxy request failed: ${lastError?.message || "no response"}`);
109
- }
110
-
111
- if (!response.ok) {
112
- let detail = "";
113
- try {
114
- const errBody = await response.json();
115
- detail = errBody?.error?.message || errBody?.detail || JSON.stringify(errBody).slice(0, 200);
116
- } catch {
117
- detail = await response.text().catch(() => "");
118
- }
119
- throw new Error(`SentinelLayer LLM proxy error (${response.status}): ${detail}`);
120
- }
121
-
122
- const result = await response.json();
123
-
124
- return {
125
- text: String(result.content || ""),
126
- usage: {
127
- inputTokens: result.usage?.tokens_in || 0,
128
- outputTokens: result.usage?.tokens_out || 0,
129
- costUsd: result.usage?.cost_usd || 0,
130
- model: result.usage?.model || model,
131
- provider: result.usage?.provider || "sentinelayer",
132
- latencyMs: result.usage?.latency_ms || 0,
133
- },
134
- };
135
- }
136
-
137
- export { DEFAULT_PROXY_MODEL };
1
+ /**
2
+ * SentinelLayer LLM proxy provider.
3
+ *
4
+ * Routes LLM calls through POST /api/v1/proxy/llm using the stored
5
+ * sentinelayer_token. Users never need their own OpenAI/Anthropic key.
6
+ *
7
+ * Request: { model, system_prompt, user_content, max_tokens, temperature }
8
+ * Response: { content, usage: { model, provider, tokens_in, tokens_out, cost_usd, latency_ms } }
9
+ */
10
+
11
+ import { resolveActiveAuthSession } from "../auth/service.js";
12
+ import { authLoginHint } from "../ui/command-hints.js";
13
+
14
+ const DEFAULT_PROXY_MODEL = "gpt-5.3-codex";
15
+ const PROXY_TIMEOUT_MS = 120_000;
16
+ const PROXY_MAX_RETRIES = 2;
17
+ const PROXY_RETRY_STATUSES = new Set([429, 502, 503, 504]);
18
+
19
+ /**
20
+ * Invoke LLM via SentinelLayer proxy.
21
+ *
22
+ * @param {object} options
23
+ * @param {string} options.prompt - The user content / prompt text
24
+ * @param {string} [options.systemPrompt] - System prompt
25
+ * @param {string} [options.model] - Model ID (default: gpt-5.3-codex)
26
+ * @param {number} [options.maxTokens] - Max output tokens (default: 4096)
27
+ * @param {number} [options.temperature] - Temperature (default: 0.1)
28
+ * @param {string} [options.apiUrl] - Override API URL
29
+ * @param {string} [options.token] - Override Bearer token
30
+ * @returns {Promise<{ text: string, usage: { inputTokens: number, outputTokens: number, costUsd: number, model: string, provider: string, latencyMs: number } }>}
31
+ */
32
+ export async function invokeViaProxy({
33
+ prompt,
34
+ systemPrompt = "",
35
+ model = DEFAULT_PROXY_MODEL,
36
+ maxTokens = 4096,
37
+ temperature = 0.1,
38
+ apiUrl = "",
39
+ token = "",
40
+ } = {}) {
41
+ // Resolve credentials from session if not provided
42
+ let resolvedApiUrl = String(apiUrl || "").trim();
43
+ let resolvedToken = String(token || "").trim();
44
+
45
+ if (!resolvedApiUrl || !resolvedToken) {
46
+ const session = await resolveActiveAuthSession({
47
+ cwd: process.cwd(),
48
+ env: process.env,
49
+ autoRotate: false,
50
+ });
51
+ if (!session || !session.token) {
52
+ throw new Error(
53
+ `SentinelLayer LLM proxy requires authentication. Run '${authLoginHint()}' first.`
54
+ );
55
+ }
56
+ if (!resolvedApiUrl) resolvedApiUrl = String(session.apiUrl || "https://api.sentinelayer.com").trim();
57
+ if (!resolvedToken) resolvedToken = String(session.token).trim();
58
+ }
59
+
60
+ const url = `${resolvedApiUrl.replace(/\/+$/, "")}/api/v1/proxy/llm`;
61
+
62
+ const body = JSON.stringify({
63
+ model,
64
+ system_prompt: systemPrompt || "You are a code reviewer.",
65
+ user_content: String(prompt || ""),
66
+ max_tokens: maxTokens,
67
+ temperature,
68
+ });
69
+
70
+ let response = null;
71
+ let lastError = null;
72
+
73
+ for (let attempt = 0; attempt <= PROXY_MAX_RETRIES; attempt++) {
74
+ try {
75
+ const controller = new AbortController();
76
+ const timeoutHandle = setTimeout(() => controller.abort(), PROXY_TIMEOUT_MS);
77
+ try {
78
+ response = await fetch(url, {
79
+ method: "POST",
80
+ headers: {
81
+ "Content-Type": "application/json",
82
+ Authorization: `Bearer ${resolvedToken}`,
83
+ Accept: "application/json",
84
+ },
85
+ body,
86
+ signal: controller.signal,
87
+ });
88
+ } finally {
89
+ clearTimeout(timeoutHandle);
90
+ }
91
+
92
+ if (PROXY_RETRY_STATUSES.has(response.status) && attempt < PROXY_MAX_RETRIES) {
93
+ const retryAfter = response.headers.get("Retry-After");
94
+ const delay = retryAfter && !isNaN(retryAfter) ? Math.min(Number(retryAfter), 5) * 1000 : 500 * (attempt + 1);
95
+ await new Promise((r) => setTimeout(r, delay));
96
+ continue;
97
+ }
98
+
99
+ break;
100
+ } catch (err) {
101
+ lastError = err;
102
+ if (attempt >= PROXY_MAX_RETRIES) break;
103
+ await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
104
+ }
105
+ }
106
+
107
+ if (!response) {
108
+ throw new Error(`SentinelLayer LLM proxy request failed: ${lastError?.message || "no response"}`);
109
+ }
110
+
111
+ if (!response.ok) {
112
+ let detail = "";
113
+ try {
114
+ const errBody = await response.json();
115
+ detail = errBody?.error?.message || errBody?.detail || JSON.stringify(errBody).slice(0, 200);
116
+ } catch {
117
+ detail = await response.text().catch(() => "");
118
+ }
119
+ throw new Error(`SentinelLayer LLM proxy error (${response.status}): ${detail}`);
120
+ }
121
+
122
+ const result = await response.json();
123
+
124
+ return {
125
+ text: String(result.content || ""),
126
+ usage: {
127
+ inputTokens: result.usage?.tokens_in || 0,
128
+ outputTokens: result.usage?.tokens_out || 0,
129
+ costUsd: result.usage?.cost_usd || 0,
130
+ model: result.usage?.model || model,
131
+ provider: result.usage?.provider || "sentinelayer",
132
+ latencyMs: result.usage?.latency_ms || 0,
133
+ },
134
+ };
135
+ }
136
+
137
+ export { DEFAULT_PROXY_MODEL };
@@ -1,145 +1,145 @@
1
- import fsp from "node:fs/promises";
2
- import path from "node:path";
3
-
4
- const REGISTRY_SCHEMA_VERSION = "1.0.0";
5
-
6
- function normalizeString(value) {
7
- return String(value || "").trim();
8
- }
9
-
10
- function normalizeSiteRecord(record = {}) {
11
- return {
12
- siteId: normalizeString(record.siteId),
13
- projectId: normalizeString(record.projectId) || null,
14
- identityId: normalizeString(record.identityId) || null,
15
- domainId: normalizeString(record.domainId) || null,
16
- host: normalizeString(record.host) || null,
17
- callbackPath: normalizeString(record.callbackPath) || null,
18
- callbackUrl: normalizeString(record.callbackUrl) || null,
19
- status: normalizeString(record.status) || "UNKNOWN",
20
- dnsCleanupStatus: normalizeString(record.dnsCleanupStatus) || "UNKNOWN",
21
- expiresAt: normalizeString(record.expiresAt) || null,
22
- teardownReason: normalizeString(record.teardownReason) || null,
23
- teardownAt: normalizeString(record.teardownAt) || null,
24
- createdAt: normalizeString(record.createdAt) || new Date().toISOString(),
25
- lastUpdatedAt: normalizeString(record.lastUpdatedAt) || new Date().toISOString(),
26
- dnsCleanupContract:
27
- record.dnsCleanupContract && typeof record.dnsCleanupContract === "object"
28
- ? record.dnsCleanupContract
29
- : {},
30
- metadata: record.metadata && typeof record.metadata === "object" ? record.metadata : {},
31
- };
32
- }
33
-
34
- export function resolveSiteRegistryPath({ outputRoot } = {}) {
35
- const resolvedOutputRoot = path.resolve(String(outputRoot || "."));
36
- return path.join(resolvedOutputRoot, "aidenid", "site-registry.json");
37
- }
38
-
39
- async function loadRegistryInternal(filePath) {
40
- try {
41
- const raw = await fsp.readFile(filePath, "utf-8");
42
- const parsed = JSON.parse(raw);
43
- const sites = Array.isArray(parsed.sites)
44
- ? parsed.sites.map((item) => normalizeSiteRecord(item)).filter((item) => item.siteId)
45
- : [];
46
- return {
47
- schemaVersion: normalizeString(parsed.schemaVersion) || REGISTRY_SCHEMA_VERSION,
48
- generatedAt: normalizeString(parsed.generatedAt) || new Date().toISOString(),
49
- sites,
50
- };
51
- } catch (error) {
52
- if (error && typeof error === "object" && error.code === "ENOENT") {
53
- return {
54
- schemaVersion: REGISTRY_SCHEMA_VERSION,
55
- generatedAt: new Date().toISOString(),
56
- sites: [],
57
- };
58
- }
59
- throw error;
60
- }
61
- }
62
-
63
- async function writeRegistryInternal(filePath, registry = {}) {
64
- const normalized = {
65
- schemaVersion: REGISTRY_SCHEMA_VERSION,
66
- generatedAt: new Date().toISOString(),
67
- sites: Array.isArray(registry.sites) ? registry.sites.map(normalizeSiteRecord) : [],
68
- };
69
- await fsp.mkdir(path.dirname(filePath), { recursive: true });
70
- await fsp.writeFile(filePath, `${JSON.stringify(normalized, null, 2)}\n`, "utf-8");
71
- return normalized;
72
- }
73
-
74
- export async function listSites({ outputRoot, identityId = "" } = {}) {
75
- const registryPath = resolveSiteRegistryPath({ outputRoot });
76
- const registry = await loadRegistryInternal(registryPath);
77
- const normalizedIdentityId = normalizeString(identityId);
78
- const filteredSites = normalizedIdentityId
79
- ? registry.sites.filter((item) => item.identityId === normalizedIdentityId)
80
- : registry.sites;
81
- return {
82
- registryPath,
83
- sites: filteredSites,
84
- };
85
- }
86
-
87
- export async function recordTemporarySite({
88
- outputRoot,
89
- site = {},
90
- context = {},
91
- } = {}) {
92
- const siteId = normalizeString(site.id || context.siteId);
93
- if (!siteId) {
94
- throw new Error("Cannot record temporary site without site.id.");
95
- }
96
-
97
- const registryPath = resolveSiteRegistryPath({ outputRoot });
98
- const registry = await loadRegistryInternal(registryPath);
99
- const nowIso = new Date().toISOString();
100
- const nextRecord = normalizeSiteRecord({
101
- siteId,
102
- projectId: site.projectId || context.projectId,
103
- identityId: site.identityId || context.identityId,
104
- domainId: site.domainId || context.domainId,
105
- host: site.host,
106
- callbackPath: site.callbackPath,
107
- callbackUrl: site.callbackUrl,
108
- status: site.status,
109
- dnsCleanupStatus: site.dnsCleanupStatus,
110
- expiresAt: site.expiresAt,
111
- teardownReason: site.teardownReason,
112
- teardownAt: site.teardownAt,
113
- createdAt: nowIso,
114
- lastUpdatedAt: nowIso,
115
- dnsCleanupContract: site.dnsCleanupContract,
116
- metadata: {
117
- ...(site.metadata && typeof site.metadata === "object" ? site.metadata : {}),
118
- source: normalizeString(context.source) || "site-create",
119
- idempotencyKey: context.idempotencyKey || null,
120
- },
121
- });
122
-
123
- const index = registry.sites.findIndex((item) => item.siteId === siteId);
124
- if (index >= 0) {
125
- const existing = registry.sites[index];
126
- registry.sites[index] = normalizeSiteRecord({
127
- ...existing,
128
- ...nextRecord,
129
- createdAt: existing.createdAt || nextRecord.createdAt,
130
- metadata: {
131
- ...existing.metadata,
132
- ...nextRecord.metadata,
133
- },
134
- });
135
- } else {
136
- registry.sites.push(nextRecord);
137
- }
138
-
139
- const saved = await writeRegistryInternal(registryPath, registry);
140
- const savedSite = saved.sites.find((item) => item.siteId === siteId) || null;
141
- return {
142
- registryPath,
143
- site: savedSite,
144
- };
145
- }
1
+ import fsp from "node:fs/promises";
2
+ import path from "node:path";
3
+
4
+ const REGISTRY_SCHEMA_VERSION = "1.0.0";
5
+
6
+ function normalizeString(value) {
7
+ return String(value || "").trim();
8
+ }
9
+
10
+ function normalizeSiteRecord(record = {}) {
11
+ return {
12
+ siteId: normalizeString(record.siteId),
13
+ projectId: normalizeString(record.projectId) || null,
14
+ identityId: normalizeString(record.identityId) || null,
15
+ domainId: normalizeString(record.domainId) || null,
16
+ host: normalizeString(record.host) || null,
17
+ callbackPath: normalizeString(record.callbackPath) || null,
18
+ callbackUrl: normalizeString(record.callbackUrl) || null,
19
+ status: normalizeString(record.status) || "UNKNOWN",
20
+ dnsCleanupStatus: normalizeString(record.dnsCleanupStatus) || "UNKNOWN",
21
+ expiresAt: normalizeString(record.expiresAt) || null,
22
+ teardownReason: normalizeString(record.teardownReason) || null,
23
+ teardownAt: normalizeString(record.teardownAt) || null,
24
+ createdAt: normalizeString(record.createdAt) || new Date().toISOString(),
25
+ lastUpdatedAt: normalizeString(record.lastUpdatedAt) || new Date().toISOString(),
26
+ dnsCleanupContract:
27
+ record.dnsCleanupContract && typeof record.dnsCleanupContract === "object"
28
+ ? record.dnsCleanupContract
29
+ : {},
30
+ metadata: record.metadata && typeof record.metadata === "object" ? record.metadata : {},
31
+ };
32
+ }
33
+
34
+ export function resolveSiteRegistryPath({ outputRoot } = {}) {
35
+ const resolvedOutputRoot = path.resolve(String(outputRoot || "."));
36
+ return path.join(resolvedOutputRoot, "aidenid", "site-registry.json");
37
+ }
38
+
39
+ async function loadRegistryInternal(filePath) {
40
+ try {
41
+ const raw = await fsp.readFile(filePath, "utf-8");
42
+ const parsed = JSON.parse(raw);
43
+ const sites = Array.isArray(parsed.sites)
44
+ ? parsed.sites.map((item) => normalizeSiteRecord(item)).filter((item) => item.siteId)
45
+ : [];
46
+ return {
47
+ schemaVersion: normalizeString(parsed.schemaVersion) || REGISTRY_SCHEMA_VERSION,
48
+ generatedAt: normalizeString(parsed.generatedAt) || new Date().toISOString(),
49
+ sites,
50
+ };
51
+ } catch (error) {
52
+ if (error && typeof error === "object" && error.code === "ENOENT") {
53
+ return {
54
+ schemaVersion: REGISTRY_SCHEMA_VERSION,
55
+ generatedAt: new Date().toISOString(),
56
+ sites: [],
57
+ };
58
+ }
59
+ throw error;
60
+ }
61
+ }
62
+
63
+ async function writeRegistryInternal(filePath, registry = {}) {
64
+ const normalized = {
65
+ schemaVersion: REGISTRY_SCHEMA_VERSION,
66
+ generatedAt: new Date().toISOString(),
67
+ sites: Array.isArray(registry.sites) ? registry.sites.map(normalizeSiteRecord) : [],
68
+ };
69
+ await fsp.mkdir(path.dirname(filePath), { recursive: true });
70
+ await fsp.writeFile(filePath, `${JSON.stringify(normalized, null, 2)}\n`, "utf-8");
71
+ return normalized;
72
+ }
73
+
74
+ export async function listSites({ outputRoot, identityId = "" } = {}) {
75
+ const registryPath = resolveSiteRegistryPath({ outputRoot });
76
+ const registry = await loadRegistryInternal(registryPath);
77
+ const normalizedIdentityId = normalizeString(identityId);
78
+ const filteredSites = normalizedIdentityId
79
+ ? registry.sites.filter((item) => item.identityId === normalizedIdentityId)
80
+ : registry.sites;
81
+ return {
82
+ registryPath,
83
+ sites: filteredSites,
84
+ };
85
+ }
86
+
87
+ export async function recordTemporarySite({
88
+ outputRoot,
89
+ site = {},
90
+ context = {},
91
+ } = {}) {
92
+ const siteId = normalizeString(site.id || context.siteId);
93
+ if (!siteId) {
94
+ throw new Error("Cannot record temporary site without site.id.");
95
+ }
96
+
97
+ const registryPath = resolveSiteRegistryPath({ outputRoot });
98
+ const registry = await loadRegistryInternal(registryPath);
99
+ const nowIso = new Date().toISOString();
100
+ const nextRecord = normalizeSiteRecord({
101
+ siteId,
102
+ projectId: site.projectId || context.projectId,
103
+ identityId: site.identityId || context.identityId,
104
+ domainId: site.domainId || context.domainId,
105
+ host: site.host,
106
+ callbackPath: site.callbackPath,
107
+ callbackUrl: site.callbackUrl,
108
+ status: site.status,
109
+ dnsCleanupStatus: site.dnsCleanupStatus,
110
+ expiresAt: site.expiresAt,
111
+ teardownReason: site.teardownReason,
112
+ teardownAt: site.teardownAt,
113
+ createdAt: nowIso,
114
+ lastUpdatedAt: nowIso,
115
+ dnsCleanupContract: site.dnsCleanupContract,
116
+ metadata: {
117
+ ...(site.metadata && typeof site.metadata === "object" ? site.metadata : {}),
118
+ source: normalizeString(context.source) || "site-create",
119
+ idempotencyKey: context.idempotencyKey || null,
120
+ },
121
+ });
122
+
123
+ const index = registry.sites.findIndex((item) => item.siteId === siteId);
124
+ if (index >= 0) {
125
+ const existing = registry.sites[index];
126
+ registry.sites[index] = normalizeSiteRecord({
127
+ ...existing,
128
+ ...nextRecord,
129
+ createdAt: existing.createdAt || nextRecord.createdAt,
130
+ metadata: {
131
+ ...existing.metadata,
132
+ ...nextRecord.metadata,
133
+ },
134
+ });
135
+ } else {
136
+ registry.sites.push(nextRecord);
137
+ }
138
+
139
+ const saved = await writeRegistryInternal(registryPath, registry);
140
+ const savedSite = saved.sites.find((item) => item.siteId === siteId) || null;
141
+ return {
142
+ registryPath,
143
+ site: savedSite,
144
+ };
145
+ }