@contractspec/lib.content-gen 1.57.0 → 1.59.0

package/dist/browser/generators/blog.js

@@ -0,0 +1,88 @@
+// src/generators/blog.ts
+class BlogGenerator {
+  llm;
+  model;
+  temperature;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+    this.temperature = options?.temperature ?? 0.4;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateDeterministic(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateDeterministic(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "You are a product marketing writer. Produce JSON with title, subtitle, intro, sections[].heading/body/bullets, outro."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ brief })
+          }
+        ]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.temperature
+    });
+    const jsonPart = response.message.content.find((part) => ("text" in part));
+    if (jsonPart && "text" in jsonPart) {
+      return JSON.parse(jsonPart.text);
+    }
+    return this.generateDeterministic(brief);
+  }
+  generateDeterministic(brief) {
+    const intro = `Operators like ${brief.audience.role} teams face ${brief.problems.slice(0, 2).join(" and ")}. ${brief.title} changes that by ${brief.summary}.`;
+    const sections = [
+      {
+        heading: "Why now",
+        body: this.renderWhyNow(brief)
+      },
+      {
+        heading: "What you get",
+        body: "A focused stack built for policy-safe automation.",
+        bullets: brief.solutions
+      },
+      {
+        heading: "Proof it works",
+        body: "Teams using the blueprint report measurable wins.",
+        bullets: brief.metrics ?? [
+          "Launch workflows in minutes",
+          "Cut review time by 60%"
+        ]
+      }
+    ];
+    return {
+      title: brief.title,
+      subtitle: brief.summary,
+      intro,
+      sections,
+      outro: brief.callToAction ?? "Ready to see it live? Spin up a sandbox in under 5 minutes."
+    };
+  }
+  renderWhyNow(brief) {
+    const audience = `${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}`;
+    const pains = brief.problems.slice(0, 2).join("; ");
+    return `${audience} teams are stuck with ${pains}. ${brief.title} delivers guardrails without slowing shipping.`;
+  }
+}
+export {
+  BlogGenerator
+};

package/dist/browser/generators/email.js

@@ -0,0 +1,111 @@
+// src/generators/email.ts
+class EmailCampaignGenerator {
+  llm;
+  model;
+  temperature;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+    this.temperature = options?.temperature ?? 0.6;
+  }
+  async generate(input) {
+    if (this.llm) {
+      const draft = await this.generateWithLlm(input);
+      if (draft)
+        return draft;
+    }
+    return this.generateFallback(input);
+  }
+  async generateWithLlm(input) {
+    if (!this.llm)
+      return null;
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Draft product marketing email as JSON {subject, previewText, body, cta}."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify(input) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.temperature
+    });
+    const jsonPart = response.message.content.find((chunk) => ("text" in chunk));
+    if (!jsonPart || !("text" in jsonPart))
+      return null;
+    const parsed = JSON.parse(jsonPart.text);
+    if (!parsed.subject || !parsed.body || !parsed.cta)
+      return null;
+    return {
+      subject: parsed.subject,
+      previewText: parsed.previewText ?? this.defaultPreview(input),
+      body: parsed.body,
+      cta: parsed.cta,
+      variant: input.variant
+    };
+  }
+  generateFallback(input) {
+    const { brief, variant } = input;
+    const subject = this.subjects(brief.title, variant)[0] ?? `${brief.title} update`;
+    const previewText = this.defaultPreview(input);
+    const body = this.renderBody(input);
+    const cta = brief.callToAction ?? "Explore the sandbox";
+    return { subject, previewText, body, cta, variant };
+  }
+  subjects(title, variant) {
+    switch (variant) {
+      case "announcement":
+        return [`Launch: ${title}`, `${title} is live`, `New: ${title}`];
+      case "onboarding":
+        return [`Get started with ${title}`, `Your ${title} guide`];
+      case "nurture":
+      default:
+        return [`How ${title} speeds ops`, `Proof ${title} works`];
+    }
+  }
+  defaultPreview(input) {
+    const win = input.brief.metrics?.[0] ?? "ship faster without policy gaps";
+    return `See how teams ${win}.`;
+  }
+  renderBody(input) {
+    const { brief, variant } = input;
+    const greeting = "Hi there,";
+    const hook = this.variantHook(variant, brief);
+    const proof = brief.metrics?.map((metric) => `• ${metric}`).join(`
+`) ?? "";
+    return `${greeting}
+
+${hook}
+
+Top reasons teams adopt ${brief.title}:
+${brief.solutions.map((solution) => `• ${solution}`).join(`
+`)}
+
+${proof}
+
+${brief.callToAction ?? "Spin up a sandbox"} → ${(input.cadenceDay ?? 0) + 1}
+`;
+  }
+  variantHook(variant, brief) {
+    switch (variant) {
+      case "announcement":
+        return `${brief.title} is live. ${brief.summary}`;
+      case "onboarding":
+        return `Here is your next step to unlock ${brief.title}.`;
+      case "nurture":
+      default:
+        return `Operators like ${brief.audience.role} keep asking how to automate policy checks. Here is what works.`;
+    }
+  }
+}
+export {
+  EmailCampaignGenerator
+};

