@simulatte/doppler 0.1.4 → 0.1.5

package/src/tooling/node-convert.d.ts

@@ -1,4 +1,8 @@
 import type { ConverterConfigSchema } from '../config/schema/converter.schema.js';
+import type { ExecutionContractArtifact } from '../config/execution-contract-check.js';
+import type { ExecutionV0GraphContractArtifact } from '../config/execution-v0-graph-contract-check.js';
+import type { ManifestRequiredInferenceFieldsArtifact } from '../config/required-inference-fields-contract-check.js';
+import type { SavedReportInfo } from '../storage/reports.js';
 
 export interface NodeConvertProgress {
   stage: string | null;
@@ -34,6 +38,12 @@ export interface ConvertSafetensorsDirectoryResult {
   manifest: Record<string, unknown>;
   shardCount: number;
   tensorCount: number;
+  executionContractArtifact: ExecutionContractArtifact | null;
+  executionV0GraphContractArtifact: ExecutionV0GraphContractArtifact | null;
+  layerPatternContractArtifact: Record<string, unknown> | null;
+  requiredInferenceFieldsArtifact: ManifestRequiredInferenceFieldsArtifact | null;
+  report: Record<string, unknown>;
+  reportInfo: SavedReportInfo;
   presetId: string;
   modelType: string;
   outputDir: string;

package/src/tooling/node-converter.js

@@ -7,6 +7,11 @@ import { bootstrapNodeWebGPU } from './node-webgpu.js';
 import { isPlainObject } from '../utils/plain-object.js';
 import { selectRuleValue } from '../rules/rule-registry.js';
 import { log, trace } from '../debug/index.js';
+import { saveReport } from '../storage/reports.js';
+import {
+  CONVERSION_REPORT_SCHEMA_VERSION,
+  validateConversionReport,
+} from '../config/schema/conversion-report.schema.js';
 
 function asPositiveInteger(value, label) {
   if (!Number.isInteger(value) || value < 1) {
@@ -594,6 +599,44 @@ function normalizeTokenizerManifest(manifest) {
   return manifest;
 }
 
+function buildConvertReport(result, context) {
+  const manifest = result?.manifest ?? null;
+  const inference = manifest?.inference && typeof manifest.inference === 'object'
+    ? manifest.inference
+    : null;
+  return validateConversionReport({
+    schemaVersion: CONVERSION_REPORT_SCHEMA_VERSION,
+    suite: 'convert',
+    command: 'convert',
+    modelId: manifest?.modelId ?? context.modelId ?? 'unknown',
+    timestamp: manifest?.metadata?.convertedAt ?? new Date().toISOString(),
+    source: 'doppler',
+    result: {
+      presetId: context.presetId ?? null,
+      modelType: context.modelType ?? null,
+      outputDir: context.outputDir ?? null,
+      shardCount: result?.shardCount ?? null,
+      tensorCount: result?.tensorCount ?? null,
+      totalSize: result?.totalSize ?? null,
+    },
+    manifest: manifest
+      ? {
+          quantization: manifest.quantization ?? null,
+          quantizationInfo: manifest.quantizationInfo ?? null,
+          inference: {
+            presetId: inference?.presetId ?? null,
+            schema: inference?.schema ?? null,
+            defaultKernelPath: inference?.defaultKernelPath ?? null,
+          },
+        }
+      : null,
+    executionContractArtifact: result?.executionContractArtifact ?? null,
+    executionV0GraphContractArtifact: result?.executionV0GraphContractArtifact ?? null,
+    layerPatternContractArtifact: result?.layerPatternContractArtifact ?? null,
+    requiredInferenceFieldsArtifact: result?.requiredInferenceFieldsArtifact ?? null,
+  });
+}
+
 function createNodeTensorTransformer(options) {
   const pool = options?.pool;
   const execution = options?.execution;
@@ -1212,10 +1255,26 @@ export async function convertSafetensorsDirectory(options) {
   normalizeTokenizerManifest(result.manifest);
   await io.writeManifest(result.manifest);
 
+  const report = buildConvertReport(result, {
+    presetId,
+    modelType: resolvedModelType,
+    outputDir,
+    modelId: result.manifest?.modelId ?? modelId,
+  });
+  const reportInfo = await saveReport(report.modelId, report, {
+    timestamp: report.timestamp,
+  });
+
   return {
     manifest: result.manifest,
     shardCount: result.shardCount,
     tensorCount: result.tensorCount,
+    executionContractArtifact: result.executionContractArtifact ?? null,
+    executionV0GraphContractArtifact: result.executionV0GraphContractArtifact ?? null,
+    layerPatternContractArtifact: result.layerPatternContractArtifact ?? null,
+    requiredInferenceFieldsArtifact: result.requiredInferenceFieldsArtifact ?? null,
+    report,
+    reportInfo,
     presetId,
     modelType: resolvedModelType,
     outputDir,

package/src/tooling/node-webgpu.js

@@ -11,7 +11,7 @@ const DEFAULT_LOCAL_DOE_PROVIDER_PATH = resolve(
   '..',
   'fawn',
   'nursery',
-  'webgpu-core',
+  'webgpu-doe',
 );
 const DEFAULT_DOE_PROVIDER_CREATE_ARGS = 'enable-dawn-features=allow_unsafe_apis';
 
@@ -61,7 +61,7 @@ function resolveCandidateModuleSpecifier(candidate) {
 function resolveDefaultWebgpuModuleSpecifiers() {
   const specifiers = [];
   const localCandidates = [
-    resolve(process.cwd(), '..', 'fawn', 'nursery', 'webgpu-core'),
+    resolve(process.cwd(), '..', 'fawn', 'nursery', 'webgpu-doe'),
     DEFAULT_LOCAL_DOE_PROVIDER_PATH,
   ];
   for (const localCandidate of localCandidates) {
@@ -70,7 +70,7 @@ function resolveDefaultWebgpuModuleSpecifiers() {
       specifiers.push(pathToFileURL(resolvedPath).href);
     }
   }
-  specifiers.push('@doe/webgpu-core');
+  specifiers.push('@simulatte/webgpu-doe');
   specifiers.push('webgpu');
   return [...new Set(specifiers)];
 }
@@ -103,17 +103,17 @@ function resolveWorkspaceWebgpuProviderPath() {
   return null;
 }
 
-function isDoeWebgpuCoreSpecifier(specifier) {
-  if (specifier === '@doe/webgpu-core') {
+function isDoeWebgpuSpecifier(specifier) {
+  if (specifier === '@simulatte/webgpu-doe') {
     return true;
   }
   if (typeof specifier !== 'string') {
     return false;
   }
-  if (specifier.includes('/webgpu-core/')) {
+  if (specifier.includes('/webgpu-doe/')) {
     return true;
   }
-  return specifier.includes('webgpu-core') && specifier.startsWith('file://');
+  return specifier.includes('webgpu-doe') && specifier.startsWith('file://');
 }
 
 function resolveDoeProviderOverride(specifier) {
@@ -121,7 +121,7 @@ function resolveDoeProviderOverride(specifier) {
   if (typeof explicitProvider === 'string' && explicitProvider.trim().length > 0) {
     return null;
   }
-  if (!isDoeWebgpuCoreSpecifier(specifier)) {
+  if (!isDoeWebgpuSpecifier(specifier)) {
     return null;
   }
   return resolveWorkspaceWebgpuProviderPath();
@@ -129,7 +129,7 @@ function resolveDoeProviderOverride(specifier) {
 
 async function importWithProviderOverride(specifier) {
   const providerOverride = resolveDoeProviderOverride(specifier);
-  const shouldApplyCreateArgsDefault = isDoeWebgpuCoreSpecifier(specifier)
+  const shouldApplyCreateArgsDefault = isDoeWebgpuSpecifier(specifier)
     && !(typeof process.env.FAWN_WEBGPU_CREATE_ARGS === 'string' && process.env.FAWN_WEBGPU_CREATE_ARGS.trim().length > 0);
   if (!providerOverride) {
     if (!shouldApplyCreateArgsDefault) {

package/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const DOPPLER_VERSION: string;
+export declare const DOPPLER_PROVIDER_VERSION: string;

package/src/version.js

@@ -0,0 +1,2 @@
+export const DOPPLER_VERSION = '0.1.5';
+export const DOPPLER_PROVIDER_VERSION = DOPPLER_VERSION;

package/tools/convert-safetensors-node.js

@@ -126,6 +126,51 @@ function normalizeExecutionConfig(rawExecution) {
   };
 }
 
+function printConvertContractSummary(result) {
+  const artifact = result?.executionContractArtifact;
+  if (!artifact || typeof artifact !== 'object') return;
+  const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
+  const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+  const layout = artifact.session?.layout ?? 'n/a';
+  console.log(
+    `[contract] status=${artifact.ok === true ? 'pass' : 'fail'} ` +
+    `checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'} layout=${layout}`
+  );
+  if (artifact.ok !== true && Array.isArray(artifact.errors)) {
+    for (const error of artifact.errors.slice(0, 3)) {
+      console.log(`[contract] error=${String(error)}`);
+    }
+  }
+  const graphArtifact = result?.executionV0GraphContractArtifact;
+  if (graphArtifact && typeof graphArtifact === 'object') {
+    const checks = Array.isArray(graphArtifact.checks) ? graphArtifact.checks : [];
+    const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+    console.log(
+      `[graph] status=${graphArtifact.ok === true ? 'pass' : 'fail'} ` +
+      `checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'}`
+    );
+  }
+  for (const [label, extraArtifact] of [
+    ['layer-pattern', result?.layerPatternContractArtifact],
+    ['required-inference', result?.requiredInferenceFieldsArtifact],
+  ]) {
+    if (!extraArtifact || typeof extraArtifact !== 'object') continue;
+    const checks = Array.isArray(extraArtifact.checks) ? extraArtifact.checks : [];
+    const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+    console.log(
+      `[${label}] status=${extraArtifact.ok === true ? 'pass' : 'fail'} ` +
+      `checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'}`
+    );
+  }
+}
+
+function printConvertReportSummary(result) {
+  const reportInfo = result?.reportInfo;
+  if (!reportInfo || typeof reportInfo !== 'object') return;
+  if (typeof reportInfo.path !== 'string' || reportInfo.path.length === 0) return;
+  console.log(`[report] ${reportInfo.path}`);
+}
+
 async function readJsonFile(filePath) {
   if (!filePath) return null;
   const raw = await fs.readFile(filePath, 'utf8');
@@ -172,6 +217,8 @@ async function main() {
   console.log(
     `[done] modelId=${result.manifest?.modelId ?? 'unknown'} preset=${result.presetId} modelType=${result.modelType} shards=${result.shardCount} tensors=${result.tensorCount}`
   );
+  printConvertContractSummary(result);
+  printConvertReportSummary(result);
 }
 
 main().catch((err) => {

package/tools/doppler-cli.js

@@ -713,7 +713,17 @@ function toSummary(result) {
   }
 
   if (result.manifest?.modelId) {
-    return `converted ${result.manifest.modelId} (${result.tensorCount} tensors, ${result.shardCount} shards)`;
+    const contractStatus = result.executionContractArtifact?.ok === true
+      ? ' contract=pass'
+      : result.executionContractArtifact
+        ? ' contract=fail'
+        : '';
+    const graphStatus = result.executionV0GraphContractArtifact?.ok === true
+      ? ' graph=pass'
+      : result.executionV0GraphContractArtifact
+        ? ' graph=fail'
+        : '';
+    return `converted ${result.manifest.modelId} (${result.tensorCount} tensors, ${result.shardCount} shards)${contractStatus}${graphStatus}`;
   }
 
   const suite = result.suite || result.report?.suite || 'suite';
@@ -1014,6 +1024,102 @@ function printMemoryReport(result) {
   console.log(`[memory] ${parts.join(' ')}`);
 }
 
+function printExecutionContractSummary(result) {
+  const artifact = result?.metrics?.executionContractArtifact;
+  if (!artifact || typeof artifact !== 'object') return;
+  const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
+  const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+  const session = artifact.session && typeof artifact.session === 'object'
+    ? artifact.session
+    : null;
+  const attentionPhases = artifact.steps?.attentionPhases && typeof artifact.steps.attentionPhases === 'object'
+    ? artifact.steps.attentionPhases
+    : null;
+  const parts = [
+    `status=${artifact.ok === true ? 'pass' : 'fail'}`,
+    checks.length > 0 ? `checks=${passedChecks}/${checks.length}` : 'checks=n/a',
+  ];
+  if (session?.layout) {
+    parts.push(`layout=${session.layout}`);
+  }
+  if (attentionPhases) {
+    parts.push(
+      `attn(prefill=${attentionPhases.prefill ?? 'n/a'},decode=${attentionPhases.decode ?? 'n/a'},both=${attentionPhases.both ?? 'n/a'})`
+    );
+  }
+  console.log(`[contract] ${parts.join(' ')}`);
+  if (artifact.ok !== true && Array.isArray(artifact.errors)) {
+    for (const error of artifact.errors.slice(0, 3)) {
+      console.log(`[contract] error=${quoteOneLine(error)}`);
+    }
+  }
+}
+
+function printExecutionV0GraphSummary(artifact) {
+  if (!artifact || typeof artifact !== 'object') return;
+  const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
+  const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+  const stats = artifact.stats && typeof artifact.stats === 'object' ? artifact.stats : null;
+  const parts = [
+    `status=${artifact.ok === true ? 'pass' : 'fail'}`,
+    checks.length > 0 ? `checks=${passedChecks}/${checks.length}` : 'checks=n/a',
+  ];
+  if (Number.isFinite(stats?.prefillSteps) || Number.isFinite(stats?.decodeSteps)) {
+    parts.push(`steps(prefill=${stats?.prefillSteps ?? 'n/a'},decode=${stats?.decodeSteps ?? 'n/a'})`);
+  }
+  console.log(`[graph] ${parts.join(' ')}`);
+  if (artifact.ok !== true && Array.isArray(artifact.errors)) {
+    for (const error of artifact.errors.slice(0, 3)) {
+      console.log(`[graph] error=${quoteOneLine(error)}`);
+    }
+  }
+}
+
+function printSimpleArtifactSummary(label, artifact) {
+  if (!artifact || typeof artifact !== 'object') return;
+  const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
+  const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+  console.log(
+    `[${label}] status=${artifact.ok === true ? 'pass' : 'fail'} ` +
+    `checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'}`
+  );
+  if (artifact.ok !== true && Array.isArray(artifact.errors)) {
+    for (const error of artifact.errors.slice(0, 2)) {
+      console.log(`[${label}] error=${quoteOneLine(error)}`);
+    }
+  }
+}
+
+function printConvertContractSummary(result) {
+  const artifact = result?.executionContractArtifact;
+  if (!artifact || typeof artifact !== 'object') return;
+  const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
+  const passedChecks = checks.filter((entry) => entry?.ok === true).length;
+  const session = artifact.session && typeof artifact.session === 'object'
+    ? artifact.session
+    : null;
+  console.log(
+    `[contract] status=${artifact.ok === true ? 'pass' : 'fail'} ` +
+    `checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'} ` +
+    `layout=${session?.layout ?? 'n/a'}`
+  );
+  if (artifact.ok !== true && Array.isArray(artifact.errors)) {
+    for (const error of artifact.errors.slice(0, 3)) {
+      console.log(`[contract] error=${quoteOneLine(error)}`);
+    }
+  }
+  printExecutionV0GraphSummary(result?.executionV0GraphContractArtifact);
+  printSimpleArtifactSummary('layer-pattern', result?.layerPatternContractArtifact);
+  printSimpleArtifactSummary('required-inference', result?.requiredInferenceFieldsArtifact);
+}
+
+function printConvertReportSummary(result) {
+  const reportInfo = result?.reportInfo;
+  if (!reportInfo || typeof reportInfo !== 'object') return;
+  if (typeof reportInfo.path !== 'string' || reportInfo.path.length === 0) return;
+  console.log(`[report] ${reportInfo.path}`);
+}
+
 function printMetricsSummary(result) {
   if (!result || typeof result !== 'object') return;
   const suite = String(result.suite || '');
@@ -1038,6 +1144,8 @@ function printMetricsSummary(result) {
       `prefill=${formatNumber(metrics.prefillTokensPerSec)} ` +
       `decode=${formatNumber(metrics.decodeTokensPerSec)}`
     );
+    printExecutionContractSummary(result);
+    printExecutionV0GraphSummary(metrics.executionV0GraphContractArtifact);
     return;
   }
 
@@ -1052,6 +1160,8 @@ function printMetricsSummary(result) {
         `median=${formatMs(metrics.medianEmbeddingMs)} avg=${formatMs(metrics.avgEmbeddingMs)} ` +
         `eps=${formatNumber(metrics.avgEmbeddingsPerSec)}`
       );
+      printExecutionContractSummary(result);
+      printExecutionV0GraphSummary(metrics.executionV0GraphContractArtifact);
       return;
     }
 
@@ -1073,6 +1183,8 @@ function printMetricsSummary(result) {
       `[metrics] latency first=${formatMs(metrics.firstTokenMs)} ` +
       `prefill=${formatMs(metrics.prefillMs)} decode=${formatMs(metrics.decodeMs)}`
     );
+    printExecutionContractSummary(result);
+    printExecutionV0GraphSummary(metrics.executionV0GraphContractArtifact);
     printDeviceInfo(result);
     printGpuPhases(metrics);
     printMemoryReport(result);
@@ -1190,6 +1302,8 @@ async function main() {
     }
 
     console.log(`[ok] ${toSummary(response.result)}`);
+    printConvertContractSummary(response.result);
+    printConvertReportSummary(response.result);
     printMetricsSummary(response.result);
   } catch (error) {
     if (jsonOutputRequested) {