@nebutra/3d-pipeline 0.1.0

package/README.md

@@ -0,0 +1,20 @@
+# @nebutra/3d-pipeline
+
+Status: WIP — Not yet integrated into any production app.
+
+`@nebutra/3d-pipeline` is the BrandContext-first mesh capability surface. The
+zero-config path writes a valid minimal glTF mesh and a preview SVG so examples
+and tests run without GPU/model credentials. Model-backed mesh generation,
+retopology, UV, and Blender automation are sidecar ports.
+
+It does not own prompt orchestration, Thread/Turn/Item state, model provider
+routing, or approval lifecycle.
+
+## Commands
+
+```bash
+pnpm 3d:doctor
+pnpm 3d:debug
+pnpm 3d:preview
+pnpm 3d:export
+```

package/dist/chunk-PGYUP7CZ.js

@@ -0,0 +1,134 @@
+// src/index.ts
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
+import {
+  assetId,
+  requireBrandContext,
+  summarizeBrandContext
+} from "@nebutra/generation-context";
+async function readMeshDebug(root = process.cwd(), limit = 10) {
+  return readCapabilityDebug("3d-pipeline", { root, limit });
+}
+function gltfDocument(brand, intent) {
+  return {
+    asset: { version: "2.0", generator: "@nebutra/3d-pipeline deterministic mesh" },
+    scene: 0,
+    scenes: [{ nodes: [0] }],
+    nodes: [{ mesh: 0, name: `${brand.name} ${intent.type}` }],
+    meshes: [
+      {
+        primitives: [
+          {
+            attributes: { POSITION: 0 },
+            indices: 1,
+            material: 0
+          }
+        ]
+      }
+    ],
+    materials: [{ name: brand.palette[0]?.name ?? "brand", pbrMetallicRoughness: {} }],
+    extras: { brand: summarizeBrandContext(brand), intent }
+  };
+}
+function previewSvg(brand, intent) {
+  const primary = brand.palette[0]?.hex ?? "#111111";
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="640" height="480">
+  <rect width="640" height="480" fill="${primary}"/>
+  <polygon points="320,72 520,360 120,360" fill="#ffffff" opacity="0.88"/>
+  <text x="64" y="430" fill="#ffffff" font-family="${brand.typography.body}" font-size="28">${brand.name} ${intent.type}</text>
+</svg>`;
+}
+var MeshPipeline = class {
+  #root;
+  constructor(options = {}) {
+    this.#root = options.root ?? process.cwd();
+  }
+  async fromText(description, brandInput) {
+    return this.#write({ type: "product-mockup", description }, brandInput);
+  }
+  async fromImage(image, brandInput) {
+    return this.#write(
+      { type: "product-mockup", description: `image-to-mesh source ${image.path}` },
+      brandInput
+    );
+  }
+  async batchFromIntent(intent, brandInput) {
+    const count = intent.type === "icon-pack" ? Math.max(1, Math.min(intent.count, 10)) : 1;
+    const assets = [];
+    for (let index = 0; index < count; index += 1) {
+      assets.push(await this.#write(intent, brandInput));
+    }
+    return assets;
+  }
+  async preview(asset) {
+    return { path: asset.previewImagePath };
+  }
+  async export(asset, format = "gltf") {
+    if (format === "gltf") return { path: asset.gltfPath };
+    const path = join(
+      this.#root,
+      ".nebutra",
+      "generated",
+      "3d-pipeline",
+      `${asset.id}.${format}.json`
+    );
+    await writeFile(
+      path,
+      `${JSON.stringify({ source: asset.gltfPath, format }, null, 2)}
+`,
+      "utf8"
+    );
+    return { path };
+  }
+  async doctor() {
+    return [
+      { provider: "gltf-local", ok: true },
+      {
+        provider: "local-mesh-model",
+        ok: Boolean(process.env.MESH_LOCAL_MODEL_PATH),
+        suggestion: "Set MESH_LOCAL_MODEL_PATH to enable local mesh generation."
+      },
+      {
+        provider: "remote-mesh",
+        ok: Boolean(process.env.MESH_REMOTE_API_KEY),
+        suggestion: "Set MESH_REMOTE_API_KEY to enable remote mesh fallback."
+      }
+    ];
+  }
+  async #write(intent, brandInput) {
+    const brand = requireBrandContext(brandInput, "3d-pipeline");
+    const id = assetId("mesh", `${intent.type}_${brand.brandId}`);
+    const dir = join(this.#root, ".nebutra", "generated", "3d-pipeline");
+    const gltfPath = join(dir, `${id}.gltf`);
+    const previewImagePath = join(dir, `${id}.svg`);
+    await mkdir(dir, { recursive: true });
+    await writeFile(gltfPath, `${JSON.stringify(gltfDocument(brand, intent), null, 2)}
+`, "utf8");
+    await writeFile(previewImagePath, previewSvg(brand, intent), "utf8");
+    const asset = {
+      id,
+      tenantId: brand.tenantId,
+      kind: "mesh",
+      path: gltfPath,
+      gltfPath,
+      previewImagePath,
+      brandId: brand.brandId,
+      provider: "gltf-local",
+      model: "brand-context-gltf-v1",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      license: { status: "commercial-ok", source: "deterministic local mesh" },
+      triangleCount: 1,
+      format: "gltf",
+      metadata: { intent, brandSource: brand.sourcePath }
+    };
+    await appendCapabilityDebug("3d-pipeline", { type: "mesh", asset }, { root: this.#root });
+    return asset;
+  }
+};
+
+export {
+  readMeshDebug,
+  MeshPipeline
+};
+//# sourceMappingURL=chunk-PGYUP7CZ.js.map

package/dist/chunk-PGYUP7CZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { appendCapabilityDebug, readCapabilityDebug } from \"@nebutra/capability-kit/debug\";\nimport {\n  assetId,\n  type BrandContext,\n  type GeneratedAsset,\n  requireBrandContext,\n  summarizeBrandContext,\n} from \"@nebutra/generation-context\";\nimport type { ImageAsset } from \"@nebutra/image-pipeline\";\n\nexport type MeshIntent =\n  | { type: \"product-mockup\"; description: string }\n  | { type: \"logo-extrusion\"; depth: number }\n  | { type: \"icon-pack\"; count: number };\n\nexport interface MeshAsset extends GeneratedAsset {\n  readonly kind: \"mesh\";\n  readonly gltfPath: string;\n  readonly usdzPath?: string;\n  readonly objPath?: string;\n  readonly fbxPath?: string;\n  readonly previewImagePath: string;\n  readonly triangleCount: number;\n  readonly format: \"gltf\";\n}\n\nexport interface MeshHealth {\n  readonly provider: string;\n  readonly ok: boolean;\n  readonly suggestion?: string;\n}\n\nexport interface MeshPipelineOptions {\n  readonly root?: string;\n}\n\nexport async function readMeshDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {\n  return readCapabilityDebug(\"3d-pipeline\", { root, limit });\n}\n\nfunction gltfDocument(brand: BrandContext, intent: MeshIntent): Record<string, unknown> {\n  return {\n    asset: { version: \"2.0\", generator: \"@nebutra/3d-pipeline deterministic mesh\" },\n    scene: 0,\n    scenes: [{ nodes: [0] }],\n    nodes: [{ mesh: 0, name: `${brand.name} ${intent.type}` }],\n    meshes: [\n      {\n        primitives: [\n          {\n            attributes: { POSITION: 0 },\n            indices: 1,\n            material: 0,\n          },\n        ],\n      },\n    ],\n    materials: [{ name: brand.palette[0]?.name ?? \"brand\", pbrMetallicRoughness: {} }],\n    extras: { brand: summarizeBrandContext(brand), intent },\n  };\n}\n\nfunction previewSvg(brand: BrandContext, intent: MeshIntent): string {\n  const primary = brand.palette[0]?.hex ?? \"#111111\";\n  return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"640\" height=\"480\">\n  <rect width=\"640\" height=\"480\" fill=\"${primary}\"/>\n  <polygon points=\"320,72 520,360 120,360\" fill=\"#ffffff\" opacity=\"0.88\"/>\n  <text x=\"64\" y=\"430\" fill=\"#ffffff\" font-family=\"${brand.typography.body}\" font-size=\"28\">${brand.name} ${intent.type}</text>\n</svg>`;\n}\n\nexport class MeshPipeline {\n  readonly #root: string;\n\n  constructor(options: MeshPipelineOptions = {}) {\n    this.#root = options.root ?? process.cwd();\n  }\n\n  async fromText(description: string, brandInput: BrandContext | undefined): Promise<MeshAsset> {\n    return this.#write({ type: \"product-mockup\", description }, brandInput);\n  }\n\n  async fromImage(\n    image: Pick<ImageAsset, \"path\">,\n    brandInput: BrandContext | undefined,\n  ): Promise<MeshAsset> {\n    return this.#write(\n      { type: \"product-mockup\", description: `image-to-mesh source ${image.path}` },\n      brandInput,\n    );\n  }\n\n  async batchFromIntent(\n    intent: MeshIntent,\n    brandInput: BrandContext | undefined,\n  ): Promise<MeshAsset[]> {\n    const count = intent.type === \"icon-pack\" ? Math.max(1, Math.min(intent.count, 10)) : 1;\n    const assets: MeshAsset[] = [];\n    for (let index = 0; index < count; index += 1) {\n      assets.push(await this.#write(intent, brandInput));\n    }\n    return assets;\n  }\n\n  async preview(asset: MeshAsset): Promise<{ path: string }> {\n    return { path: asset.previewImagePath };\n  }\n\n  async export(\n    asset: MeshAsset,\n    format: \"gltf\" | \"obj\" | \"usdz\" | \"fbx\" = \"gltf\",\n  ): Promise<{ path: string }> {\n    if (format === \"gltf\") return { path: asset.gltfPath };\n    const path = join(\n      this.#root,\n      \".nebutra\",\n      \"generated\",\n      \"3d-pipeline\",\n      `${asset.id}.${format}.json`,\n    );\n    await writeFile(\n      path,\n      `${JSON.stringify({ source: asset.gltfPath, format }, null, 2)}\\n`,\n      \"utf8\",\n    );\n    return { path };\n  }\n\n  async doctor(): Promise<MeshHealth[]> {\n    return [\n      { provider: \"gltf-local\", ok: true },\n      {\n        provider: \"local-mesh-model\",\n        ok: Boolean(process.env.MESH_LOCAL_MODEL_PATH),\n        suggestion: \"Set MESH_LOCAL_MODEL_PATH to enable local mesh generation.\",\n      },\n      {\n        provider: \"remote-mesh\",\n        ok: Boolean(process.env.MESH_REMOTE_API_KEY),\n        suggestion: \"Set MESH_REMOTE_API_KEY to enable remote mesh fallback.\",\n      },\n    ];\n  }\n\n  async #write(intent: MeshIntent, brandInput: BrandContext | undefined): Promise<MeshAsset> {\n    const brand = requireBrandContext(brandInput, \"3d-pipeline\");\n    const id = assetId(\"mesh\", `${intent.type}_${brand.brandId}`);\n    const dir = join(this.#root, \".nebutra\", \"generated\", \"3d-pipeline\");\n    const gltfPath = join(dir, `${id}.gltf`);\n    const previewImagePath = join(dir, `${id}.svg`);\n    await mkdir(dir, { recursive: true });\n    await writeFile(gltfPath, `${JSON.stringify(gltfDocument(brand, intent), null, 2)}\\n`, \"utf8\");\n    await writeFile(previewImagePath, previewSvg(brand, intent), \"utf8\");\n\n    const asset: MeshAsset = {\n      id,\n      tenantId: brand.tenantId,\n      kind: \"mesh\",\n      path: gltfPath,\n      gltfPath,\n      previewImagePath,\n      brandId: brand.brandId,\n      provider: \"gltf-local\",\n      model: \"brand-context-gltf-v1\",\n      createdAt: new Date().toISOString(),\n      license: { status: \"commercial-ok\", source: \"deterministic local mesh\" },\n      triangleCount: 1,\n      format: \"gltf\",\n      metadata: { intent, brandSource: brand.sourcePath },\n    };\n    await appendCapabilityDebug(\"3d-pipeline\", { type: \"mesh\", asset }, { root: this.#root });\n    return asset;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,37 @@
+import {
+  MeshPipeline,
+  readMeshDebug
+} from "./chunk-PGYUP7CZ.js";
+
+// src/cli.ts
+import { createDemoBrandContext } from "@nebutra/generation-context";
+var command = process.argv[2] ?? "doctor";
+var pipeline = new MeshPipeline();
+if (command === "doctor") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", results: await pipeline.doctor() }, null, 2)}
+`
+  );
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", entries: await readMeshDebug() }, null, 2)}
+`
+  );
+} else if (command === "preview") {
+  const asset = await pipeline.fromText("sleek debugging mascot", createDemoBrandContext());
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", preview: await pipeline.preview(asset) }, null, 2)}
+`
+  );
+} else if (command === "export") {
+  const asset = await pipeline.fromText("sleek debugging mascot", createDemoBrandContext());
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", export: await pipeline.export(asset, "gltf") }, null, 2)}
+`
+  );
+} else {
+  process.stderr.write(`Unknown 3d-pipeline command: ${command}
+`);
+  process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { createDemoBrandContext } from \"@nebutra/generation-context\";\nimport { MeshPipeline, readMeshDebug } from \"./index\";\n\nconst command = process.argv[2] ?? \"doctor\";\nconst pipeline = new MeshPipeline();\n\nif (command === \"doctor\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"3d-pipeline\", results: await pipeline.doctor() }, null, 2)}\\n`,\n  );\n} else if (command === \"debug\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"3d-pipeline\", entries: await readMeshDebug() }, null, 2)}\\n`,\n  );\n} else if (command === \"preview\") {\n  const asset = await pipeline.fromText(\"sleek debugging mascot\", createDemoBrandContext());\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"3d-pipeline\", preview: await pipeline.preview(asset) }, null, 2)}\\n`,\n  );\n} else if (command === \"export\") {\n  const asset = await pipeline.fromText(\"sleek debugging mascot\", createDemoBrandContext());\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"3d-pipeline\", export: await pipeline.export(asset, \"gltf\") }, null, 2)}\\n`,\n  );\n} else {\n  process.stderr.write(`Unknown 3d-pipeline command: ${command}\\n`);\n  process.exitCode = 1;\n}\n"],"mappings":";;;;;;AAAA,SAAS,8BAA8B;AAGvC,IAAM,UAAU,QAAQ,KAAK,CAAC,KAAK;AACnC,IAAM,WAAW,IAAI,aAAa;AAElC,IAAI,YAAY,UAAU;AACxB,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,eAAe,SAAS,MAAM,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC7F;AACF,WAAW,YAAY,SAAS;AAC9B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,eAAe,SAAS,MAAM,cAAc,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC3F;AACF,WAAW,YAAY,WAAW;AAChC,QAAM,QAAQ,MAAM,SAAS,SAAS,0BAA0B,uBAAuB,CAAC;AACxF,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,eAAe,SAAS,MAAM,SAAS,QAAQ,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EACnG;AACF,WAAW,YAAY,UAAU;AAC/B,QAAM,QAAQ,MAAM,SAAS,SAAS,0BAA0B,uBAAuB,CAAC;AACxF,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,eAAe,QAAQ,MAAM,SAAS,OAAO,OAAO,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EACzG;AACF,OAAO;AACL,UAAQ,OAAO,MAAM,gCAAgC,OAAO;AAAA,CAAI;AAChE,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { GeneratedAsset, BrandContext } from '@nebutra/generation-context';
+import { ImageAsset } from '@nebutra/image-pipeline';
+
+type MeshIntent = {
+    type: "product-mockup";
+    description: string;
+} | {
+    type: "logo-extrusion";
+    depth: number;
+} | {
+    type: "icon-pack";
+    count: number;
+};
+interface MeshAsset extends GeneratedAsset {
+    readonly kind: "mesh";
+    readonly gltfPath: string;
+    readonly usdzPath?: string;
+    readonly objPath?: string;
+    readonly fbxPath?: string;
+    readonly previewImagePath: string;
+    readonly triangleCount: number;
+    readonly format: "gltf";
+}
+interface MeshHealth {
+    readonly provider: string;
+    readonly ok: boolean;
+    readonly suggestion?: string;
+}
+interface MeshPipelineOptions {
+    readonly root?: string;
+}
+declare function readMeshDebug(root?: string, limit?: number): Promise<unknown[]>;
+declare class MeshPipeline {
+    #private;
+    constructor(options?: MeshPipelineOptions);
+    fromText(description: string, brandInput: BrandContext | undefined): Promise<MeshAsset>;
+    fromImage(image: Pick<ImageAsset, "path">, brandInput: BrandContext | undefined): Promise<MeshAsset>;
+    batchFromIntent(intent: MeshIntent, brandInput: BrandContext | undefined): Promise<MeshAsset[]>;
+    preview(asset: MeshAsset): Promise<{
+        path: string;
+    }>;
+    export(asset: MeshAsset, format?: "gltf" | "obj" | "usdz" | "fbx"): Promise<{
+        path: string;
+    }>;
+    doctor(): Promise<MeshHealth[]>;
+}
+
+export { type MeshAsset, type MeshHealth, type MeshIntent, MeshPipeline, type MeshPipelineOptions, readMeshDebug };

