@lssm/example.content-generation 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/libs/content-gen/dist/generators/email.js

@@ -1,13 +1,100 @@
-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,
+//#region ../../libs/content-gen/dist/generators/email.js
+var EmailCampaignGenerator = class {
+	llm;
+	model;
+	temperature;
+	constructor(options) {
+		this.llm = options?.llm;
+		this.model = options?.model;
+		this.temperature = options?.temperature ?? .6;
+	}
+	async generate(input) {
+		if (this.llm) {
+			const draft = await this.generateWithLlm(input);
+			if (draft) return draft;
+		}
+		return this.generateFallback(input);
+	}
+	async generateWithLlm(input) {
+		const jsonPart = (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
+		})).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;
+		return {
+			subject: this.subjects(brief.title, variant)[0] ?? `${brief.title} update`,
+			previewText: this.defaultPreview(input),
+			body: this.renderBody(input),
+			cta: brief.callToAction ?? "Explore the sandbox",
+			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) {
+		return `See how teams ${input.brief.metrics?.[0] ?? "ship faster without policy gaps"}.`;
+	}
+	renderBody(input) {
+		const { brief, variant } = input;
+		const greeting = "Hi there,";
+		const hook = this.variantHook(variant, brief);
+		const proof = brief.metrics?.map((metric) => `• ${metric}`).join("\n") ?? "";
+		return `${greeting}
 
-${r}
+${hook}
 
-Top reasons teams adopt ${t.title}:
-${t.solutions.map(e=>`• ${e}`).join(`
-`)}
+Top reasons teams adopt ${brief.title}:
+${brief.solutions.map((solution) => `• ${solution}`).join("\n")}
 
-${i}
+${proof}
 
-${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};
+${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.`;
+		}
+	}
+};
+
+//#endregion
+export { EmailCampaignGenerator };

package/dist/libs/content-gen/dist/generators/landing-page.js

@@ -1,2 +1,76 @@
-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};
+//#region ../../libs/content-gen/dist/generators/landing-page.js
+var LandingPageGenerator = class {
+	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) {
+		const part = (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 ?? .5
+		})).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("\n") ?? "“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;
+	}
+};
+
+//#endregion
+export { LandingPageGenerator };

package/dist/libs/content-gen/dist/generators/social.js

@@ -1 +1,73 @@
-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.lssm.tech/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};
+//#region ../../libs/content-gen/dist/generators/social.js
+var SocialPostGenerator = class {
+	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) {
+		const part = (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
+		})).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}\n${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.lssm.tech/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("");
+}
+
+//#endregion
+export { SocialPostGenerator };

package/dist/libs/content-gen/dist/seo/optimizer.js

