@nebutra/image-pipeline 0.1.0

package/README.md

@@ -0,0 +1,20 @@
+# @nebutra/image-pipeline
+
+Status: WIP — Not yet integrated into any production app.
+
+`@nebutra/image-pipeline` is the BrandContext-first image capability surface.
+It exposes logo, poster, hero image, icon, and workflow-shaped generation APIs.
+The zero-config path writes deterministic SVG assets so examples and tests have
+real files; model-backed generation is delegated to sidecar adapters.
+
+It does not own prompt orchestration, Thread/Turn/Item state, model provider
+routing, or user approval.
+
+## Commands
+
+```bash
+pnpm image:doctor
+pnpm image:debug
+pnpm image:warmup
+pnpm image:workflows
+```

package/dist/chunk-CYXB6GKX.js

@@ -0,0 +1,132 @@
+// src/index.ts
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
+import { CapabilityError } from "@nebutra/errors";
+import {
+  assetId,
+  requireBrandContext,
+  summarizeBrandContext
+} from "@nebutra/generation-context";
+async function readImageDebug(root = process.cwd(), limit = 10) {
+  return readCapabilityDebug("image-pipeline", { root, limit });
+}
+function intentLabel(intent) {
+  switch (intent.type) {
+    case "logo":
+      return `${intent.company}: ${intent.oneLiner}`;
+    case "poster":
+      return `${intent.title}${intent.subtitle ? ` \u2014 ${intent.subtitle}` : ""}`;
+    case "icon":
+      return intent.subject;
+    case "hero":
+      return intent.headline;
+    case "style-transfer":
+      return `${intent.sourcePath}: ${intent.instruction}`;
+  }
+}
+function escapeXml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+function svgFor(intent, brand) {
+  const primary = brand.palette[0]?.hex ?? "#111111";
+  const accent = brand.palette.find((color) => color.role === "accent")?.hex ?? "#F3C14B";
+  const label = intentLabel(intent);
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="800" viewBox="0 0 1200 800">
+  <rect width="1200" height="800" fill="${escapeXml(primary)}"/>
+  <circle cx="960" cy="160" r="96" fill="${escapeXml(accent)}" opacity="0.9"/>
+  <text x="80" y="360" fill="#ffffff" font-family="${escapeXml(brand.typography.heading)}" font-size="78" font-weight="700">${escapeXml(brand.name)}</text>
+  <text x="84" y="440" fill="#ffffff" font-family="${escapeXml(brand.typography.body)}" font-size="34">${escapeXml(label)}</text>
+  <text x="84" y="520" fill="#ffffff" opacity="0.72" font-family="${escapeXml(brand.typography.body)}" font-size="24">${escapeXml(summarizeBrandContext(brand))}</text>
+</svg>`;
+}
+var ImagePipeline = class {
+  #root;
+  #provider;
+  #comfyUrl;
+  constructor(options = {}) {
+    this.#root = options.root ?? process.cwd();
+    this.#provider = options.provider ?? "svg-local";
+    this.#comfyUrl = options.comfyUrl ?? process.env.COMFYUI_URL ?? "http://127.0.0.1:8188";
+  }
+  async generate(intent, brandInput) {
+    const brand = requireBrandContext(brandInput, "image-pipeline");
+    if (this.#provider !== "svg-local") {
+      throw new CapabilityError("image-pipeline", `${this.#provider} provider is not configured`, {
+        suggestion: "Use the zero-config svg-local provider or configure a sidecar adapter before selecting model-backed image generation.",
+        statusCode: 503
+      });
+    }
+    const id = assetId("image", `${intent.type}_${intentLabel(intent)}`);
+    const path = join(this.#root, ".nebutra", "generated", "image-pipeline", `${id}.svg`);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, svgFor(intent, brand), "utf8");
+    const asset = {
+      id,
+      tenantId: brand.tenantId,
+      kind: "image",
+      path,
+      brandId: brand.brandId,
+      provider: "svg-local",
+      model: "brand-context-svg-v1",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      license: { status: "commercial-ok", source: "deterministic local renderer" },
+      width: 1200,
+      height: 800,
+      format: "svg",
+      metadata: { intent, brandSource: brand.sourcePath }
+    };
+    await appendCapabilityDebug(
+      "image-pipeline",
+      { type: "generate", asset },
+      { root: this.#root }
+    );
+    return asset;
+  }
+  async runWorkflow(workflowName, inputs, brand) {
+    requireBrandContext(brand, "image-pipeline");
+    return this.generate(
+      {
+        type: "poster",
+        title: workflowName,
+        subtitle: Object.keys(inputs).join(", ") || "workflow"
+      },
+      brand
+    );
+  }
+  async doctor() {
+    const comfyConfigured = Boolean(process.env.COMFYUI_URL);
+    return [
+      { provider: "svg-local", ok: true },
+      comfyConfigured ? { provider: "comfy", ok: true } : {
+        provider: "comfy",
+        ok: false,
+        suggestion: `Set COMFYUI_URL to enable model-backed workflow execution. Default probe target is ${this.#comfyUrl}.`
+      },
+      {
+        provider: "remote",
+        ok: Boolean(process.env.IMAGE_REMOTE_API_KEY),
+        suggestion: "Set IMAGE_REMOTE_API_KEY to enable remote image fallback."
+      }
+    ];
+  }
+  async workflows() {
+    return ["logo", "poster", "icon", "hero", "style-transfer"];
+  }
+  async warmup() {
+    if (this.#provider === "svg-local") {
+      return { provider: this.#provider, ok: true };
+    }
+    return {
+      provider: this.#provider,
+      ok: false,
+      suggestion: "Start the image sidecar before warming model weights."
+    };
+  }
+};
+
+export {
+  readImageDebug,
+  ImagePipeline
+};
+//# sourceMappingURL=chunk-CYXB6GKX.js.map

package/dist/chunk-CYXB6GKX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { appendCapabilityDebug, readCapabilityDebug } from \"@nebutra/capability-kit/debug\";\nimport { CapabilityError } from \"@nebutra/errors\";\nimport {\n  assetId,\n  type BrandContext,\n  type GeneratedAsset,\n  requireBrandContext,\n  summarizeBrandContext,\n} from \"@nebutra/generation-context\";\n\nexport type ImageIntent =\n  | { type: \"logo\"; company: string; oneLiner: string }\n  | { type: \"poster\"; title: string; subtitle?: string }\n  | { type: \"icon\"; subject: string }\n  | { type: \"hero\"; headline: string }\n  | { type: \"style-transfer\"; sourcePath: string; instruction: string };\n\nexport interface ImageAsset extends GeneratedAsset {\n  readonly kind: \"image\";\n  readonly width: number;\n  readonly height: number;\n  readonly format: \"svg\" | \"png\" | \"jpg\" | \"webp\";\n}\n\nexport interface ImageHealth {\n  readonly provider: string;\n  readonly ok: boolean;\n  readonly suggestion?: string;\n}\n\nexport interface ImagePipelineOptions {\n  readonly root?: string;\n  readonly provider?: \"svg-local\" | \"comfy\" | \"remote\";\n  readonly comfyUrl?: string;\n}\n\nexport async function readImageDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {\n  return readCapabilityDebug(\"image-pipeline\", { root, limit });\n}\n\nfunction intentLabel(intent: ImageIntent): string {\n  switch (intent.type) {\n    case \"logo\":\n      return `${intent.company}: ${intent.oneLiner}`;\n    case \"poster\":\n      return `${intent.title}${intent.subtitle ? ` — ${intent.subtitle}` : \"\"}`;\n    case \"icon\":\n      return intent.subject;\n    case \"hero\":\n      return intent.headline;\n    case \"style-transfer\":\n      return `${intent.sourcePath}: ${intent.instruction}`;\n  }\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\");\n}\n\nfunction svgFor(intent: ImageIntent, brand: BrandContext): string {\n  const primary = brand.palette[0]?.hex ?? \"#111111\";\n  const accent = brand.palette.find((color) => color.role === \"accent\")?.hex ?? \"#F3C14B\";\n  const label = intentLabel(intent);\n  return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1200\" height=\"800\" viewBox=\"0 0 1200 800\">\n  <rect width=\"1200\" height=\"800\" fill=\"${escapeXml(primary)}\"/>\n  <circle cx=\"960\" cy=\"160\" r=\"96\" fill=\"${escapeXml(accent)}\" opacity=\"0.9\"/>\n  <text x=\"80\" y=\"360\" fill=\"#ffffff\" font-family=\"${escapeXml(brand.typography.heading)}\" font-size=\"78\" font-weight=\"700\">${escapeXml(brand.name)}</text>\n  <text x=\"84\" y=\"440\" fill=\"#ffffff\" font-family=\"${escapeXml(brand.typography.body)}\" font-size=\"34\">${escapeXml(label)}</text>\n  <text x=\"84\" y=\"520\" fill=\"#ffffff\" opacity=\"0.72\" font-family=\"${escapeXml(brand.typography.body)}\" font-size=\"24\">${escapeXml(summarizeBrandContext(brand))}</text>\n</svg>`;\n}\n\nexport class ImagePipeline {\n  readonly #root: string;\n  readonly #provider: \"svg-local\" | \"comfy\" | \"remote\";\n  readonly #comfyUrl: string;\n\n  constructor(options: ImagePipelineOptions = {}) {\n    this.#root = options.root ?? process.cwd();\n    this.#provider = options.provider ?? \"svg-local\";\n    this.#comfyUrl = options.comfyUrl ?? process.env.COMFYUI_URL ?? \"http://127.0.0.1:8188\";\n  }\n\n  async generate(intent: ImageIntent, brandInput: BrandContext | undefined): Promise<ImageAsset> {\n    const brand = requireBrandContext(brandInput, \"image-pipeline\");\n    if (this.#provider !== \"svg-local\") {\n      throw new CapabilityError(\"image-pipeline\", `${this.#provider} provider is not configured`, {\n        suggestion:\n          \"Use the zero-config svg-local provider or configure a sidecar adapter before selecting model-backed image generation.\",\n        statusCode: 503,\n      });\n    }\n\n    const id = assetId(\"image\", `${intent.type}_${intentLabel(intent)}`);\n    const path = join(this.#root, \".nebutra\", \"generated\", \"image-pipeline\", `${id}.svg`);\n    await mkdir(dirname(path), { recursive: true });\n    await writeFile(path, svgFor(intent, brand), \"utf8\");\n\n    const asset: ImageAsset = {\n      id,\n      tenantId: brand.tenantId,\n      kind: \"image\",\n      path,\n      brandId: brand.brandId,\n      provider: \"svg-local\",\n      model: \"brand-context-svg-v1\",\n      createdAt: new Date().toISOString(),\n      license: { status: \"commercial-ok\", source: \"deterministic local renderer\" },\n      width: 1200,\n      height: 800,\n      format: \"svg\",\n      metadata: { intent, brandSource: brand.sourcePath },\n    };\n    await appendCapabilityDebug(\n      \"image-pipeline\",\n      { type: \"generate\", asset },\n      { root: this.#root },\n    );\n    return asset;\n  }\n\n  async runWorkflow(\n    workflowName: string,\n    inputs: Record<string, unknown>,\n    brand: BrandContext | undefined,\n  ): Promise<ImageAsset> {\n    requireBrandContext(brand, \"image-pipeline\");\n    return this.generate(\n      {\n        type: \"poster\",\n        title: workflowName,\n        subtitle: Object.keys(inputs).join(\", \") || \"workflow\",\n      },\n      brand,\n    );\n  }\n\n  async doctor(): Promise<ImageHealth[]> {\n    const comfyConfigured = Boolean(process.env.COMFYUI_URL);\n    return [\n      { provider: \"svg-local\", ok: true },\n      comfyConfigured\n        ? { provider: \"comfy\", ok: true }\n        : {\n            provider: \"comfy\",\n            ok: false,\n            suggestion: `Set COMFYUI_URL to enable model-backed workflow execution. Default probe target is ${this.#comfyUrl}.`,\n          },\n      {\n        provider: \"remote\",\n        ok: Boolean(process.env.IMAGE_REMOTE_API_KEY),\n        suggestion: \"Set IMAGE_REMOTE_API_KEY to enable remote image fallback.\",\n      },\n    ];\n  }\n\n  async workflows(): Promise<readonly string[]> {\n    return [\"logo\", \"poster\", \"icon\", \"hero\", \"style-transfer\"];\n  }\n\n  async warmup(): Promise<ImageHealth> {\n    if (this.#provider === \"svg-local\") {\n      return { provider: this.#provider, ok: true };\n    }\n    return {\n      provider: this.#provider,\n      ok: false,\n      suggestion: \"Start the image sidecar before warming model weights.\",\n    };\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,42 @@
+import {
+  ImagePipeline,
+  readImageDebug
+} from "./chunk-CYXB6GKX.js";
+
+// src/cli.ts
+import { createDemoBrandContext } from "@nebutra/generation-context";
+var command = process.argv[2] ?? "doctor";
+var pipeline = new ImagePipeline();
+if (command === "doctor") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", results: await pipeline.doctor() }, null, 2)}
+`
+  );
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", entries: await readImageDebug() }, null, 2)}
+`
+  );
+} else if (command === "warmup") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", result: await pipeline.warmup() }, null, 2)}
+`
+  );
+} else if (command === "workflows") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", workflows: await pipeline.workflows() }, null, 2)}
+`
+  );
+} else if (command === "quickstart") {
+  const asset = await pipeline.generate(
+    { type: "logo", company: "Loop", oneLiner: "AI debugging for indie devs" },
+    createDemoBrandContext()
+  );
+  process.stdout.write(`${JSON.stringify({ capability: "image-pipeline", asset }, null, 2)}
+`);
+} else {
+  process.stderr.write(`Unknown image-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 { ImagePipeline, readImageDebug } from \"./index\";\n\nconst command = process.argv[2] ?? \"doctor\";\nconst pipeline = new ImagePipeline();\n\nif (command === \"doctor\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"image-pipeline\", results: await pipeline.doctor() }, null, 2)}\\n`,\n  );\n} else if (command === \"debug\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"image-pipeline\", entries: await readImageDebug() }, null, 2)}\\n`,\n  );\n} else if (command === \"warmup\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"image-pipeline\", result: await pipeline.warmup() }, null, 2)}\\n`,\n  );\n} else if (command === \"workflows\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"image-pipeline\", workflows: await pipeline.workflows() }, null, 2)}\\n`,\n  );\n} else if (command === \"quickstart\") {\n  const asset = await pipeline.generate(\n    { type: \"logo\", company: \"Loop\", oneLiner: \"AI debugging for indie devs\" },\n    createDemoBrandContext(),\n  );\n  process.stdout.write(`${JSON.stringify({ capability: \"image-pipeline\", asset }, null, 2)}\\n`);\n} else {\n  process.stderr.write(`Unknown image-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,cAAc;AAEnC,IAAI,YAAY,UAAU;AACxB,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,kBAAkB,SAAS,MAAM,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAChG;AACF,WAAW,YAAY,SAAS;AAC9B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,kBAAkB,SAAS,MAAM,eAAe,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC/F;AACF,WAAW,YAAY,UAAU;AAC/B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,kBAAkB,QAAQ,MAAM,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC/F;AACF,WAAW,YAAY,aAAa;AAClC,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,kBAAkB,WAAW,MAAM,SAAS,UAAU,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EACrG;AACF,WAAW,YAAY,cAAc;AACnC,QAAM,QAAQ,MAAM,SAAS;AAAA,IAC3B,EAAE,MAAM,QAAQ,SAAS,QAAQ,UAAU,8BAA8B;AAAA,IACzE,uBAAuB;AAAA,EACzB;AACA,UAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,EAAE,YAAY,kBAAkB,MAAM,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAC9F,OAAO;AACL,UAAQ,OAAO,MAAM,mCAAmC,OAAO;AAAA,CAAI;AACnE,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { GeneratedAsset, BrandContext } from '@nebutra/generation-context';
+
+type ImageIntent = {
+    type: "logo";
+    company: string;
+    oneLiner: string;
+} | {
+    type: "poster";
+    title: string;
+    subtitle?: string;
+} | {
+    type: "icon";
+    subject: string;
+} | {
+    type: "hero";
+    headline: string;
+} | {
+    type: "style-transfer";
+    sourcePath: string;
+    instruction: string;
+};
+interface ImageAsset extends GeneratedAsset {
+    readonly kind: "image";
+    readonly width: number;
+    readonly height: number;
+    readonly format: "svg" | "png" | "jpg" | "webp";
+}
+interface ImageHealth {
+    readonly provider: string;
+    readonly ok: boolean;
+    readonly suggestion?: string;
+}
+interface ImagePipelineOptions {
+    readonly root?: string;
+    readonly provider?: "svg-local" | "comfy" | "remote";
+    readonly comfyUrl?: string;
+}
+declare function readImageDebug(root?: string, limit?: number): Promise<unknown[]>;
+declare class ImagePipeline {
+    #private;
+    constructor(options?: ImagePipelineOptions);
+    generate(intent: ImageIntent, brandInput: BrandContext | undefined): Promise<ImageAsset>;
+    runWorkflow(workflowName: string, inputs: Record<string, unknown>, brand: BrandContext | undefined): Promise<ImageAsset>;
+    doctor(): Promise<ImageHealth[]>;
+    workflows(): Promise<readonly string[]>;
+    warmup(): Promise<ImageHealth>;
+}
+
+export { type ImageAsset, type ImageHealth, type ImageIntent, ImagePipeline, type ImagePipelineOptions, readImageDebug };

package/dist/index.js

@@ -0,0 +1,9 @@
+import {
+  ImagePipeline,
+  readImageDebug
+} from "./chunk-CYXB6GKX.js";
+export {
+  ImagePipeline,
+  readImageDebug
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/examples/logo.ts

@@ -0,0 +1,9 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { ImagePipeline } from "../src/index";
+
+const asset = await new ImagePipeline().generate(
+  { type: "logo", company: "Loop", oneLiner: "AI debugging for indie devs" },
+  createDemoBrandContext(),
+);
+
+process.stdout.write(`${asset.path}\n`);

package/examples/poster.ts

@@ -0,0 +1,9 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { ImagePipeline } from "../src/index";
+
+const asset = await new ImagePipeline().generate(
+  { type: "poster", title: "Ship with context", subtitle: "A founder operating system" },
+  createDemoBrandContext(),
+);
+
+process.stdout.write(`${asset.path}\n`);

package/examples/workflow.ts

@@ -0,0 +1,10 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { ImagePipeline } from "../src/index";
+
+const asset = await new ImagePipeline().runWorkflow(
+  "hero",
+  { headline: "Debug the loop" },
+  createDemoBrandContext(),
+);
+
+process.stdout.write(`${asset.path}\n`);

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@nebutra/image-pipeline",
+  "version": "0.1.0",
+  "description": "BrandContext-first image generation and workflow routing surface",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "generation-capability",
+    "requires": [
+      "@nebutra/generation-context for BrandContext",
+      "@nebutra/sandbox-runtime for local generation sidecars"
+    ],
+    "gaps": [
+      "Comfy sidecar lifecycle is health-checked but not launched by this package",
+      "Remote image providers are adapter ports only",
+      "Workflow templates are deterministic SVG fallbacks until model nodes are installed"
+    ],
+    "featureId": "image-pipeline",
+    "category": "ai",
+    "summary": "BrandContext-first image/logo/poster/icon generation 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"
+  },
+  "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/image-pipeline#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/image-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,32 @@
+import { createDemoBrandContext } from "@nebutra/generation-context";
+import { ImagePipeline, readImageDebug } from "./index";
+
+const command = process.argv[2] ?? "doctor";
+const pipeline = new ImagePipeline();
+
+if (command === "doctor") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
+  );
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", entries: await readImageDebug() }, null, 2)}\n`,
+  );
+} else if (command === "warmup") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", result: await pipeline.warmup() }, null, 2)}\n`,
+  );
+} else if (command === "workflows") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "image-pipeline", workflows: await pipeline.workflows() }, null, 2)}\n`,
+  );
+} else if (command === "quickstart") {
+  const asset = await pipeline.generate(
+    { type: "logo", company: "Loop", oneLiner: "AI debugging for indie devs" },
+    createDemoBrandContext(),
+  );
+  process.stdout.write(`${JSON.stringify({ capability: "image-pipeline", asset }, null, 2)}\n`);
+} else {
+  process.stderr.write(`Unknown image-pipeline command: ${command}\n`);
+  process.exitCode = 1;
+}

package/src/index.test.ts

@@ -0,0 +1,33 @@
+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 { ImagePipeline, readImageDebug } from "./index";
+
+let root: string | undefined;
+
+afterEach(async () => {
+  if (root) await rm(root, { recursive: true, force: true });
+  root = undefined;
+});
+
+describe("ImagePipeline", () => {
+  it("requires BrandContext", async () => {
+    const pipeline = new ImagePipeline();
+    await expect(
+      pipeline.generate({ type: "icon", subject: "debugger" }, undefined),
+    ).rejects.toMatchObject({ capability: "image-pipeline", suggestion: expect.any(String) });
+  });
+
+  it("writes a deterministic SVG asset with brand metadata", async () => {
+    root = await mkdtemp(join(tmpdir(), "image-pipeline-"));
+    const asset = await new ImagePipeline({ root }).generate(
+      { type: "logo", company: "Loop", oneLiner: "AI debugging" },
+      createDemoBrandContext(),
+    );
+    expect(asset.format).toBe("svg");
+    expect(await readFile(asset.path, "utf8")).toContain("Loop");
+    expect(await readImageDebug(root)).toHaveLength(1);
+  });
+});

package/src/index.ts

@@ -0,0 +1,177 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
+import { CapabilityError } from "@nebutra/errors";
+import {
+  assetId,
+  type BrandContext,
+  type GeneratedAsset,
+  requireBrandContext,
+  summarizeBrandContext,
+} from "@nebutra/generation-context";
+
+export type ImageIntent =
+  | { type: "logo"; company: string; oneLiner: string }
+  | { type: "poster"; title: string; subtitle?: string }
+  | { type: "icon"; subject: string }
+  | { type: "hero"; headline: string }
+  | { type: "style-transfer"; sourcePath: string; instruction: string };
+
+export interface ImageAsset extends GeneratedAsset {
+  readonly kind: "image";
+  readonly width: number;
+  readonly height: number;
+  readonly format: "svg" | "png" | "jpg" | "webp";
+}
+
+export interface ImageHealth {
+  readonly provider: string;
+  readonly ok: boolean;
+  readonly suggestion?: string;
+}
+
+export interface ImagePipelineOptions {
+  readonly root?: string;
+  readonly provider?: "svg-local" | "comfy" | "remote";
+  readonly comfyUrl?: string;
+}
+
+export async function readImageDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
+  return readCapabilityDebug("image-pipeline", { root, limit });
+}
+
+function intentLabel(intent: ImageIntent): string {
+  switch (intent.type) {
+    case "logo":
+      return `${intent.company}: ${intent.oneLiner}`;
+    case "poster":
+      return `${intent.title}${intent.subtitle ? ` — ${intent.subtitle}` : ""}`;
+    case "icon":
+      return intent.subject;
+    case "hero":
+      return intent.headline;
+    case "style-transfer":
+      return `${intent.sourcePath}: ${intent.instruction}`;
+  }
+}
+
+function escapeXml(value: string): string {
+  return value
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+}
+
+function svgFor(intent: ImageIntent, brand: BrandContext): string {
+  const primary = brand.palette[0]?.hex ?? "#111111";
+  const accent = brand.palette.find((color) => color.role === "accent")?.hex ?? "#F3C14B";
+  const label = intentLabel(intent);
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="800" viewBox="0 0 1200 800">
+  <rect width="1200" height="800" fill="${escapeXml(primary)}"/>
+  <circle cx="960" cy="160" r="96" fill="${escapeXml(accent)}" opacity="0.9"/>
+  <text x="80" y="360" fill="#ffffff" font-family="${escapeXml(brand.typography.heading)}" font-size="78" font-weight="700">${escapeXml(brand.name)}</text>
+  <text x="84" y="440" fill="#ffffff" font-family="${escapeXml(brand.typography.body)}" font-size="34">${escapeXml(label)}</text>
+  <text x="84" y="520" fill="#ffffff" opacity="0.72" font-family="${escapeXml(brand.typography.body)}" font-size="24">${escapeXml(summarizeBrandContext(brand))}</text>
+</svg>`;
+}
+
+export class ImagePipeline {
+  readonly #root: string;
+  readonly #provider: "svg-local" | "comfy" | "remote";
+  readonly #comfyUrl: string;
+
+  constructor(options: ImagePipelineOptions = {}) {
+    this.#root = options.root ?? process.cwd();
+    this.#provider = options.provider ?? "svg-local";
+    this.#comfyUrl = options.comfyUrl ?? process.env.COMFYUI_URL ?? "http://127.0.0.1:8188";
+  }
+
+  async generate(intent: ImageIntent, brandInput: BrandContext | undefined): Promise<ImageAsset> {
+    const brand = requireBrandContext(brandInput, "image-pipeline");
+    if (this.#provider !== "svg-local") {
+      throw new CapabilityError("image-pipeline", `${this.#provider} provider is not configured`, {
+        suggestion:
+          "Use the zero-config svg-local provider or configure a sidecar adapter before selecting model-backed image generation.",
+        statusCode: 503,
+      });
+    }
+
+    const id = assetId("image", `${intent.type}_${intentLabel(intent)}`);
+    const path = join(this.#root, ".nebutra", "generated", "image-pipeline", `${id}.svg`);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, svgFor(intent, brand), "utf8");
+
+    const asset: ImageAsset = {
+      id,
+      tenantId: brand.tenantId,
+      kind: "image",
+      path,
+      brandId: brand.brandId,
+      provider: "svg-local",
+      model: "brand-context-svg-v1",
+      createdAt: new Date().toISOString(),
+      license: { status: "commercial-ok", source: "deterministic local renderer" },
+      width: 1200,
+      height: 800,
+      format: "svg",
+      metadata: { intent, brandSource: brand.sourcePath },
+    };
+    await appendCapabilityDebug(
+      "image-pipeline",
+      { type: "generate", asset },
+      { root: this.#root },
+    );
+    return asset;
+  }
+
+  async runWorkflow(
+    workflowName: string,
+    inputs: Record<string, unknown>,
+    brand: BrandContext | undefined,
+  ): Promise<ImageAsset> {
+    requireBrandContext(brand, "image-pipeline");
+    return this.generate(
+      {
+        type: "poster",
+        title: workflowName,
+        subtitle: Object.keys(inputs).join(", ") || "workflow",
+      },
+      brand,
+    );
+  }
+
+  async doctor(): Promise<ImageHealth[]> {
+    const comfyConfigured = Boolean(process.env.COMFYUI_URL);
+    return [
+      { provider: "svg-local", ok: true },
+      comfyConfigured
+        ? { provider: "comfy", ok: true }
+        : {
+            provider: "comfy",
+            ok: false,
+            suggestion: `Set COMFYUI_URL to enable model-backed workflow execution. Default probe target is ${this.#comfyUrl}.`,
+          },
+      {
+        provider: "remote",
+        ok: Boolean(process.env.IMAGE_REMOTE_API_KEY),
+        suggestion: "Set IMAGE_REMOTE_API_KEY to enable remote image fallback.",
+      },
+    ];
+  }
+
+  async workflows(): Promise<readonly string[]> {
+    return ["logo", "poster", "icon", "hero", "style-transfer"];
+  }
+
+  async warmup(): Promise<ImageHealth> {
+    if (this.#provider === "svg-local") {
+      return { provider: this.#provider, ok: true };
+    }
+    return {
+      provider: this.#provider,
+      ok: false,
+      suggestion: "Start the image sidecar before warming model weights.",
+    };
+  }
+}

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,11 @@
+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"],
+});