package/dist/index.js

@@ -0,0 +1,9 @@
+import {
+  MeshPipeline,
+  readMeshDebug
+} from "./chunk-PGYUP7CZ.js";
+export {
+  MeshPipeline,
+  readMeshDebug
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/examples/export.ts

@@ -0,0 +1,7 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { MeshPipeline } from "../src/index";
+
+const pipeline = new MeshPipeline();
+const asset = await pipeline.fromText("a 3D debugging loop logo", createDemoBrandContext());
+
+process.stdout.write(`${JSON.stringify(await pipeline.export(asset, "gltf"), null, 2)}\n`);

package/examples/from-text.ts

@@ -0,0 +1,6 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { MeshPipeline } from "../src/index";
+
+const asset = await new MeshPipeline().fromText("a sleek robot mascot", createDemoBrandContext());
+
+process.stdout.write(`${asset.gltfPath}\n`);

package/examples/preview.ts

@@ -0,0 +1,7 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { MeshPipeline } from "../src/index";
+
+const pipeline = new MeshPipeline();
+const asset = await pipeline.fromText("product mockup", createDemoBrandContext());
+
+process.stdout.write(`${JSON.stringify(await pipeline.preview(asset), null, 2)}\n`);

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@nebutra/3d-pipeline",
+  "version": "0.1.0",
+  "description": "BrandContext-first mesh generation, export manifests, and previews",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "generation-capability",
+    "requires": [
+      "@nebutra/generation-context for BrandContext",
+      "@nebutra/image-pipeline for image-to-mesh inputs",
+      "@nebutra/sandbox-runtime for model and Blender sidecars"
+    ],
+    "gaps": [
+      "Model-backed mesh generation is adapter-gated",
+      "Retopology and UV workflows are deterministic manifest placeholders",
+      "Remote provider license checks are metadata-only"
+    ],
+    "featureId": "3d-pipeline",
+    "category": "ai",
+    "summary": "BrandContext-first mesh, preview, and export surface"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@nebutra/capability-kit": "0.2.0",
+    "@nebutra/errors": "0.1.0",
+    "@nebutra/generation-context": "0.1.0",
+    "@nebutra/image-pipeline": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
+  },
+  "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/3d-pipeline#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/3d-pipeline"
+  },
+  "bugs": {
+    "url": "https://github.com/Nebutra/Nebutra-Sailor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,28 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { MeshPipeline, readMeshDebug } from "./index";
+
+const command = process.argv[2] ?? "doctor";
+const pipeline = new MeshPipeline();
+
+if (command === "doctor") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
+  );
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", entries: await readMeshDebug() }, null, 2)}\n`,
+  );
+} else if (command === "preview") {
+  const asset = await pipeline.fromText("sleek debugging mascot", createDemoBrandContext());
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", preview: await pipeline.preview(asset) }, null, 2)}\n`,
+  );
+} else if (command === "export") {
+  const asset = await pipeline.fromText("sleek debugging mascot", createDemoBrandContext());
+  process.stdout.write(
+    `${JSON.stringify({ capability: "3d-pipeline", export: await pipeline.export(asset, "gltf") }, null, 2)}\n`,
+  );
+} else {
+  process.stderr.write(`Unknown 3d-pipeline command: ${command}\n`);
+  process.exitCode = 1;
+}

