@contractspec/example.content-generation 1.56.1 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,26 +1,32 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/content-generation/tsdown.config.js (unrun)
-ℹ entry: src/example.ts, src/generate.ts, src/index.ts, src/docs/content-generation.docblock.ts, src/docs/index.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/generate.js                              1.81 kB │ gzip: 0.90 kB
-ℹ dist/docs/content-generation.docblock.js      1.37 kB │ gzip: 0.69 kB
-ℹ dist/example.js                               1.02 kB │ gzip: 0.51 kB
-ℹ dist/index.js                                 0.20 kB │ gzip: 0.13 kB
-ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
-ℹ dist/generate.js.map                          2.87 kB │ gzip: 1.30 kB
-ℹ dist/docs/content-generation.docblock.js.map  1.86 kB │ gzip: 0.88 kB
-ℹ dist/example.js.map                           1.46 kB │ gzip: 0.69 kB
-ℹ dist/generate.d.ts.map                        0.14 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts                             0.25 kB │ gzip: 0.17 kB
-ℹ dist/generate.d.ts                            0.18 kB │ gzip: 0.15 kB
-ℹ dist/index.d.ts                               0.14 kB │ gzip: 0.10 kB
-ℹ dist/docs/content-generation.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/index.d.ts                          0.01 kB │ gzip: 0.03 kB
-ℹ 15 files, total: 11.51 kB
-✔ Build complete in 22116ms
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=5
+Bundled 5 modules in 19ms
+
+  docs/content-generation.docblock.js  1.36 KB  (entry point)
+  ./index.js                           4.0 KB   (entry point)
+  docs/index.js                        1.36 KB  (entry point)
+  ./example.js                         0.98 KB  (entry point)
+  ./generate.js                        1.72 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=5
+Bundled 5 modules in 32ms
+
+  docs/content-generation.docblock.js  1.35 KB  (entry point)
+  ./index.js                           4.0 KB   (entry point)
+  docs/index.js                        1.35 KB  (entry point)
+  ./example.js                         0.97 KB  (entry point)
+  ./generate.js                        1.71 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=5
+Bundled 5 modules in 36ms
+
+  docs/content-generation.docblock.js  1.35 KB  (entry point)
+  ./index.js                           4.0 KB   (entry point)
+  docs/index.js                        1.35 KB  (entry point)
+  ./example.js                         0.97 KB  (entry point)
+  ./generate.js                        1.71 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @contractspec/example.content-generation
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/lib.content-gen@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.logger@1.58.0
+
+## 1.57.0
+
+### Minor Changes
+
+- 11a5a05: feat: improve product intent
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/lib.content-gen@1.57.0
+  - @contractspec/lib.logger@1.57.0
+
 ## 1.56.1
 
 ### Patch Changes

package/dist/browser/docs/content-generation.docblock.js

@@ -0,0 +1,40 @@
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input → same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- 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
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/docs/index.js

@@ -0,0 +1,40 @@
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input → same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- 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
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/generate.js

@@ -0,0 +1,50 @@
+// src/generate.ts
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator
+} from "@contractspec/lib.content-gen/generators";
+import { SeoOptimizer } from "@contractspec/lib.content-gen/seo";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runContentGenerationExample() {
+  const brief = {
+    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
+  });
+}
+export {
+  runContentGenerationExample
+};

package/dist/browser/index.js

@@ -0,0 +1,122 @@
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input → same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- 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
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/generate.ts
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator
+} from "@contractspec/lib.content-gen/generators";
+import { SeoOptimizer } from "@contractspec/lib.content-gen/seo";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runContentGenerationExample() {
+  const brief = {
+    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
+  });
+}
+export {
+  runContentGenerationExample,
+  example_default as example
+};

package/dist/docs/content-generation.docblock.d.ts

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=content-generation.docblock.d.ts.map

package/dist/docs/content-generation.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-generation.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/content-generation.docblock.ts"],"names":[],"mappings":""}

package/dist/docs/content-generation.docblock.js

@@ -1,29 +1,41 @@
+// @bun
+// src/docs/content-generation.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input \u2192 same structure).
 
-//#region src/docs/content-generation.docblock.ts
-registerDocBlocks([{
-	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.`
-}]);
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- SEO metadata`
+  },
+  {
+    id: "docs.examples.content-generation.usage",
+    title: "Content Generation \u2014 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
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
 
-//#endregion
-//# sourceMappingURL=content-generation.docblock.js.map
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './content-generation.docblock';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,+BAA+B,CAAC"}

package/dist/docs/index.js

@@ -1 +1,41 @@
-import "./content-generation.docblock.js";
+// @bun
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input \u2192 same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- SEO metadata`
+  },
+  {
+    id: "docs.examples.content-generation.usage",
+    title: "Content Generation \u2014 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
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/example.d.ts

@@ -1,7 +1,3 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/example.d.ts
-declare const example: _contractspec_lib_contracts0.ExampleSpec;
-//#endregion
-export { example as default };
+declare const example: import("@contractspec/lib.contracts").ExampleSpec;
+export default example;
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA2BJ,4BAAA,CA3BW"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,OAAO,mDA2BX,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/example.js

@@ -1,46 +1,34 @@
+// @bun
+// src/example.ts
 import { defineExample } from "@contractspec/lib.contracts";
-
-//#region src/example.ts
-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 }
-	}
+var 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 }
+  }
 });
 var example_default = example;
-
-//#endregion
-export { example_default as default };
-//# sourceMappingURL=example.js.map
+export {
+  example_default as default
+};

package/dist/generate.d.ts

@@ -1,5 +1,2 @@
-//#region src/generate.d.ts
-declare function runContentGenerationExample(): Promise<void>;
-//#endregion
-export { runContentGenerationExample };
+export declare function runContentGenerationExample(): Promise<void>;
 //# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","names":[],"sources":["../src/generate.ts"],"sourcesContent":[],"mappings":";iBAkBsB,2BAAA,CAAA,GAA+B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAkBA,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAmCjE"}