package/dist/browser/generators/index.js

@@ -0,0 +1,367 @@
+// src/generators/blog.ts
+class BlogGenerator {
+  llm;
+  model;
+  temperature;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+    this.temperature = options?.temperature ?? 0.4;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateDeterministic(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateDeterministic(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "You are a product marketing writer. Produce JSON with title, subtitle, intro, sections[].heading/body/bullets, outro."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ brief })
+          }
+        ]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.temperature
+    });
+    const jsonPart = response.message.content.find((part) => ("text" in part));
+    if (jsonPart && "text" in jsonPart) {
+      return JSON.parse(jsonPart.text);
+    }
+    return this.generateDeterministic(brief);
+  }
+  generateDeterministic(brief) {
+    const intro = `Operators like ${brief.audience.role} teams face ${brief.problems.slice(0, 2).join(" and ")}. ${brief.title} changes that by ${brief.summary}.`;
+    const sections = [
+      {
+        heading: "Why now",
+        body: this.renderWhyNow(brief)
+      },
+      {
+        heading: "What you get",
+        body: "A focused stack built for policy-safe automation.",
+        bullets: brief.solutions
+      },
+      {
+        heading: "Proof it works",
+        body: "Teams using the blueprint report measurable wins.",
+        bullets: brief.metrics ?? [
+          "Launch workflows in minutes",
+          "Cut review time by 60%"
+        ]
+      }
+    ];
+    return {
+      title: brief.title,
+      subtitle: brief.summary,
+      intro,
+      sections,
+      outro: brief.callToAction ?? "Ready to see it live? Spin up a sandbox in under 5 minutes."
+    };
+  }
+  renderWhyNow(brief) {
+    const audience = `${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}`;
+    const pains = brief.problems.slice(0, 2).join("; ");
+    return `${audience} teams are stuck with ${pains}. ${brief.title} delivers guardrails without slowing shipping.`;
+  }
+}
+
+// src/generators/email.ts
+class EmailCampaignGenerator {
+  llm;
+  model;
+  temperature;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+    this.temperature = options?.temperature ?? 0.6;
+  }
+  async generate(input) {
+    if (this.llm) {
+      const draft = await this.generateWithLlm(input);
+      if (draft)
+        return draft;
+    }
+    return this.generateFallback(input);
+  }
+  async generateWithLlm(input) {
+    if (!this.llm)
+      return null;
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Draft product marketing email as JSON {subject, previewText, body, cta}."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify(input) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.temperature
+    });
+    const jsonPart = response.message.content.find((chunk) => ("text" in chunk));
+    if (!jsonPart || !("text" in jsonPart))
+      return null;
+    const parsed = JSON.parse(jsonPart.text);
+    if (!parsed.subject || !parsed.body || !parsed.cta)
+      return null;
+    return {
+      subject: parsed.subject,
+      previewText: parsed.previewText ?? this.defaultPreview(input),
+      body: parsed.body,
+      cta: parsed.cta,
+      variant: input.variant
+    };
+  }
+  generateFallback(input) {
+    const { brief, variant } = input;
+    const subject = this.subjects(brief.title, variant)[0] ?? `${brief.title} update`;
+    const previewText = this.defaultPreview(input);
+    const body = this.renderBody(input);
+    const cta = brief.callToAction ?? "Explore the sandbox";
+    return { subject, previewText, body, cta, variant };
+  }
+  subjects(title, variant) {
+    switch (variant) {
+      case "announcement":
+        return [`Launch: ${title}`, `${title} is live`, `New: ${title}`];
+      case "onboarding":
+        return [`Get started with ${title}`, `Your ${title} guide`];
+      case "nurture":
+      default:
+        return [`How ${title} speeds ops`, `Proof ${title} works`];
+    }
+  }
+  defaultPreview(input) {
+    const win = input.brief.metrics?.[0] ?? "ship faster without policy gaps";
+    return `See how teams ${win}.`;
+  }
+  renderBody(input) {
+    const { brief, variant } = input;
+    const greeting = "Hi there,";
+    const hook = this.variantHook(variant, brief);
+    const proof = brief.metrics?.map((metric) => `• ${metric}`).join(`
+`) ?? "";
+    return `${greeting}
+
+${hook}
+
+Top reasons teams adopt ${brief.title}:
+${brief.solutions.map((solution) => `• ${solution}`).join(`
+`)}
+
+${proof}
+
+${brief.callToAction ?? "Spin up a sandbox"} → ${(input.cadenceDay ?? 0) + 1}
+`;
+  }
+  variantHook(variant, brief) {
+    switch (variant) {
+      case "announcement":
+        return `${brief.title} is live. ${brief.summary}`;
+      case "onboarding":
+        return `Here is your next step to unlock ${brief.title}.`;
+      case "nurture":
+      default:
+        return `Operators like ${brief.audience.role} keep asking how to automate policy checks. Here is what works.`;
+    }
+  }
+}
+
+// src/generators/landing-page.ts
+class LandingPageGenerator {
+  options;
+  llm;
+  model;
+  constructor(options) {
+    this.options = options;
+    this.llm = options?.llm;
+    this.model = options?.model;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateFallback(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateFallback(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Write JSON landing page copy with hero/highlights/socialProof/faq arrays."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify({ brief }) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.options?.temperature ?? 0.5
+    });
+    const part = response.message.content.find((chunk) => ("text" in chunk));
+    if (part && "text" in part) {
+      return JSON.parse(part.text);
+    }
+    return this.generateFallback(brief);
+  }
+  generateFallback(brief) {
+    return {
+      hero: {
+        eyebrow: `${brief.audience.industry ?? "Operations"} teams`,
+        title: brief.title,
+        subtitle: brief.summary,
+        primaryCta: brief.callToAction ?? "Launch a sandbox",
+        secondaryCta: "View docs"
+      },
+      highlights: brief.solutions.slice(0, 3).map((solution, index) => ({
+        heading: [
+          "Policy-safe by default",
+          "Auto-adapts per tenant",
+          "Launch-ready in days"
+        ][index] ?? "Key capability",
+        body: solution
+      })),
+      socialProof: {
+        heading: "Teams using ContractSpec",
+        body: brief.proofPoints?.join(`
+`) ?? "“We ship compliant workflows 5x faster while cutting ops toil in half.”"
+      },
+      faq: this.buildFaq(brief)
+    };
+  }
+  buildFaq(brief) {
+    const faqs = [
+      {
+        heading: "How does this keep policies enforced?",
+        body: "All workflows compile from TypeScript specs and pass through PDP checks before execution, so no shadow logic slips through."
+      },
+      {
+        heading: "Will it fit our existing stack?",
+        body: "Runtime adapters plug into REST, GraphQL, or MCP. Integrations stay vendor agnostic."
+      }
+    ];
+    if (brief.complianceNotes?.length) {
+      faqs.push({
+        heading: "What about compliance requirements?",
+        body: brief.complianceNotes.join(" ")
+      });
+    }
+    return faqs;
+  }
+}
+
+// src/generators/social.ts
+class SocialPostGenerator {
+  llm;
+  model;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      const posts = await this.generateWithLlm(brief);
+      if (posts.length)
+        return posts;
+    }
+    return this.generateFallback(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm)
+      return [];
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Create JSON array of social posts for twitter/linkedin/threads with body, hashtags, cta."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify(brief) }]
+      }
+    ], { responseFormat: "json", model: this.model });
+    const part = response.message.content.find((chunk) => ("text" in chunk));
+    if (!part || !("text" in part))
+      return [];
+    return JSON.parse(part.text);
+  }
+  generateFallback(brief) {
+    const hashtags = this.buildHashtags(brief);
+    return [
+      {
+        channel: "linkedin",
+        body: `${brief.title}: ${brief.summary}
+${brief.problems[0]} → ${brief.solutions[0]}`,
+        hashtags,
+        cta: brief.callToAction ?? "Book a 15-min run-through"
+      },
+      {
+        channel: "twitter",
+        body: `${brief.solutions[0]} in <60s. ${brief.solutions[1] ?? ""}`.trim(),
+        hashtags: hashtags.slice(0, 3),
+        cta: "→ contractspec.io/sandbox"
+      },
+      {
+        channel: "threads",
+        body: `Ops + policy can move fast. ${brief.title} automates guardrails so teams ship daily.`,
+        hashtags: hashtags.slice(1, 4)
+      }
+    ];
+  }
+  buildHashtags(brief) {
+    const base = [
+      brief.audience.industry ? `#${camel(brief.audience.industry)}` : "#operations",
+      "#automation",
+      "#aiops",
+      "#compliance"
+    ];
+    return [...new Set(base.map((tag) => tag.replace(/\s+/g, "")))].slice(0, 5);
+  }
+}
+function camel(text) {
+  return text.split(/\s|-/).filter(Boolean).map((word) => word[0]?.toUpperCase() + word.slice(1)).join("");
+}
+export {
+  SocialPostGenerator,
+  LandingPageGenerator,
+  EmailCampaignGenerator,
+  BlogGenerator
+};

