@malloy-publisher/server 0.0.206 → 0.0.207

package/dist/server.mjs

@@ -230438,7 +230438,7 @@ class StorageManager {
 }
 
 // src/service/environment.ts
-var import_api6 = __toESM(require_src(), 1);
+var import_api7 = __toESM(require_src(), 1);
 import { MalloyError as MalloyError4, Runtime as Runtime2 } from "@malloydata/malloy";
 init_constants();
 init_errors();
@@ -230448,6 +230448,62 @@ import * as fs7 from "fs";
 import * as path8 from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 
+// src/materialization_metrics.ts
+var import_api4 = __toESM(require_src(), 1);
+var roundCounter = null;
+var roundDuration = null;
+var manifestBindCounter = null;
+var sourceBuildDuration = null;
+var dropTablesCounter = null;
+function ensureTelemetry() {
+  if (roundCounter && roundDuration) {
+    return { counter: roundCounter, duration: roundDuration };
+  }
+  const meter2 = import_api4.metrics.getMeter("publisher");
+  if (!roundCounter) {
+    roundCounter = meter2.createCounter("publisher_materialization_rounds_total", {
+      description: "Materialization rounds completed. Labels: round ('round1'|'round2'|'auto'), outcome ('success'|'failed'|'cancelled')."
+    });
+  }
+  if (!roundDuration) {
+    roundDuration = meter2.createHistogram("publisher_materialization_round_duration_ms", {
+      description: "Wall-clock duration of a materialization round. Label: round ('round1'|'round2'|'auto').",
+      unit: "ms"
+    });
+  }
+  return { counter: roundCounter, duration: roundDuration };
+}
+function recordMaterializationRound(round, outcome, durationMs) {
+  const { counter, duration } = ensureTelemetry();
+  counter.add(1, { round, outcome });
+  duration.record(durationMs, { round });
+}
+function recordManifestBind(outcome) {
+  if (!manifestBindCounter) {
+    manifestBindCounter = import_api4.metrics.getMeter("publisher").createCounter("publisher_materialization_manifest_bind_total", {
+      description: "Manifest bind attempts. Label: outcome ('success'|'failure'|'timeout')."
+    });
+  }
+  manifestBindCounter.add(1, { outcome });
+}
+function recordSourceBuildDuration(durationMs) {
+  if (!sourceBuildDuration) {
+    sourceBuildDuration = import_api4.metrics.getMeter("publisher").createHistogram("publisher_materialization_source_build_duration_ms", {
+      description: "Wall-clock duration of building a single persist source.",
+      unit: "ms"
+    });
+  }
+  sourceBuildDuration.record(durationMs);
+}
+function recordDropTables(outcome) {
+  if (!dropTablesCounter) {
+    dropTablesCounter = import_api4.metrics.getMeter("publisher").createCounter("publisher_materialization_drop_tables_total", {
+      description: "Physical tables dropped on delete. Label: outcome ('success'|'failure')."
+    });
+  }
+  dropTablesCounter.add(1, { outcome });
+}
+
 // src/utils.ts
 import * as fs3 from "fs";
 import * as path5 from "path";
@@ -230530,7 +230586,7 @@ init_package_load_pool();
 init_constants();
 init_errors();
 init_logger();
-var import_api5 = __toESM(require_src(), 1);
+var import_api6 = __toESM(require_src(), 1);
 var import_recursive_readdir = __toESM(require_recursive_readdir(), 1);
 import * as fs6 from "fs/promises";
 import * as path7 from "path";
