fluncle 0.232.0 → 0.233.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.232.0".trim() ? "0.232.0".trim() : "0.1.0";
+  currentVersion = "0.233.0".trim() ? "0.233.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2335,7 +2335,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.232.0".trim() ? "0.232.0".trim() : "0.1.0";
+  currentVersion2 = "0.233.0".trim() ? "0.233.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -11974,6 +11974,78 @@ var init_admin_projections = __esm(() => {
   };
 });
 
+// ../../packages/contracts/src/orpc/admin-vectors.ts
+var VectorServingReasonSchema, ReadinessSchema, VectorServingStatusSchema, VectorServingResponseSchema, getVectorServing, setVectorServing, adminVectorsContract;
+var init_admin_vectors = __esm(() => {
+  init_dist3();
+  init_zod();
+  VectorServingReasonSchema = _enum([
+    "artifact_contract_mismatch",
+    "checkpoint_mismatch",
+    "consumer_contract_mismatch",
+    "consumer_not_active",
+    "consumer_rebuild_incomplete",
+    "consumer_unavailable",
+    "delta_stale",
+    "empty_index",
+    "pending_ack",
+    "producer_backlog",
+    "replica_stale",
+    "sonar_not_ok",
+    "sonar_unavailable",
+    "build_identity_missing",
+    "validation_failed"
+  ]);
+  ReadinessSchema = object({
+    ready: boolean2(),
+    reasons: array(VectorServingReasonSchema)
+  });
+  VectorServingStatusSchema = object({
+    commissioning: ReadinessSchema,
+    enabled: boolean2(),
+    evidence: object({
+      artifactVersion: string2().nullable(),
+      checkpoint: number2().int().nonnegative().nullable(),
+      checkpointedAt: string2().nullable(),
+      commit: string2().nullable(),
+      consumerAppliedThroughSeq: number2().int().nonnegative().nullable(),
+      consumerHeadSeq: number2().int().nonnegative().nullable(),
+      consumerId: string2().nullable(),
+      consumerState: _enum(["active", "inactive", "rebuilding"]).nullable(),
+      deltaAgeSeconds: number2().int().nonnegative().nullable(),
+      deltaBacklog: number2().int().nonnegative().nullable(),
+      pendingAck: boolean2().nullable(),
+      replicaLagSeconds: number2().int().nullable(),
+      tracks: number2().int().nonnegative().nullable(),
+      validation: _enum(["last_attempt_failed", "valid"]).nullable()
+    }),
+    runtime: ReadinessSchema,
+    target: literal("tracks")
+  });
+  VectorServingResponseSchema = object({
+    ok: literal(true),
+    status: VectorServingStatusSchema
+  });
+  getVectorServing = oc.route({
+    method: "GET",
+    operationId: "getVectorServing",
+    path: "/admin/vectors/tracks/serving",
+    summary: "Read track vector-serving readiness",
+    tags: ["Admin"]
+  }).output(VectorServingResponseSchema);
+  setVectorServing = oc.route({
+    method: "PUT",
+    operationId: "setVectorServing",
+    path: "/admin/vectors/tracks/serving",
+    summary: "Enable or disable track vector serving",
+    tags: ["Admin"]
+  }).input(object({ enabled: boolean2() })).output(VectorServingResponseSchema);
+  adminVectorsContract = {
+    get_vector_serving: getVectorServing,
+    set_vector_serving: setVectorServing
+  };
+});
+
 // ../../packages/contracts/src/orpc/admin-reach.ts
 var CollectedPlatformSchema, SkippedPlatformSchema, FailedPlatformSchema, recordPlatformStats, adminReachContract;
 var init_admin_reach = __esm(() => {
@@ -15768,6 +15840,7 @@ var init_orpc = __esm(() => {
   init_admin_galaxies();
   init_admin_prompts();
   init_admin_projections();
+  init_admin_vectors();
   init_admin_reach();
   init_albums2();
   init_artists2();
@@ -15827,6 +15900,7 @@ var init_orpc = __esm(() => {
   init_admin_artifacts();
   init_admin_operation_receipts();
   init_admin_projections();
+  init_admin_vectors();
   init_admin_artist_rules();
   init_admin_artists();
   init_admin_attention2();
@@ -15892,6 +15966,7 @@ var init_orpc = __esm(() => {
     ...adminGalaxiesContract,
     ...adminPromptsContract,
     ...adminProjectionsContract,
+    ...adminVectorsContract,
     ...adminReachContract,
     ...albumsContract,
     ...artistsContract,
@@ -16085,6 +16160,39 @@ var init_admin_projections2 = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-vectors.ts
+async function getVectorServingCommand(target) {
+  return adminApiGet(`/api/v1/admin/vectors/${target}/serving`);
+}
+async function setVectorServingCommand(input) {
+  return adminApiPut(`/api/v1/admin/vectors/${input.target}/serving`, {
+    enabled: input.enabled
+  });
+}
+function parseVectorTarget(value) {
+  if (value !== "tracks") {
+    throw new Error("target must be tracks");
+  }
+  return value;
+}
+function parseVectorEnabled(value) {
+  if (value !== "true" && value !== "false") {
+    throw new Error("--enabled must be true or false");
+  }
+  return value === "true";
+}
+function vectorServingStatusLines(status) {
+  const reasons = (label, values) => values.length === 0 ? `${label}: ready.` : `${label}: ${values.join(", ")}.`;
+  return [
+    `tracks: ${status.enabled ? "enabled" : "disabled"}.`,
+    reasons("commissioning", status.commissioning.reasons),
+    reasons("runtime", status.runtime.reasons)
+  ];
+}
+var init_admin_vectors2 = __esm(() => {
+  init_api();
+});
+
 // src/commands/admin-artifacts.ts
 function consumerPath(consumerId) {
   return `/api/v1/admin/artifacts/consumers/${encodeURIComponent(consumerId)}`;
@@ -20870,6 +20978,33 @@ JSON field reference:
     }
     console.log(`${result.target}: cutover ${result.enabled ? "open" : "dark"}.`);
   });
+  const adminVectors = configureCommand(admin.command("vectors").description("Vector-serving readiness and rollback controls"));
+  adminVectors.action(() => {
+    adminVectors.outputHelp();
+  });
+  adminVectors.command("get").description("Read vector-serving commissioning and runtime readiness").argument("<target>", "tracks").option("--json", "Print the complete machine-readable readiness contract", false).action(async (targetValue, options) => {
+    const vectors = await Promise.resolve().then(() => (init_admin_vectors2(), {}));
+    const result = await getVectorServingCommand(parseVectorTarget(targetValue));
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    console.log(vectorServingStatusLines(result.status).join(`
+`));
+  });
+  adminVectors.command("set").description("Enable a commissioned vector target or disable it unconditionally").argument("<target>", "tracks").requiredOption("--enabled <boolean>", "true enables; false disables unconditionally").option("--json", "Print the stored flag and current readiness as JSON", false).action(async (targetValue, options) => {
+    const vectors = await Promise.resolve().then(() => (init_admin_vectors2(), {}));
+    const result = await setVectorServingCommand({
+      enabled: parseVectorEnabled(options.enabled),
+      target: parseVectorTarget(targetValue)
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    console.log(vectorServingStatusLines(result.status).join(`
+`));
+  });
   const adminArtifacts = configureCommand(admin.command("artifacts").description("Versioned derived-artifact change log"));
   adminArtifacts.action(() => {
     adminArtifacts.outputHelp();

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.232.0"
+  "version": "0.233.0"
 }