@contractspec/example.content-generation 0.0.0-canary-20260113162409

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@contractspec/example.content-generation",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "Content generation example using @contractspec/lib.content-gen.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/content-generation.docblock": "./dist/docs/content-generation.docblock.js",
+    "./example": "./dist/example.js",
+    "./generate": "./dist/generate.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "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 test"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.content-gen": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.logger": "0.0.0-canary-20260113162409"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/content-generation.docblock": "./dist/docs/content-generation.docblock.js",
+      "./example": "./dist/example.js",
+      "./generate": "./dist/generate.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/content-generation"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/content-generation.docblock.ts

@@ -0,0 +1,28 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    id: 'docs.examples.content-generation',
+    title: 'Content Generation (example)',
+    summary:
+      'Generate a consistent set of marketing assets from a typed ContentBrief (blog, landing hero, email, social, SEO).',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/content-generation',
+    tags: ['content', 'marketing', 'example'],
+    body: `## What this example shows\n- A spec-first-ish interface for content brief inputs (typed, validated).\n- Deterministic orchestration of generators (same input → same structure).\n\n## Outputs\n- Blog intro\n- Landing hero\n- Email subject/body\n- Social post bodies\n- SEO metadata`,
+  },
+  {
+    id: 'docs.examples.content-generation.usage',
+    title: 'Content Generation — Usage',
+    summary: 'How to run the example and extend the brief.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/content-generation/usage',
+    tags: ['content', 'usage'],
+    body: `## Usage\n- Call \`runContentGenerationExample()\`.\n- Modify the \`ContentBrief\` fields to drive different outputs.\n\n## Guardrails\n- Avoid PII in briefs.\n- Keep output logging structured; no raw \`console.log\` in library code.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './content-generation.docblock';

package/src/example.ts

@@ -0,0 +1,32 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+const example = defineExample({
+  meta: {
+    key: 'content-generation',
+    version: '1.0.0',
+    title: 'Content Generation',
+    description:
+      'Generate blog/landing/email/social/SEO assets from a typed ContentBrief using @contractspec/lib.content-gen.',
+    kind: 'script',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.core'],
+    tags: ['content', 'marketing', 'generation', 'ai'],
+  },
+  docs: {
+    rootDocId: 'docs.examples.content-generation',
+    usageDocId: 'docs.examples.content-generation.usage',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.content-generation',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+});
+
+export default example;

package/src/generate.ts

@@ -0,0 +1,54 @@
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator,
+} from '@contractspec/lib.content-gen/generators';
+import { SeoOptimizer } from '@contractspec/lib.content-gen/seo';
+import type { ContentBrief } from '@contractspec/lib.content-gen';
+import { Logger, LogLevel } from '@contractspec/lib.logger';
+import type { LoggerConfig } from '@contractspec/lib.logger/types';
+
+const logger = new Logger({
+  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+  environment:
+    (process.env.NODE_ENV as LoggerConfig['environment']) || 'development',
+  enableColors: process.env.NODE_ENV !== 'production',
+});
+
+export async function runContentGenerationExample(): Promise<void> {
+  const brief: ContentBrief = {
+    title: 'AI-Native Operations Copilot',
+    summary:
+      'Automates support resolutions, growth playbooks, and DevOps rituals.',
+    problems: [
+      'Support queues pile up after hours',
+      'Growth teams lack fresh experiments',
+    ],
+    solutions: [
+      'Stateful AI agents grounded in your knowledge spaces',
+      'CI-safe approval workflows for human review',
+      'Analytics + experimentation stack built into ContractSpec',
+    ],
+    metrics: ['80% auto-resolution rate', '10+ experiments shipped weekly'],
+    audience: { role: 'COO', industry: 'Fintech', maturity: 'scaleup' },
+    callToAction: 'Book a 15‑minute pilot run',
+  };
+
+  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);
+
+  logger.info('Generated content assets', {
+    blogIntro: blog.intro,
+    landingHero: landing.hero,
+    emailSubject: email.subject,
+    socialPosts: social.map((post) => post.body),
+    seo,
+  });
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './generate';
+export { default as example } from './example';
+import './docs';

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}
+
+