package/src/index.test.ts

@@ -0,0 +1,32 @@
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { afterEach, describe, expect, it } from "vitest";
+import { MeshPipeline, readMeshDebug } from "./index";
+
+let root: string | undefined;
+
+afterEach(async () => {
+  if (root) await rm(root, { recursive: true, force: true });
+  root = undefined;
+});
+
+describe("MeshPipeline", () => {
+  it("requires BrandContext", async () => {
+    await expect(new MeshPipeline().fromText("robot", undefined)).rejects.toMatchObject({
+      capability: "3d-pipeline",
+    });
+  });
+
+  it("writes a glTF asset and preview", async () => {
+    root = await mkdtemp(join(tmpdir(), "mesh-pipeline-"));
+    const asset = await new MeshPipeline({ root }).fromText(
+      "robot mascot",
+      createDemoBrandContext(),
+    );
+    expect(JSON.parse(await readFile(asset.gltfPath, "utf8")).asset.version).toBe("2.0");
+    expect(await readFile(asset.previewImagePath, "utf8")).toContain("<svg");
+    expect(await readMeshDebug(root)).toHaveLength(1);
+  });
+});

package/src/index.ts

@@ -0,0 +1,176 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
+import {
+  assetId,
+  type BrandContext,
+  type GeneratedAsset,
+  requireBrandContext,
+  summarizeBrandContext,
+} from "@nebutra/generation-context";
+import type { ImageAsset } from "@nebutra/image-pipeline";
+
+export type MeshIntent =
+  | { type: "product-mockup"; description: string }
+  | { type: "logo-extrusion"; depth: number }
+  | { type: "icon-pack"; count: number };
+
+export interface MeshAsset extends GeneratedAsset {
+  readonly kind: "mesh";
+  readonly gltfPath: string;
+  readonly usdzPath?: string;
+  readonly objPath?: string;
+  readonly fbxPath?: string;
+  readonly previewImagePath: string;
+  readonly triangleCount: number;
+  readonly format: "gltf";
+}
+
+export interface MeshHealth {
+  readonly provider: string;
+  readonly ok: boolean;
+  readonly suggestion?: string;
+}
+
+export interface MeshPipelineOptions {
+  readonly root?: string;
+}
+
+export async function readMeshDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
+  return readCapabilityDebug("3d-pipeline", { root, limit });
+}
+
+function gltfDocument(brand: BrandContext, intent: MeshIntent): Record<string, unknown> {
+  return {
+    asset: { version: "2.0", generator: "@nebutra/3d-pipeline deterministic mesh" },
+    scene: 0,
+    scenes: [{ nodes: [0] }],
+    nodes: [{ mesh: 0, name: `${brand.name} ${intent.type}` }],
+    meshes: [
+      {
+        primitives: [
+          {
+            attributes: { POSITION: 0 },
+            indices: 1,
+            material: 0,
+          },
+        ],
+      },
+    ],
+    materials: [{ name: brand.palette[0]?.name ?? "brand", pbrMetallicRoughness: {} }],
+    extras: { brand: summarizeBrandContext(brand), intent },
+  };
+}
+
+function previewSvg(brand: BrandContext, intent: MeshIntent): string {
+  const primary = brand.palette[0]?.hex ?? "#111111";
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="640" height="480">
+  <rect width="640" height="480" fill="${primary}"/>
+  <polygon points="320,72 520,360 120,360" fill="#ffffff" opacity="0.88"/>
+  <text x="64" y="430" fill="#ffffff" font-family="${brand.typography.body}" font-size="28">${brand.name} ${intent.type}</text>
+</svg>`;
+}
+
+export class MeshPipeline {
+  readonly #root: string;
+
+  constructor(options: MeshPipelineOptions = {}) {
+    this.#root = options.root ?? process.cwd();
+  }
+
+  async fromText(description: string, brandInput: BrandContext | undefined): Promise<MeshAsset> {
+    return this.#write({ type: "product-mockup", description }, brandInput);
+  }
+
+  async fromImage(
+    image: Pick<ImageAsset, "path">,
+    brandInput: BrandContext | undefined,
+  ): Promise<MeshAsset> {
+    return this.#write(
+      { type: "product-mockup", description: `image-to-mesh source ${image.path}` },
+      brandInput,
+    );
+  }
+
+  async batchFromIntent(
+    intent: MeshIntent,
+    brandInput: BrandContext | undefined,
+  ): Promise<MeshAsset[]> {
+    const count = intent.type === "icon-pack" ? Math.max(1, Math.min(intent.count, 10)) : 1;
+    const assets: MeshAsset[] = [];
+    for (let index = 0; index < count; index += 1) {
+      assets.push(await this.#write(intent, brandInput));
+    }
+    return assets;
+  }
+
+  async preview(asset: MeshAsset): Promise<{ path: string }> {
+    return { path: asset.previewImagePath };
+  }
+
+  async export(
+    asset: MeshAsset,
+    format: "gltf" | "obj" | "usdz" | "fbx" = "gltf",
+  ): Promise<{ path: string }> {
+    if (format === "gltf") return { path: asset.gltfPath };
+    const path = join(
+      this.#root,
+      ".nebutra",
+      "generated",
+      "3d-pipeline",
+      `${asset.id}.${format}.json`,
+    );
+    await writeFile(
+      path,
+      `${JSON.stringify({ source: asset.gltfPath, format }, null, 2)}\n`,
+      "utf8",
+    );
+    return { path };
+  }
+
+  async doctor(): Promise<MeshHealth[]> {
+    return [
+      { provider: "gltf-local", ok: true },
+      {
+        provider: "local-mesh-model",
+        ok: Boolean(process.env.MESH_LOCAL_MODEL_PATH),
+        suggestion: "Set MESH_LOCAL_MODEL_PATH to enable local mesh generation.",
+      },
+      {
+        provider: "remote-mesh",
+        ok: Boolean(process.env.MESH_REMOTE_API_KEY),
+        suggestion: "Set MESH_REMOTE_API_KEY to enable remote mesh fallback.",
+      },
+    ];
+  }
+
+  async #write(intent: MeshIntent, brandInput: BrandContext | undefined): Promise<MeshAsset> {
+    const brand = requireBrandContext(brandInput, "3d-pipeline");
+    const id = assetId("mesh", `${intent.type}_${brand.brandId}`);
+    const dir = join(this.#root, ".nebutra", "generated", "3d-pipeline");
+    const gltfPath = join(dir, `${id}.gltf`);
+    const previewImagePath = join(dir, `${id}.svg`);
+    await mkdir(dir, { recursive: true });
+    await writeFile(gltfPath, `${JSON.stringify(gltfDocument(brand, intent), null, 2)}\n`, "utf8");
+    await writeFile(previewImagePath, previewSvg(brand, intent), "utf8");
+
+    const asset: MeshAsset = {
+      id,
+      tenantId: brand.tenantId,
+      kind: "mesh",
+      path: gltfPath,
+      gltfPath,
+      previewImagePath,
+      brandId: brand.brandId,
+      provider: "gltf-local",
+      model: "brand-context-gltf-v1",
+      createdAt: new Date().toISOString(),
+      license: { status: "commercial-ok", source: "deterministic local mesh" },
+      triangleCount: 1,
+      format: "gltf",
+      metadata: { intent, brandSource: brand.sourcePath },
+    };
+    await appendCapabilityDebug("3d-pipeline", { type: "mesh", asset }, { root: this.#root });
+    return asset;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "target": "esnext",
+    "types": ["node"],
+    "incremental": false
+  },
+  "include": ["src", "examples"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts", "src/cli.ts"],
+  format: ["esm"],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  target: "es2022",
+  external: [
+    "@nebutra/capability-kit/debug",
+    "@nebutra/errors",
+    "@nebutra/generation-context",
+    "@nebutra/image-pipeline",
+  ],
+});