@lssm/lib.content-gen 0.0.0-canary-20251206160926

package/README.md

@@ -0,0 +1,41 @@
+# @lssm/lib.content-gen
+
+Composable generators that turn ContractSpec briefs, specs, and telemetry into publish-ready marketing artifacts: blogs, landing pages, SEO metadata, email drips, and social posts.
+
+## Modules
+
+- `BlogGenerator` – creates narrative posts from feature briefs and spec metadata.
+- `LandingPageGenerator` – builds hero copy, feature bullets, proof points, and CTAs.
+- `EmailCampaignGenerator` – drafts onboarding, announcement, and nurture emails.
+- `SocialPostGenerator` – outputs multi-channel snippets with hashtags and CTAs.
+- `SeoOptimizer` – extracts keywords, meta tags, slugs, and Schema.org markup.
+
+Each generator accepts a `ContentBrief` that captures audience, value props, proof points, and compliance notes. If an `LLMProvider` is supplied, outputs blend AI creativity with deterministic templates; otherwise a deterministic fallback ensures consistent copy.
+
+## Quickstart
+
+```ts
+import {
+  BlogGenerator,
+  LandingPageGenerator,
+  EmailCampaignGenerator,
+  SocialPostGenerator,
+} from '@lssm/lib.content-gen/generators';
+import { SeoOptimizer } from '@lssm/lib.content-gen/seo';
+
+const brief = {
+  title: 'Policy-safe Workflow Automation',
+  summary: 'Automatically compiles intents into auditable workflows.',
+  problems: ['Manual reviews slow compliance', 'Engineers rebuild flows for every tenant'],
+  solutions: ['Spec-first workflows', 'Policy enforcement', 'Multi-tenant guardrails'],
+  audience: { role: 'COO', industry: 'Fintech', maturity: 'scaleup' },
+};
+
+const blog = await new BlogGenerator().generate(brief);
+const landing = await new LandingPageGenerator().generate(brief);
+const email = await new EmailCampaignGenerator().generate({ brief, variant: 'announcement' });
+const social = await new SocialPostGenerator().generate(brief);
+const seo = new SeoOptimizer().optimize(brief);
+```
+
+Outputs return structured blocks that can be rendered directly in the marketing site or exported to CMS tools.

package/dist/generators/blog.d.ts

@@ -0,0 +1,15 @@
+import { ContentBrief, GeneratedContent, GeneratorOptions } from "../types.js";
+
+//#region src/generators/blog.d.ts
+declare class BlogGenerator {
+  private readonly llm?;
+  private readonly model?;
+  private readonly temperature;
+  constructor(options?: GeneratorOptions);
+  generate(brief: ContentBrief): Promise<GeneratedContent>;
+  private generateWithLlm;
+  private generateDeterministic;
+  private renderWhyNow;
+}
+//#endregion
+export { BlogGenerator };

package/dist/generators/blog.js

@@ -0,0 +1 @@
+var e=class{llm;model;temperature;constructor(e){this.llm=e?.llm,this.model=e?.model,this.temperature=e?.temperature??.4}async generate(e){return this.llm?this.generateWithLlm(e):this.generateDeterministic(e)}async generateWithLlm(e){let t=(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:e})}]}],{responseFormat:`json`,model:this.model,temperature:this.temperature})).message.content.find(e=>`text`in e);return t&&`text`in t?JSON.parse(t.text):this.generateDeterministic(e)}generateDeterministic(e){let t=`Operators like ${e.audience.role} teams face ${e.problems.slice(0,2).join(` and `)}. ${e.title} changes that by ${e.summary}.`,n=[{heading:`Why now`,body:this.renderWhyNow(e)},{heading:`What you get`,body:`A focused stack built for policy-safe automation.`,bullets:e.solutions},{heading:`Proof it works`,body:`Teams using the blueprint report measurable wins.`,bullets:e.metrics??[`Launch workflows in minutes`,`Cut review time by 60%`]}];return{title:e.title,subtitle:e.summary,intro:t,sections:n,outro:e.callToAction??`Ready to see it live? Spin up a sandbox in under 5 minutes.`}}renderWhyNow(e){return`${`${e.audience.role}${e.audience.industry?` in ${e.audience.industry}`:``}`} teams are stuck with ${e.problems.slice(0,2).join(`; `)}. ${e.title} delivers guardrails without slowing shipping.`}};export{e as BlogGenerator};

package/dist/generators/email.d.ts

