@kici-dev/shared 0.1.26 → 0.2.0

package/dist/telemetry/init.d.ts

@@ -17,14 +17,25 @@ export interface TelemetryConfig {
 export declare function initTelemetry(config: TelemetryConfig): NodeSDK;
 /** Get the PrometheusExporter instance created by initTelemetry(). */
 export declare function getPrometheusExporter(): PrometheusExporter | undefined;
+/** One instrument's identity plus the descriptor facts that decide its wire kind. */
+export interface RuntimeMetricDescriptor {
+    name: string;
+    dataPointType: number;
+    isMonotonic?: boolean;
+}
 /**
- * Boot `RuntimeNodeInstrumentation` standalone, exercise the event loop and
- * garbage collector, collect once, and return the set of dotted instrument
- * names it emitted. This is the ground truth for the curated runtime-metrics
- * catalog drift guard (`scripts/generate-prometheus.ts`). It deliberately
- * does NOT touch the singleton `_prometheusExporter` — it spins up an
- * isolated SDK so it can be called from tooling without affecting a running
- * service's telemetry.
+ * The sorted set of dotted instrument names `RuntimeNodeInstrumentation`
+ * emits. This is the ground truth for the curated runtime-metrics catalog
+ * drift guard (`scripts/generate-prometheus.ts`).
  */
 export declare function collectRuntimeMetricNames(): Promise<string[]>;
+/**
+ * Like `collectRuntimeMetricNames`, but also returns each instrument's
+ * descriptor type and monotonicity — the facts that decide the wire kind the
+ * Platform admits it as. Ground truth for the drift guard's kind check.
+ *
+ * Deliberately not exported from the package barrel: it is tooling ground truth,
+ * and `@kici-dev/shared` is a published surface.
+ */
+export declare function collectRuntimeMetricDescriptors(): Promise<RuntimeMetricDescriptor[]>;
 //# sourceMappingURL=init.d.ts.map

package/dist/telemetry/init.js

@@ -38,14 +38,12 @@ function getPrometheusExporter() {
 }
 /**
 * Boot `RuntimeNodeInstrumentation` standalone, exercise the event loop and
-* garbage collector, collect once, and return the set of dotted instrument
-* names it emitted. This is the ground truth for the curated runtime-metrics
-* catalog drift guard (`scripts/generate-prometheus.ts`). It deliberately
-* does NOT touch the singleton `_prometheusExporter` — it spins up an
-* isolated SDK so it can be called from tooling without affecting a running
-* service's telemetry.
+* garbage collector, collect once, and return one descriptor per instrument it
+* emitted. It deliberately does NOT touch the singleton `_prometheusExporter` —
+* it spins up an isolated SDK so it can be called from tooling without
+* affecting a running service's telemetry.
 */
-async function collectRuntimeMetricNames() {
+async function probeRuntimeInstruments() {
 	const exporter = new PrometheusExporter({ preventServerStart: true });
 	const sdk = new NodeSDK({
 		resource: resourceFromAttributes({ [ATTR_SERVICE_NAME]: "runtime-metrics-drift-guard" }),
@@ -61,13 +59,40 @@ async function collectRuntimeMetricNames() {
 	}
 	if (typeof global.gc === "function") global.gc();
 	await new Promise((r) => setTimeout(r, 500));
-	const names = /* @__PURE__ */ new Set();
+	const descriptors = [];
 	const { resourceMetrics } = await exporter.collect();
-	for (const scopeMetrics of resourceMetrics.scopeMetrics) for (const metric of scopeMetrics.metrics) names.add(metric.descriptor.name);
+	for (const scopeMetrics of resourceMetrics.scopeMetrics) for (const metric of scopeMetrics.metrics) {
+		const m = metric;
+		descriptors.push({
+			name: m.descriptor.name,
+			dataPointType: m.dataPointType,
+			...m.isMonotonic === void 0 ? {} : { isMonotonic: m.isMonotonic }
+		});
+	}
 	await sdk.shutdown();
-	return [...names].sort();
+	return descriptors;
+}
+/**
+* The sorted set of dotted instrument names `RuntimeNodeInstrumentation`
+* emits. This is the ground truth for the curated runtime-metrics catalog
+* drift guard (`scripts/generate-prometheus.ts`).
+*/
+async function collectRuntimeMetricNames() {
+	const descriptors = await probeRuntimeInstruments();
+	return [...new Set(descriptors.map((d) => d.name))].sort();
+}
+/**
+* Like `collectRuntimeMetricNames`, but also returns each instrument's
+* descriptor type and monotonicity — the facts that decide the wire kind the
+* Platform admits it as. Ground truth for the drift guard's kind check.
+*
+* Deliberately not exported from the package barrel: it is tooling ground truth,
+* and `@kici-dev/shared` is a published surface.
+*/
+async function collectRuntimeMetricDescriptors() {
+	return (await probeRuntimeInstruments()).sort((a, b) => a.name.localeCompare(b.name));
 }
 //#endregion
-export { collectRuntimeMetricNames, getPrometheusExporter, initTelemetry };
+export { collectRuntimeMetricDescriptors, collectRuntimeMetricNames, getPrometheusExporter, initTelemetry };
 
 //# sourceMappingURL=init.js.map

package/dist/tmp-dir.d.ts

@@ -0,0 +1,14 @@
+import { kiciTmpBase } from '@kici-dev/core/tmp';
+/**
+ * Base directory for KiCI-created temp files. Honors the `KICI_TMPDIR` env var
+ * (creating it if it does not yet exist) so an operator can route KiCI's temp
+ * footprint onto a volume with room; falls back to the OS temp dir otherwise.
+ * Server-side only (Node fs/os) — do NOT import from browser-bundled code.
+ *
+ * Delegates to `@kici-dev/core/tmp`'s resolver so `KICI_TMPDIR` is read in
+ * exactly one place across the codebase.
+ */
+export { kiciTmpBase };
+/** Create a fresh unique temp dir under {@link kiciTmpBase} with `prefix`. */
+export declare function kiciMkdtemp(prefix: string): string;
+//# sourceMappingURL=tmp-dir.d.ts.map

package/dist/tmp-dir.js

@@ -0,0 +1,13 @@
+import "./rolldown-runtime-ClRpJifh.js";
+import { mkdtempSync } from "node:fs";
+import path from "node:path";
+import { kiciTmpBase } from "@kici-dev/core/tmp";
+//#region src/tmp-dir.ts
+/** Create a fresh unique temp dir under {@link kiciTmpBase} with `prefix`. */
+function kiciMkdtemp(prefix) {
+	return mkdtempSync(path.join(kiciTmpBase(), prefix));
+}
+//#endregion
+export { kiciMkdtemp, kiciTmpBase };
+
+//# sourceMappingURL=tmp-dir.js.map

package/dist/tmp-dir.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tmp-dir.test.d.ts.map

package/dist/tmp.d.ts

@@ -0,0 +1,2 @@
+export * from '@kici-dev/core/tmp';
+//# sourceMappingURL=tmp.d.ts.map

package/dist/tmp.js

@@ -0,0 +1,3 @@
+import "./rolldown-runtime-ClRpJifh.js";
+export * from "@kici-dev/core/tmp";
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kici-dev/shared",
-  "version": "0.1.26",
+  "version": "0.2.0",
   "description": "Shared utilities for the KiCI CI/CD stack — logging, zx setup, crypto, telemetry, health and metrics routes. No business logic.",
   "keywords": [
     "ci",
@@ -50,10 +50,18 @@
       "import": "./dist/ts-loader-hook.js",
       "types": "./dist/ts-loader-hook.d.ts"
     },
+    "./tmp": {
+      "import": "./dist/tmp.js",
+      "types": "./dist/tmp.d.ts"
+    },
     "./idempotency": {
       "import": "./dist/idempotency.js",
       "types": "./dist/idempotency.d.ts"
     },
+    "./ci-env": {
+      "import": "./dist/ci-env.js",
+      "types": "./dist/ci-env.d.ts"
+    },
     "./idempotency-files": {
       "import": "./dist/idempotency-files.js",
       "types": "./dist/idempotency-files.d.ts"
@@ -84,36 +92,37 @@
     }
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.1064.0",
+    "@aws-sdk/client-s3": "^3.1089.0",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.218.0",
-    "@opentelemetry/exporter-prometheus": "^0.218.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
-    "@opentelemetry/instrumentation-runtime-node": "^0.31.0",
-    "@opentelemetry/resources": "^2.7.1",
-    "@opentelemetry/sdk-node": "^0.218.0",
-    "@opentelemetry/semantic-conventions": "^1.41.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.221.0",
+    "@opentelemetry/exporter-prometheus": "^0.221.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.221.0",
+    "@opentelemetry/instrumentation-runtime-node": "^0.34.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-node": "^0.221.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
     "archiver": "^8.0.0",
     "diff": "^9.0.0",
-    "hono": "^4.12.25",
-    "kysely": "^0.29.2",
-    "oxc-transform": "0.135.0",
-    "pg": "^8.21.0",
+    "hono": "^4.12.32",
+    "kysely": "^0.29.4",
+    "oxc-transform": "0.140.0",
+    "pg": "^8.22.0",
     "picocolors": "^1.1.1",
     "winston": "^3.19.0",
     "winston-daily-rotate-file": "^5.0.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
     "zx": "^8.8.5",
-    "@kici-dev/core": "0.1.26"
+    "@kici-dev/core": "0.2.0",
+    "@kici-dev/engine": "0.2.0"
   },
   "devDependencies": {
-    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "@opentelemetry/sdk-trace-base": "^2.10.0",
     "@types/archiver": "^8.0.0"
   },
   "scripts": {
-    "build": "node ../../scripts/build-ts.mjs && tsc --emitDeclarationOnly",
+    "build": "node ../../scripts/build-ts.mjs && tsgo --emitDeclarationOnly",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   }
 }