package/dist/browser/generators/landing-page.js

@@ -0,0 +1,93 @@
+// src/generators/landing-page.ts
+class LandingPageGenerator {
+  options;
+  llm;
+  model;
+  constructor(options) {
+    this.options = options;
+    this.llm = options?.llm;
+    this.model = options?.model;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateFallback(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateFallback(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Write JSON landing page copy with hero/highlights/socialProof/faq arrays."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify({ brief }) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.options?.temperature ?? 0.5
+    });
+    const part = response.message.content.find((chunk) => ("text" in chunk));
+    if (part && "text" in part) {
+      return JSON.parse(part.text);
+    }
+    return this.generateFallback(brief);
+  }
+  generateFallback(brief) {
+    return {
+      hero: {
+        eyebrow: `${brief.audience.industry ?? "Operations"} teams`,
+        title: brief.title,
+        subtitle: brief.summary,
+        primaryCta: brief.callToAction ?? "Launch a sandbox",
+        secondaryCta: "View docs"
+      },
+      highlights: brief.solutions.slice(0, 3).map((solution, index) => ({
+        heading: [
+          "Policy-safe by default",
+          "Auto-adapts per tenant",
+          "Launch-ready in days"
+        ][index] ?? "Key capability",
+        body: solution
+      })),
+      socialProof: {
+        heading: "Teams using ContractSpec",
+        body: brief.proofPoints?.join(`
+`) ?? "“We ship compliant workflows 5x faster while cutting ops toil in half.”"
+      },
+      faq: this.buildFaq(brief)
+    };
+  }
+  buildFaq(brief) {
+    const faqs = [
+      {
+        heading: "How does this keep policies enforced?",
+        body: "All workflows compile from TypeScript specs and pass through PDP checks before execution, so no shadow logic slips through."
+      },
+      {
+        heading: "Will it fit our existing stack?",
+        body: "Runtime adapters plug into REST, GraphQL, or MCP. Integrations stay vendor agnostic."
+      }
+    ];
+    if (brief.complianceNotes?.length) {
+      faqs.push({
+        heading: "What about compliance requirements?",
+        body: brief.complianceNotes.join(" ")
+      });
+    }
+    return faqs;
+  }
+}
+export {
+  LandingPageGenerator
+};