@@ -0,0 +1,18 @@
+import { EmailCampaignBrief, EmailDraft, GeneratorOptions } from "../types.js";
+
+//#region src/generators/email.d.ts
+declare class EmailCampaignGenerator {
+  private readonly llm?;
+  private readonly model?;
+  private readonly temperature;
+  constructor(options?: GeneratorOptions);
+  generate(input: EmailCampaignBrief): Promise<EmailDraft>;
+  private generateWithLlm;
+  private generateFallback;
+  private subjects;
+  private defaultPreview;
+  private renderBody;
+  private variantHook;
+}
+//#endregion
+export { EmailCampaignGenerator };

package/dist/generators/email.js

@@ -0,0 +1,13 @@
+var e=class{llm;model;temperature;constructor(e){this.llm=e?.llm,this.model=e?.model,this.temperature=e?.temperature??.6}async generate(e){if(this.llm){let t=await this.generateWithLlm(e);if(t)return t}return this.generateFallback(e)}async generateWithLlm(e){let t=(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(e)}]}],{responseFormat:`json`,model:this.model,temperature:this.temperature})).message.content.find(e=>`text`in e);if(!t||!(`text`in t))return null;let n=JSON.parse(t.text);return!n.subject||!n.body||!n.cta?null:{subject:n.subject,previewText:n.previewText??this.defaultPreview(e),body:n.body,cta:n.cta,variant:e.variant}}generateFallback(e){let{brief:t,variant:n}=e;return{subject:this.subjects(t.title,n)[0]??`${t.title} update`,previewText:this.defaultPreview(e),body:this.renderBody(e),cta:t.callToAction??`Explore the sandbox`,variant:n}}subjects(e,t){switch(t){case`announcement`:return[`Launch: ${e}`,`${e} is live`,`New: ${e}`];case`onboarding`:return[`Get started with ${e}`,`Your ${e} guide`];case`nurture`:default:return[`How ${e} speeds ops`,`Proof ${e} works`]}}defaultPreview(e){return`See how teams ${e.brief.metrics?.[0]??`ship faster without policy gaps`}.`}renderBody(e){let{brief:t,variant:n}=e,r=this.variantHook(n,t),i=t.metrics?.map(e=>`• ${e}`).join(`
+`)??``;return`Hi there,
+
+${r}
+
+Top reasons teams adopt ${t.title}:
+${t.solutions.map(e=>`• ${e}`).join(`
+`)}
+
+${i}
+
+${t.callToAction??`Spin up a sandbox`} → ${(e.cadenceDay??0)+1}
+`}variantHook(e,t){switch(e){case`announcement`:return`${t.title} is live. ${t.summary}`;case`onboarding`:return`Here is your next step to unlock ${t.title}.`;case`nurture`:default:return`Operators like ${t.audience.role} keep asking how to automate policy checks. Here is what works.`}}};export{e as EmailCampaignGenerator};

package/dist/generators/index.d.ts

@@ -0,0 +1,5 @@
+import { BlogGenerator } from "./blog.js";
+import { EmailCampaignGenerator } from "./email.js";
+import { LandingPageCopy, LandingPageGenerator } from "./landing-page.js";
+import { SocialPostGenerator } from "./social.js";
+export { BlogGenerator, EmailCampaignGenerator, LandingPageCopy, LandingPageGenerator, SocialPostGenerator };

package/dist/generators/index.js

@@ -0,0 +1 @@
+import{BlogGenerator as e}from"./blog.js";import{LandingPageGenerator as t}from"./landing-page.js";import{EmailCampaignGenerator as n}from"./email.js";import{SocialPostGenerator as r}from"./social.js";export{e as BlogGenerator,n as EmailCampaignGenerator,t as LandingPageGenerator,r as SocialPostGenerator};

package/dist/generators/landing-page.d.ts

@@ -0,0 +1,27 @@
+import { ContentBlock, ContentBrief, GeneratorOptions } from "../types.js";
+
+//#region src/generators/landing-page.d.ts
+interface LandingPageCopy {
+  hero: {
+    eyebrow?: string;
+    title: string;
+    subtitle: string;
+    primaryCta: string;
+    secondaryCta?: string;
+  };
+  highlights: ContentBlock[];
+  socialProof: ContentBlock;
+  faq: ContentBlock[];
+}
+declare class LandingPageGenerator {
+  private readonly options?;
+  private readonly llm?;
+  private readonly model?;
+  constructor(options?: GeneratorOptions | undefined);
+  generate(brief: ContentBrief): Promise<LandingPageCopy>;
+  private generateWithLlm;
+  private generateFallback;
+  private buildFaq;
+}
+//#endregion
+export { LandingPageCopy, LandingPageGenerator };

package/dist/generators/landing-page.js