@@ -1 +1,48 @@
-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};
+//#region ../../libs/content-gen/dist/seo/optimizer.js
+var SeoOptimizer = class {
+	optimize(brief) {
+		const keywords = this.keywords(brief);
+		const metaTitle = `${brief.title} | ContractSpec`;
+		const metaDescription = `${brief.summary} — built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
+		return {
+			metaTitle,
+			metaDescription,
+			keywords,
+			slug: this.slugify(brief.title),
+			schemaMarkup: this.schema(brief, metaDescription, keywords)
+		};
+	}
+	keywords(brief) {
+		const base = [
+			brief.title,
+			...brief.problems,
+			...brief.solutions
+		];
+		return [...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))].filter((word) => word.length > 3).slice(0, 12);
+	}
+	slugify(text) {
+		return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+	}
+	schema(brief, description, keywords) {
+		return {
+			"@context": "https://schema.org",
+			"@type": "Product",
+			name: brief.title,
+			description,
+			audience: {
+				"@type": "Audience",
+				audienceType: brief.audience.role,
+				industry: brief.audience.industry
+			},
+			offers: {
+				"@type": "Offer",
+				description: brief.callToAction ?? "Start building with ContractSpec"
+			},
+			keywords: keywords.join(", "),
+			citation: brief.references?.map((ref) => ref.url)
+		};
+	}
+};
+
+//#endregion
+export { SeoOptimizer };

package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js

@@ -1,76 +1,16 @@
-import{a as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
-
-This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
-
-## Release Tracks
-
-| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
-|-------|--------|---------|-----------|------------|----------|
-| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
-| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
-
-## Prerequisites
-
-- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
-- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
-- ✅ For stable releases: \`release\` branch exists and is protected.
-
-## Canary Workflow (Automatic)
-
-Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
-
-1. **Trigger**: Push to \`main\`.
-2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
-3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
-
-### Consuming Canary Builds
-
-To install the latest bleeding-edge version:
-
-\`\`\`bash
-npm install @lssm/lib.contracts@canary
-# or
-bun add @lssm/lib.contracts@canary
-\`\`\`
-
-## Stable Release Workflow (Manual)
-
-Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
-
-1. **Develop on \`main\`**: Create features and fixes.
-2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
-3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
-4. **"Version Packages" PR**:
-   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
-   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
-5. **Merge & Publish**:
-   - Review and merge the "Version Packages" PR.
-   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
-
-### Publishing Steps
-
-1. Ensure all changesets are present on \`main\`.
-2. Merge \`main\` into \`release\`:
-   \`\`\`bash
-   git checkout release
-   git pull origin release
-   git merge main
-   git push origin release
-   \`\`\`
-3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
-4. Merge that PR.
-5. The release is now live on npm!
-
-## Manual Verification (Optional)
-
-Before publishing a new version you can run:
-
-\`\`\`bash
-bun run build:not-apps
-npx npm-packlist --json packages/libs/contracts
-\`\`\`
-
-## Rollback
-
-If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
-`}]);
+import { registerDocBlocks } from "./registry.js";
+
+//#region ../../libs/contracts/dist/docs/PUBLISHING.docblock.js
+const PUBLISHING_DocBlocks = [{
+	id: "docs.PUBLISHING",
+	title: "Publishing ContractSpec Libraries",
+	summary: "This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/PUBLISHING",
+	tags: ["PUBLISHING"],
+	body: "# Publishing ContractSpec Libraries\n\nThis guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).\n\n## Release Tracks\n\n| Track | Branch | npm Tag | Frequency | Versioning | Use Case |\n|-------|--------|---------|-----------|------------|----------|\n| **Stable** | `release` | `latest` | Manual | SemVer (e.g., `1.7.4`) | Production, external users |\n| **Canary** | `main` | `canary` | Every Push | Snapshot (e.g., `1.7.4-canary...`) | Dev, internal testing |\n\n## Prerequisites\n\n- ✅ `NPM_TOKEN` secret is configured in GitHub (owner or automation token with _publish_ scope).\n- ✅ `GITHUB_TOKEN` (built-in) has permissions to create PRs (enabled by default in new repos).\n- ✅ For stable releases: `release` branch exists and is protected.\n\n## Canary Workflow (Automatic)\n\nEvery commit pushed to `main` triggers the `.github/workflows/publish-canary.yml` workflow.\n\n1. **Trigger**: Push to `main`.\n2. **Versioning**: Runs `changeset version --snapshot canary` to generate a temporary snapshot version.\n3. **Publish**: Packages are published to npm with the `canary` tag using `changeset publish --tag canary`.\n\n### Consuming Canary Builds\n\nTo install the latest bleeding-edge version:\n\n```bash\nnpm install @lssm/lib.contracts@canary\n# or\nbun add @lssm/lib.contracts@canary\n```\n\n## Stable Release Workflow (Manual)\n\nStable releases are managed via the `release` branch using the standard [Changesets Action](https://github.com/changesets/action).\n\n1. **Develop on `main`**: Create features and fixes.\n2. **Add Changesets**: Run `bun changeset` to document changes and impact (major/minor/patch).\n3. **Merge to `release`**: When ready to ship, open a PR from `main` to `release` or merge manually.\n4. **\"Version Packages\" PR**:\n   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **\"Version Packages\"**.\n   - This PR contains the version bumps and updated `CHANGELOG.md` files.\n5. **Merge & Publish**:\n   - Review and merge the \"Version Packages\" PR.\n   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the `latest` tag.\n\n### Publishing Steps\n\n1. Ensure all changesets are present on `main`.\n2. Merge `main` into `release`:\n   ```bash\n   git checkout release\n   git pull origin release\n   git merge main\n   git push origin release\n   ```\n3. Go to GitHub Pull Requests. You will see a **\"Version Packages\"** PR created by the bot.\n4. Merge that PR.\n5. The release is now live on npm!\n\n## Manual Verification (Optional)\n\nBefore publishing a new version you can run:\n\n```bash\nbun run build:not-apps\nnpx npm-packlist --json packages/libs/contracts\n```\n\n## Rollback\n\nIf a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use `npm deprecate <package>@<version>` if we need to warn consumers about a broken release.\n"
+}];
+registerDocBlocks(PUBLISHING_DocBlocks);
+
+//#endregion