@@ -230546,7 +230602,7 @@ import {
 
 // src/service/model.ts
 init_package_load_pool();
-var import_api4 = __toESM(require_src(), 1);
+var import_api5 = __toESM(require_src(), 1);
 import {
   Annotations as Annotations2,
   API,
@@ -231084,7 +231140,7 @@ class Model {
   fileLevelAuthorize = [];
   discoveryCurationEnabled = false;
   queryBoundary = { mode: "all", exploresDeclared: false, isQueryEntryPoint: true };
-  meter = import_api4.metrics.getMeter("publisher");
+  meter = import_api5.metrics.getMeter("publisher");
   queryExecutionHistogram = this.meter.createHistogram("malloy_model_query_duration", {
     description: "How long it takes to execute a Malloy model query",
     unit: "ms"
@@ -231262,7 +231318,7 @@ class Model {
       return new Model(packageName, modelPath, dataStyles, modelType, undefined, undefined, undefined, undefined, undefined, undefined, computedError);
     }
   }
-  static fromSerialized(packageName, _packagePath, malloyConfig, data) {
+  static fromSerialized(packageName, _packagePath, malloyConfig, data, options) {
     const modelDef = data.modelDef;
     const modelInfo = data.modelInfo;
     const dataStyles = data.dataStyles ?? {};
@@ -231274,7 +231330,7 @@ class Model {
     if (!modelDef) {
       return new Model(packageName, data.modelPath, dataStyles, data.modelType, undefined, undefined, sources, queries, sourceInfos, data.modelType === "notebook" ? hydrateMarkdownOnlyCells(data.notebookCells) : undefined, undefined, filterMap, givens, modelInfo);
     }
-    const runtime = makeHydrationRuntime(malloyConfig);
+    const runtime = makeHydrationRuntime(malloyConfig, options?.buildManifest);
     const modelMaterializer = runtime._loadModelFromModelDef(modelDef);
     const runnableNotebookCells = data.modelType === "notebook" ? hydrateNotebookCells(runtime, data.notebookCells) : undefined;
     return new Model(packageName, data.modelPath, dataStyles, data.modelType, modelMaterializer, modelDef, sources, queries, sourceInfos, runnableNotebookCells, undefined, filterMap, givens, modelInfo);
@@ -231897,14 +231953,18 @@ run: ${sourceName ? sourceName + "->" : ""}${queryName}`;
     }
   }
 }
-function makeHydrationRuntime(malloyConfig) {
+function makeHydrationRuntime(malloyConfig, buildManifest) {
   const urlReader = new HackyDataStylesAccumulator(URL_READER);
   const config = malloyConfig instanceof MalloyConfig2 ? malloyConfig : (() => {
     const c = new MalloyConfig2({ connections: {} });
     c.wrapConnections(() => new FixedConnectionMap(malloyConfig, "duckdb"));
     return c;
   })();
-  return new Runtime({ urlReader, config });
+  return new Runtime({
+    urlReader,
+    config,
+    buildManifest: buildManifest ? { entries: buildManifest, strict: false } : undefined
+  });
 }
 function hydrateNotebookCells(runtime, notebookCells) {
   if (!notebookCells)
@@ -231949,8 +232009,6 @@ function hydrateMarkdownOnlyCells(notebookCells) {
 }
 
 // src/service/package.ts
-var ENABLE_LIST_MODEL_COMPILATION = true;
-
 class Package {
   environmentName;
   packageName;
@@ -231959,7 +232017,11 @@ class Package {
   models = new Map;
   packagePath;
   malloyConfig;
-  static meter = import_api5.metrics.getMeter("publisher");
+  buildManifestEntries;
+  manifestBindingStatus = "unbound";
+  manifestEntryCount = 0;
+  boundManifestUri = null;
+  static meter = import_api6.metrics.getMeter("publisher");
   static packageLoadHistogram = this.meter.createHistogram("malloy_package_load_duration", {
     description: "Time taken to load a Malloy package",
     unit: "ms"
@@ -232115,10 +232177,36 @@ class Package {
     return this.packageName;
   }
   getPackageMetadata() {
+    const metadata = {
+      ...this.packageMetadata,
+      name: this.packageName,
+      manifestBindingStatus: this.manifestBindingStatus,
+      manifestEntryCount: this.manifestEntryCount,
+      boundManifestUri: this.boundManifestUri
+    };
     const warnings = this.exploreWarnings();
-    if (warnings.length === 0)
-      return this.packageMetadata;
-    return { ...this.packageMetadata, exploresWarnings: warnings };
+    if (warnings.length > 0) {
+      metadata.exploresWarnings = warnings;
+    }
+    return metadata;
+  }
+  getBuildManifestEntries() {
+    return this.buildManifestEntries;
+  }
+  setBoundManifestUri(uri) {
+    this.boundManifestUri = uri;
+  }
+  markManifestBindFailed() {
+    this.manifestBindingStatus = "live_fallback";
+  }
+  recordManifestBinding(buildManifest) {
+    const count = Object.keys(buildManifest).length;
+    this.buildManifestEntries = count > 0 ? buildManifest : undefined;
+    this.manifestEntryCount = count;
+    this.manifestBindingStatus = count > 0 ? "bound" : "unbound";
+    if (count === 0) {
+      this.boundManifestUri = null;
+    }
   }
   getInvalidExplores(exploresOverride) {
     const declared = exploresOverride ?? this.packageMetadata.explores;
@@ -232223,7 +232311,7 @@ class Package {
         });
         nextModels.set(sm.modelPath, Model.fromCompilationError(this.packageName, sm.modelPath, sm.modelType, err));
       } else {
-        const model = Model.fromSerialized(this.packageName, this.packagePath, this.malloyConfig, sm);
+        const model = Model.fromSerialized(this.packageName, this.packagePath, this.malloyConfig, sm, { buildManifest });
         try {
           await model.validateRenderTags();
           nextModels.set(sm.modelPath, model);
@@ -232244,6 +232332,7 @@ class Package {
     this.packageMetadata.manifestLocation = outcome.packageMetadata.manifestLocation ?? null;
     this.applyDiscoveryPolicyToModels();
     this.applyQueryBoundaryToModels();
+    this.recordManifestBinding(buildManifest);
     const invalidMsg = this.formatInvalidExplores();
     if (invalidMsg) {
       logger.warn(`Package ${this.packageName} has invalid explores`, {
@@ -232268,12 +232357,10 @@ class Package {
       return exploreSet ? exploreSet.has(modelPath) : true;
     }).map(async (modelPath) => {
       let error;
-      if (ENABLE_LIST_MODEL_COMPILATION) {
-        try {
-          await this.models.get(modelPath)?.getModel();
-        } catch (modelError) {
-          error = modelError instanceof Error ? modelError.message : undefined;
-        }
+      try {
+        await this.models.get(modelPath)?.getModel();
+      } catch (modelError) {
+        error = modelError instanceof Error ? modelError.message : undefined;
       }
       return {
         environmentName: this.environmentName,
@@ -232288,10 +232375,7 @@ class Package {
     return await Promise.all(Array.from(this.models.keys()).filter((modelPath) => {
       return modelPath.endsWith(NOTEBOOK_FILE_SUFFIX);
     }).map(async (modelPath) => {
-      let error;
-      if (ENABLE_LIST_MODEL_COMPILATION) {
-        error = this.models.get(modelPath)?.getNotebookError();
-      }
+      const error = this.models.get(modelPath)?.getNotebookError();
       return {
         environmentName: this.environmentName,
         packageName: this.packageName,
@@ -232390,13 +232474,14 @@ class Package {
 // src/service/environment.ts
 var STAGING_DIR_NAME = ".staging";
 var RETIRED_DIR_NAME = ".retired";
+var MANIFEST_FETCH_TIMEOUT_MS = 15000;
 var RETIRED_CONNECTION_DRAIN_MS = 30000;
 var queryAdmissionRejectionsCounter = null;
 var packageAdmissionRejectionsCounter = null;
 function getQueryAdmissionRejectionsCounter() {
   if (queryAdmissionRejectionsCounter)
     return queryAdmissionRejectionsCounter;
-  queryAdmissionRejectionsCounter = import_api6.metrics.getMeter("publisher").createCounter("publisher_query_admission_rejections_total", {
+  queryAdmissionRejectionsCounter = import_api7.metrics.getMeter("publisher").createCounter("publisher_query_admission_rejections_total", {
     description: "Queries rejected with 503 because Environment.assertCanAdmitQuery() observed memory back-pressure"
   });
   return queryAdmissionRejectionsCounter;
@@ -232405,7 +232490,7 @@ function getPackageAdmissionRejectionsCounter() {
   if (packageAdmissionRejectionsCounter) {
     return packageAdmissionRejectionsCounter;
   }
-  packageAdmissionRejectionsCounter = import_api6.metrics.getMeter("publisher").createCounter("publisher_package_admission_rejections_total", {
+  packageAdmissionRejectionsCounter = import_api7.metrics.getMeter("publisher").createCounter("publisher_package_admission_rejections_total", {
     description: "Package loads rejected with 503 because Environment.assertCanAdmitNewPackage() observed memory back-pressure"
   });
   return packageAdmissionRejectionsCounter;
@@ -232531,9 +232616,11 @@ ${source}` : source;
         gateModel.assertQueryBoundaryEarly(undefined, undefined, source);
         await gateModel.assertAuthorizedForText(source, givens ?? {});
       }
+      const boundManifestEntries = pkg.getBuildManifestEntries();
       const runtime = new Runtime2({
         urlReader: interceptingReader,
-        config: pkg.getMalloyConfig()
+        config: pkg.getMalloyConfig(),
+        buildManifest: boundManifestEntries ? { entries: boundManifestEntries, strict: false } : undefined
       });
       try {
         const modelMaterializer = runtime.loadModel(virtualUrl);
@@ -232880,8 +232967,10 @@ ${source}` : source;
   async bindManifest(pkg, manifestLocation) {
     const packageName = pkg.getPackageName();
     try {
-      const entries = await fetchManifestEntries(manifestLocation);
+      const entries = await this.fetchManifestEntriesWithTimeout(manifestLocation);
       await pkg.reloadAllModels(entries);
+      pkg.setBoundManifestUri(manifestLocation);
+      recordManifestBind("success");
       logger.info("Bound build manifest to package", {
         environmentName: this.environmentName,
         packageName,
@@ -232889,14 +232978,34 @@ ${source}` : source;
         entryCount: Object.keys(entries).length
       });
     } catch (err) {
+      pkg.markManifestBindFailed();
+      const timedOut = err instanceof Error && err.message.includes("Timed out after");
+      recordManifestBind(timedOut ? "timeout" : "failure");
       logger.warn("Failed to bind build manifest; serving live", {
         environmentName: this.environmentName,
         packageName,
         manifestLocation,
+        timedOut,
         error: err instanceof Error ? err.message : String(err)
       });
     }
   }
+  async fetchManifestEntriesWithTimeout(manifestLocation) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new Error(`Timed out after ${MANIFEST_FETCH_TIMEOUT_MS}ms fetching manifest ${manifestLocation}`)), MANIFEST_FETCH_TIMEOUT_MS);
+    });
+    try {
+      return await Promise.race([
+        fetchManifestEntries(manifestLocation),
+        timeout
+      ]);
+    } finally {
+      if (timer) {
+        clearTimeout(timer);
+      }
+    }
+  }
   async getModelFileText(packageName, modelPath) {
     assertSafePackageName(packageName);
     assertSafeRelativeModelPath(modelPath);
@@ -234306,14 +234415,14 @@ var setFilterDeprecationHeaders = (res, options) => {
 
 // src/heap_check.ts
 init_logger();
-var import_api7 = __toESM(require_src(), 1);
+var import_api8 = __toESM(require_src(), 1);
 import * as v8 from "v8";
 var heapGaugesInstalled = false;
 function installHeapGauges() {
   if (heapGaugesInstalled)
     return;
   heapGaugesInstalled = true;
-  const meter2 = import_api7.metrics.getMeter("publisher");
+  const meter2 = import_api8.metrics.getMeter("publisher");
   meter2.createObservableGauge("publisher_heap_size_limit_bytes", {
     description: "V8 heap_size_limit (--max-old-space-size). Compare with PUBLISHER_MAX_MEMORY_BYTES.",
     unit: "By"
@@ -234348,7 +234457,7 @@ function checkHeapConfiguration(options = {}) {
 }
 
 // src/query_concurrency.ts
-var import_api8 = __toESM(require_src(), 1);
+var import_api9 = __toESM(require_src(), 1);
 init_errors();
 init_logger();
 var active = 0;
@@ -234358,7 +234467,7 @@ function ensureConcurrencyTelemetry() {
   if (queryConcurrencyRejectionsCounter && concurrencyTelemetryInitialized) {
     return queryConcurrencyRejectionsCounter;
   }
-  const meter2 = import_api8.metrics.getMeter("publisher");
+  const meter2 = import_api9.metrics.getMeter("publisher");
   queryConcurrencyRejectionsCounter = meter2.createCounter("publisher_query_concurrency_rejections_total", {
     description: "Queries rejected with 503 because the per-pod PUBLISHER_MAX_CONCURRENT_QUERIES cap was reached"
   });
@@ -238979,34 +239088,6 @@ init_errors();
 init_logger();
 import { Manifest } from "@malloydata/malloy";
 
-// src/materialization_metrics.ts
-var import_api9 = __toESM(require_src(), 1);
-var roundCounter = null;
-var roundDuration = null;
-function ensureTelemetry() {
-  if (roundCounter && roundDuration) {
-    return { counter: roundCounter, duration: roundDuration };
-  }
-  const meter2 = import_api9.metrics.getMeter("publisher");
-  if (!roundCounter) {
-    roundCounter = meter2.createCounter("publisher_materialization_rounds_total", {
-      description: "Materialization rounds completed. Labels: round ('round1'|'round2'|'auto'), outcome ('success'|'failed'|'cancelled')."
-    });
-  }
-  if (!roundDuration) {
-    roundDuration = meter2.createHistogram("publisher_materialization_round_duration_ms", {
-      description: "Wall-clock duration of a materialization round. Label: round ('round1'|'round2'|'auto').",
-      unit: "ms"
-    });
-  }
-  return { counter: roundCounter, duration: roundDuration };
-}
-function recordMaterializationRound(round, outcome, durationMs) {
-  const { counter, duration } = ensureTelemetry();
-  counter.add(1, { round, outcome });
-  duration.record(durationMs, { round });
-}
-
 // src/service/quoting.ts
 function splitTablePath(tableName) {
   const lastDot = tableName.lastIndexOf(".");
@@ -239051,6 +239132,9 @@ function deriveColumns(persistSource) {
 function flattenDependsOn(node) {
   return node.dependsOn.map((d) => d.sourceID);
 }
+function computeBuildId(source, connectionDigests) {
+  return source.makeBuildId(connectionDigests[source.connectionName], source.getSQL());
+}
 function selfAssignTableName(persistSource) {
   try {
     return persistSource.annotations.parseAsTag("@").tag.text("name") || persistSource.name;
@@ -239107,6 +239191,11 @@ class MaterializationService {
       throw new MaterializationNotFoundError(`Materialization ${id} not found`);
     }
     this.validateTransition(current.status, next);
+    logger.info("Materialization transition", {
+      materializationId: id,
+      from: current.status,
+      to: next
+    });
     return this.repository.updateMaterialization(id, {
       status: next,
       ...extra
@@ -239192,24 +239281,14 @@ class MaterializationService {
       const priorEntries = forceRefresh ? {} : await this.getMostRecentManifestEntries(environmentId, packageName, id);
       const { instructions, carried } = this.deriveSelfInstructions(compiled, sourceNames, priorEntries);
       const entries = await this.executeInstructedBuild(compiled, instructions, carried, signal);
-      await this.transition(id, "MANIFEST_ROWS_READY");
-      const manifestResult = {
-        builtAt: new Date().toISOString(),
-        entries,
-        strict: false
-      };
       const durationMs = Date.now() - startedAt;
-      await this.transition(id, "MANIFEST_FILE_READY", {
-        completedAt: new Date,
-        manifest: manifestResult,
-        metadata: {
-          forceRefresh,
-          sourceNames: sourceNames ?? null,
-          pauseBetweenPhases: false,
-          sourcesBuilt: instructions.length,
-          sourcesReused: Object.keys(carried).length,
-          durationMs
-        }
+      await this.commitManifest(id, entries, {
+        forceRefresh,
+        sourceNames: sourceNames ?? null,
+        pauseBetweenPhases: false,
+        sourcesBuilt: instructions.length,
+        sourcesReused: Object.keys(carried).length,
+        durationMs
       });
       await this.autoLoadManifest(environment, packageName, entries);
       this.recordRound("auto", "success", startedAt);
@@ -239238,7 +239317,7 @@ class MaterializationService {
             continue;
           if (include && !include.has(persistSource.name))
             continue;
-          const buildId = persistSource.makeBuildId(compiled.connectionDigests[persistSource.connectionName], persistSource.getSQL());
+          const buildId = computeBuildId(persistSource, compiled.connectionDigests);
           if (seen.has(buildId))
             continue;
           seen.add(buildId);
@@ -239331,20 +239410,10 @@ class MaterializationService {
       const pkg = await environment.getPackage(packageName, false);
       const compiled = await environment.withPackageLock(packageName, () => this.compilePackageBuildPlan(pkg, signal));
       const entries = await this.executeInstructedBuild(compiled, instructions, {}, signal);
-      await this.transition(id, "MANIFEST_ROWS_READY");
-      const manifestResult = {
-        builtAt: new Date().toISOString(),
-        entries,
-        strict: false
-      };
       const durationMs = Date.now() - startedAt;
-      await this.transition(id, "MANIFEST_FILE_READY", {
-        completedAt: new Date,
-        manifest: manifestResult,
-        metadata: {
-          sourcesBuilt: Object.keys(entries).length,
-          durationMs
-        }
+      await this.commitManifest(id, entries, {
+        sourcesBuilt: Object.keys(entries).length,
+        durationMs
       });
       this.recordRound("round2", "success", startedAt);
       logger.info("Materialization Round 2 complete", {
@@ -239384,7 +239453,7 @@ class MaterializationService {
           const persistSource = sources[node.sourceID];
           if (!persistSource)
             continue;
-          const buildId = persistSource.makeBuildId(connectionDigests[persistSource.connectionName], persistSource.getSQL());
+          const buildId = computeBuildId(persistSource, connectionDigests);
           const instruction = byBuildId.get(buildId);
           if (!instruction)
             continue;
@@ -239423,9 +239492,11 @@ class MaterializationService {
       throw err;
     }
     manifest.update(buildId, { tableName: physicalTableName });
-    logger.info(`Round 2 built source ${persistSource.name}`, {
+    const durationMs = Math.round(performance.now() - startTime);
+    recordSourceBuildDuration(durationMs);
+    logger.info(`Built materialized source ${persistSource.name}`, {
       physicalTableName,
-      durationMs: Math.round(performance.now() - startTime)
+      durationMs
     });
     return {
       buildId,
@@ -239498,12 +239569,14 @@ class MaterializationService {
         }
         await connection.runSQL(`DROP TABLE IF EXISTS ${physicalTableName}`);
         await connection.runSQL(`DROP TABLE IF EXISTS ${physicalTableName}${stagingSuffix(entry.buildId)}`);
+        recordDropTables("success");
         logger.info("Dropped materialized table on delete", {
           materializationId: m.id,
           physicalTableName,
           connectionName
         });
       } catch (err) {
+        recordDropTables("failure");
         logger.warn("Failed to drop materialized table on delete", {
           materializationId: m.id,
           physicalTableName,
@@ -239513,6 +239586,19 @@ class MaterializationService {
       }
     }
   }
+  async commitManifest(id, entries, metadata) {
+    await this.transition(id, "MANIFEST_ROWS_READY");
+    const manifest = {
+      builtAt: new Date().toISOString(),
+      entries,
+      strict: false
+    };
+    await this.transition(id, "MANIFEST_FILE_READY", {
+      completedAt: new Date,
+      manifest,
+      metadata
+    });
+  }
   async compilePackageBuildPlan(pkg, signal) {
     const allGraphs = [];
     const allSources = {};
@@ -239569,7 +239655,7 @@ class MaterializationService {
         sourceID: source.sourceID,
         connectionName: source.connectionName,
         dialect: source.dialectName,
-        buildId: source.makeBuildId(connectionDigests[source.connectionName], source.getSQL()),
+        buildId: computeBuildId(source, connectionDigests),
         sql: source.getSQL(),
         columns: deriveColumns(source)
       };

package/package.json

@@ -1,7 +1,7 @@
 {
    "name": "@malloy-publisher/server",
    "description": "Malloy Publisher Server",
-   "version": "0.0.206",
+   "version": "0.0.207",
    "main": "dist/server.mjs",
    "bin": {
       "malloy-publisher": "dist/server.mjs"

package/src/materialization_metrics.ts

@@ -17,9 +17,14 @@ import { metrics, type Counter, type Histogram } from "@opentelemetry/api";
 
 export type MaterializationRound = "round1" | "round2" | "auto";
 export type MaterializationOutcome = "success" | "failed" | "cancelled";
+/** Manifest bind outcome: timeout is split out from generic failure on purpose. */
+export type ManifestBindOutcome = "success" | "failure" | "timeout";
 
 let roundCounter: Counter | null = null;
 let roundDuration: Histogram | null = null;
+let manifestBindCounter: Counter | null = null;
+let sourceBuildDuration: Histogram | null = null;
+let dropTablesCounter: Counter | null = null;
 
 function ensureTelemetry(): { counter: Counter; duration: Histogram } {
    if (roundCounter && roundDuration) {
@@ -59,8 +64,58 @@ export function recordMaterializationRound(
    duration.record(durationMs, { round });
 }
 
+/**
+ * Record a manifest-bind attempt (publisher binding a control-plane manifest to
+ * a package at load). `timeout` is distinguished from `failure` so operators can
+ * tell an unreachable/slow manifest store from a malformed manifest.
+ */
+export function recordManifestBind(outcome: ManifestBindOutcome): void {
+   if (!manifestBindCounter) {
+      manifestBindCounter = metrics
+         .getMeter("publisher")
+         .createCounter("publisher_materialization_manifest_bind_total", {
+            description:
+               "Manifest bind attempts. Label: outcome ('success'|'failure'|'timeout').",
+         });
+   }
+   manifestBindCounter.add(1, { outcome });
+}
+
+/** Record the wall-clock duration of building one persist source's table. */
+export function recordSourceBuildDuration(durationMs: number): void {
+   if (!sourceBuildDuration) {
+      sourceBuildDuration = metrics
+         .getMeter("publisher")
+         .createHistogram(
+            "publisher_materialization_source_build_duration_ms",
+            {
+               description:
+                  "Wall-clock duration of building a single persist source.",
+               unit: "ms",
+            },
+         );
+   }
+   sourceBuildDuration.record(durationMs);
+}
+
+/** Record a best-effort physical-table drop on materialization delete. */
+export function recordDropTables(outcome: "success" | "failure"): void {
+   if (!dropTablesCounter) {
+      dropTablesCounter = metrics
+         .getMeter("publisher")
+         .createCounter("publisher_materialization_drop_tables_total", {
+            description:
+               "Physical tables dropped on delete. Label: outcome ('success'|'failure').",
+         });
+   }
+   dropTablesCounter.add(1, { outcome });
+}
+
 /** Visible for tests. Drops cached instruments so a fresh MeterProvider can capture emissions. */
 export function resetMaterializationTelemetryForTesting(): void {
    roundCounter = null;
    roundDuration = null;
+   manifestBindCounter = null;
+   sourceBuildDuration = null;
+   dropTablesCounter = null;
 }