@@ -0,0 +1,2 @@
+var e=class{llm;model;constructor(e){this.options=e,this.llm=e?.llm,this.model=e?.model}async generate(e){return this.llm?this.generateWithLlm(e):this.generateFallback(e)}async generateWithLlm(e){let t=(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:e})}]}],{responseFormat:`json`,model:this.model,temperature:this.options?.temperature??.5})).message.content.find(e=>`text`in e);return t&&`text`in t?JSON.parse(t.text):this.generateFallback(e)}generateFallback(e){return{hero:{eyebrow:`${e.audience.industry??`Operations`} teams`,title:e.title,subtitle:e.summary,primaryCta:e.callToAction??`Launch a sandbox`,secondaryCta:`View docs`},highlights:e.solutions.slice(0,3).map((e,t)=>({heading:[`Policy-safe by default`,`Auto-adapts per tenant`,`Launch-ready in days`][t]??`Key capability`,body:e})),socialProof:{heading:`Teams using ContractSpec`,body:e.proofPoints?.join(`
+`)??`“We ship compliant workflows 5x faster while cutting ops toil in half.”`},faq:this.buildFaq(e)}}buildFaq(e){let t=[{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.`}];return e.complianceNotes?.length&&t.push({heading:`What about compliance requirements?`,body:e.complianceNotes.join(` `)}),t}};export{e as LandingPageGenerator};

package/dist/generators/social.d.ts

@@ -0,0 +1,14 @@
+import { ContentBrief, GeneratorOptions, SocialPost } from "../types.js";
+
+//#region src/generators/social.d.ts
+declare class SocialPostGenerator {
+  private readonly llm?;
+  private readonly model?;
+  constructor(options?: GeneratorOptions);
+  generate(brief: ContentBrief): Promise<SocialPost[]>;
+  private generateWithLlm;
+  private generateFallback;
+  private buildHashtags;
+}
+//#endregion
+export { SocialPostGenerator };

package/dist/generators/social.js

@@ -0,0 +1 @@
+var e=class{llm;model;constructor(e){this.llm=e?.llm,this.model=e?.model}async generate(e){if(this.llm){let t=await this.generateWithLlm(e);if(t.length)return t}return this.generateFallback(e)}async generateWithLlm(e){let t=(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(e)}]}],{responseFormat:`json`,model:this.model})).message.content.find(e=>`text`in e);return!t||!(`text`in t)?[]:JSON.parse(t.text)}generateFallback(e){let t=this.buildHashtags(e);return[{channel:`linkedin`,body:`${e.title}: ${e.summary}\n${e.problems[0]} → ${e.solutions[0]}`,hashtags:t,cta:e.callToAction??`Book a 15-min run-through`},{channel:`twitter`,body:`${e.solutions[0]} in <60s. ${e.solutions[1]??``}`.trim(),hashtags:t.slice(0,3),cta:`→ contractspec.chaman.ventures/sandbox`},{channel:`threads`,body:`Ops + policy can move fast. ${e.title} automates guardrails so teams ship daily.`,hashtags:t.slice(1,4)}]}buildHashtags(e){let n=[e.audience.industry?`#${t(e.audience.industry)}`:`#operations`,`#automation`,`#aiops`,`#compliance`];return[...new Set(n.map(e=>e.replace(/\s+/g,``)))].slice(0,5)}};function t(e){return e.split(/\s|-/).filter(Boolean).map(e=>e[0]?.toUpperCase()+e.slice(1)).join(``)}export{e as SocialPostGenerator};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { AudienceProfile, ContentBlock, ContentBrief, EmailCampaignBrief, EmailDraft, GeneratedContent, GeneratorOptions, SeoMetadata, SocialPost } from "./types.js";
+import { BlogGenerator } from "./generators/blog.js";
+import { EmailCampaignGenerator } from "./generators/email.js";
+import { LandingPageCopy, LandingPageGenerator } from "./generators/landing-page.js";
+import { SocialPostGenerator } from "./generators/social.js";
+import { SeoOptimizer } from "./seo/optimizer.js";
+export { AudienceProfile, BlogGenerator, ContentBlock, ContentBrief, EmailCampaignBrief, EmailCampaignGenerator, EmailDraft, GeneratedContent, GeneratorOptions, LandingPageCopy, LandingPageGenerator, SeoMetadata, SeoOptimizer, SocialPost, SocialPostGenerator };

package/dist/index.js

@@ -0,0 +1 @@
+import{BlogGenerator as e}from"./generators/blog.js";import{LandingPageGenerator as t}from"./generators/landing-page.js";import{EmailCampaignGenerator as n}from"./generators/email.js";import{SocialPostGenerator as r}from"./generators/social.js";import{SeoOptimizer as i}from"./seo/optimizer.js";export{e as BlogGenerator,n as EmailCampaignGenerator,t as LandingPageGenerator,i as SeoOptimizer,r as SocialPostGenerator};

package/dist/seo/index.d.ts

@@ -0,0 +1,2 @@
+import { SeoOptimizer } from "./optimizer.js";
+export { SeoOptimizer };

package/dist/seo/index.js

@@ -0,0 +1 @@
+import{SeoOptimizer as e}from"./optimizer.js";export{e as SeoOptimizer};

package/dist/seo/optimizer.d.ts

@@ -0,0 +1,11 @@
+import { ContentBrief, SeoMetadata } from "../types.js";
+
+//#region src/seo/optimizer.d.ts
+declare class SeoOptimizer {
+  optimize(brief: ContentBrief): SeoMetadata;
+  private keywords;
+  private slugify;
+  private schema;
+}
+//#endregion
+export { SeoOptimizer };

package/dist/seo/optimizer.js

@@ -0,0 +1 @@
+var e=class{optimize(e){let t=this.keywords(e),n=`${e.title} | ContractSpec`,r=`${e.summary} — built for ${e.audience.role}${e.audience.industry?` in ${e.audience.industry}`:``}.`;return{metaTitle:n,metaDescription:r,keywords:t,slug:this.slugify(e.title),schemaMarkup:this.schema(e,r,t)}}keywords(e){let t=[e.title,...e.problems,...e.solutions];return[...new Set(t.flatMap(e=>e.toLowerCase().split(/\s+/)))].filter(e=>e.length>3).slice(0,12)}slugify(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``)}schema(e,t,n){return{"@context":`https://schema.org`,"@type":`Product`,name:e.title,description:t,audience:{"@type":`Audience`,audienceType:e.audience.role,industry:e.audience.industry},offers:{"@type":`Offer`,description:e.callToAction??`Start building with ContractSpec`},keywords:n.join(`, `),citation:e.references?.map(e=>e.url)}}};export{e as SeoOptimizer};

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+import { LLMProvider } from "@lssm/lib.contracts/integrations/providers/llm";
+
+//#region src/types.d.ts
+interface AudienceProfile {
+  role: string;
+  industry?: string;
+  region?: string;
+  maturity?: 'early' | 'scaleup' | 'enterprise';
+  painPoints?: string[];
+}
+interface ContentBrief {
+  title: string;
+  summary: string;
+  problems: string[];
+  solutions: string[];
+  metrics?: string[];
+  proofPoints?: string[];
+  complianceNotes?: string[];
+  audience: AudienceProfile;
+  callToAction?: string;
+  references?: {
+    label: string;
+    url: string;
+  }[];
+}
+interface ContentBlock {
+  heading: string;
+  body: string;
+  bullets?: string[];
+  cta?: string;
+}
+interface GeneratedContent {
+  title: string;
+  subtitle?: string;
+  intro: string;
+  sections: ContentBlock[];
+  outro?: string;
+}
+interface GeneratorOptions {
+  llm?: LLMProvider;
+  model?: string;
+  temperature?: number;
+}
+interface EmailCampaignBrief {
+  brief: ContentBrief;
+  variant: 'announcement' | 'onboarding' | 'nurture';
+  cadenceDay?: number;
+}
+interface EmailDraft {
+  subject: string;
+  previewText: string;
+  body: string;
+  cta: string;
+  variant: EmailCampaignBrief['variant'];
+}
+interface SocialPost {
+  channel: 'twitter' | 'linkedin' | 'threads';
+  body: string;
+  hashtags: string[];
+  cta?: string;
+  link?: string;
+}
+interface SeoMetadata {
+  metaTitle: string;
+  metaDescription: string;
+  keywords: string[];
+  slug: string;
+  schemaMarkup: Record<string, unknown>;
+}
+//#endregion
+export { AudienceProfile, ContentBlock, ContentBrief, EmailCampaignBrief, EmailDraft, GeneratedContent, GeneratorOptions, SeoMetadata, SocialPost };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@lssm/lib.content-gen",
+  "version": "0.0.0-canary-20251206160926",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@lssm/lib.contracts": "workspace:*"
+  },
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./generators": "./dist/generators/index.js",
+    "./generators/blog": "./dist/generators/blog.js",
+    "./generators/email": "./dist/generators/email.js",
+    "./generators/landing-page": "./dist/generators/landing-page.js",
+    "./generators/social": "./dist/generators/social.js",
+    "./seo": "./dist/seo/index.js",
+    "./seo/optimizer": "./dist/seo/optimizer.js",
+    "./types": "./dist/types.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}