@app-vitals/agent-admin 0.2.1 → 0.3.0

package/src/transcript-config.ts

@@ -0,0 +1,19 @@
+/**
+ * admin/src/transcript-config.ts
+ *
+ * Pure parser for the cron-run transcript API flag (COS-43.1). Takes an
+ * injected env object (no process.env reads) so it is deterministically
+ * unit-testable; admin-boot reads it once at startup and injects the result.
+ * Same "enabled" convention as agent-ask-config.ts.
+ */
+
+type TranscriptEnv = Readonly<Record<string, string | undefined>>;
+
+export interface TranscriptConfig {
+  /** True only when SHIPWRIGHT_TRANSCRIPT_API_ENABLED === "enabled". */
+  enabled: boolean;
+}
+
+export function parseTranscriptConfig(env: TranscriptEnv): TranscriptConfig {
+  return { enabled: env.SHIPWRIGHT_TRANSCRIPT_API_ENABLED === "enabled" };
+}

package/src/transcript-config.unit.test.ts

@@ -0,0 +1,32 @@
+/**
+ * admin/src/transcript-config.unit.test.ts
+ * Pure flag parser for the cron-run transcript API (COS-43.1).
+ */
+
+import { describe, expect, it } from "bun:test";
+import { parseTranscriptConfig } from "./transcript-config.ts";
+
+describe("parseTranscriptConfig", () => {
+  it('is on only for the literal "enabled"', () => {
+    expect(
+      parseTranscriptConfig({ SHIPWRIGHT_TRANSCRIPT_API_ENABLED: "enabled" })
+        .enabled,
+    ).toBe(true);
+  });
+
+  it("every other value is off", () => {
+    for (const v of [
+      "true",
+      "",
+      "Enabled",
+      " enabled",
+      "disabled",
+      undefined,
+    ]) {
+      expect(
+        parseTranscriptConfig({ SHIPWRIGHT_TRANSCRIPT_API_ENABLED: v }).enabled,
+      ).toBe(false);
+    }
+    expect(parseTranscriptConfig({}).enabled).toBe(false);
+  });
+});