@lssm/example.content-generation 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217062943

package/.turbo/turbo-build$colon$bundle.log

@@ -1,20 +1,69 @@
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/content-generation/tsdown.config.js 
-ℹ 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
-ℹ Cleaning 11 files
-ℹ dist/generate.js                            1.34 kB │ gzip: 0.78 kB
-ℹ dist/docs/content-generation.docblock.js    1.15 kB │ gzip: 0.62 kB
-ℹ dist/example.js                             0.57 kB │ gzip: 0.33 kB
-ℹ dist/index.js                               0.17 kB │ gzip: 0.12 kB
-ℹ dist/docs/index.js                          0.04 kB │ gzip: 0.06 kB
-ℹ dist/example.d.ts                           1.02 kB │ gzip: 0.41 kB
-ℹ dist/index.d.ts                             0.14 kB │ gzip: 0.10 kB
-ℹ dist/generate.d.ts                          0.14 kB │ gzip: 0.12 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
-ℹ 10 files, total: 4.59 kB
-✔ Build complete in 28867ms
+
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/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
+ℹ Cleaning 72 files
+ℹ dist/generate.js                                                                1.54 kB │ gzip: 0.79 kB
+ℹ dist/docs/content-generation.docblock.js                                        1.19 kB │ gzip: 0.63 kB
+ℹ dist/example.js                                                                 0.57 kB │ gzip: 0.33 kB
+ℹ dist/index.js                                                                   0.17 kB │ gzip: 0.12 kB
+ℹ dist/docs/index.js                                                              0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.51 kB │ gzip: 7.15 kB
+ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   10.97 kB │ gzip: 4.28 kB
+ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.65 kB │ gzip: 3.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.10 kB │ gzip: 3.41 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.74 kB │ gzip: 2.67 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.91 kB │ gzip: 2.61 kB
+ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.62 kB │ gzip: 2.58 kB
+ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.42 kB │ gzip: 2.25 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.35 kB │ gzip: 2.05 kB
+ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 3.89 kB │ gzip: 1.69 kB
+ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.58 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.42 kB │ gzip: 1.58 kB
+ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.34 kB │ gzip: 1.45 kB
+ℹ dist/libs/logger/dist/formatters.js                                             3.31 kB │ gzip: 1.34 kB
+ℹ dist/libs/logger/dist/logger.node.js                                            3.24 kB │ gzip: 1.28 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.07 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.03 kB │ gzip: 1.32 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     2.98 kB │ gzip: 1.52 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.81 kB │ gzip: 1.41 kB
+ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.73 kB │ gzip: 1.30 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.49 kB │ gzip: 1.11 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.13 kB │ gzip: 1.03 kB
+ℹ dist/libs/content-gen/dist/generators/email.js                                  1.92 kB │ gzip: 0.94 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                1.89 kB │ gzip: 0.93 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           1.78 kB │ gzip: 0.87 kB
+ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.70 kB │ gzip: 0.89 kB
+ℹ dist/libs/content-gen/dist/generators/landing-page.js                           1.61 kB │ gzip: 0.92 kB
+ℹ dist/libs/logger/dist/tracer.node.js                                            1.59 kB │ gzip: 0.68 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.57 kB │ gzip: 0.77 kB
+ℹ dist/libs/content-gen/dist/generators/blog.js                                   1.52 kB │ gzip: 0.79 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.47 kB │ gzip: 0.73 kB
+ℹ dist/libs/contracts/dist/docs/index.js                                          1.42 kB │ gzip: 0.47 kB
+ℹ dist/libs/content-gen/dist/generators/social.js                                 1.35 kB │ gzip: 0.76 kB
+ℹ dist/libs/logger/dist/timer.js                                                  1.25 kB │ gzip: 0.50 kB
+ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.23 kB │ gzip: 0.68 kB
+ℹ dist/libs/contracts/dist/docs/presentations.js                                  1.14 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          0.89 kB │ gzip: 0.55 kB
+ℹ dist/libs/content-gen/dist/seo/optimizer.js                                     0.87 kB │ gzip: 0.51 kB
+ℹ dist/libs/logger/dist/context.node.js                                           0.67 kB │ gzip: 0.32 kB
+ℹ dist/libs/contracts/dist/docs/registry.js                                       0.63 kB │ gzip: 0.39 kB
+ℹ dist/libs/logger/dist/index.js                                                  0.23 kB │ gzip: 0.13 kB
+ℹ dist/libs/logger/dist/types.js                                                  0.16 kB │ gzip: 0.14 kB
+ℹ dist/libs/logger/dist/elysia-plugin.js                                          0.07 kB │ gzip: 0.07 kB
+ℹ dist/example.d.ts                                                               1.02 kB │ gzip: 0.41 kB
+ℹ dist/index.d.ts                                                                 0.14 kB │ gzip: 0.10 kB
+ℹ dist/generate.d.ts                                                              0.14 kB │ gzip: 0.12 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
+ℹ 53 files, total: 146.09 kB
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:async_hooks' in ../../libs/logger/dist/context.node.mjs
+ - Module not found, treating it as an external dependency in ../../libs/logger/dist/context.node.mjs at 34..52
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+✔ Build complete in 1972ms

package/.turbo/turbo-build.log

@@ -1,21 +1,18 @@
-$ bun build:bundle && bun build:types
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/content-generation/tsdown.config.js 
-ℹ 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.34 kB │ gzip: 0.78 kB
-ℹ dist/docs/content-generation.docblock.js    1.15 kB │ gzip: 0.62 kB
-ℹ dist/example.js                             0.57 kB │ gzip: 0.33 kB
-ℹ dist/index.js                               0.17 kB │ gzip: 0.12 kB
-ℹ dist/docs/index.js                          0.04 kB │ gzip: 0.06 kB
-ℹ dist/example.d.ts                           1.02 kB │ gzip: 0.41 kB
-ℹ dist/index.d.ts                             0.14 kB │ gzip: 0.10 kB
-ℹ dist/generate.d.ts                          0.14 kB │ gzip: 0.12 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
-ℹ 10 files, total: 4.59 kB
-✔ Build complete in 33166ms
-$ tsc --noEmit
+
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/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
+ℹ Cleaning 6 files
+ℹ dist/generate.js                          1.34 kB │ gzip: 0.78 kB
+ℹ dist/docs/content-generation.docblock.js  1.15 kB │ gzip: 0.62 kB
+ℹ dist/example.js                           0.57 kB │ gzip: 0.33 kB
+ℹ dist/index.js                             0.17 kB │ gzip: 0.12 kB
+ℹ dist/docs/index.js                        0.04 kB │ gzip: 0.06 kB
+ℹ 5 files, total: 3.26 kB
+✔ Build complete in 49ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.content-generation
 
-## 0.0.0-canary-20251217060834
+## 0.0.0-canary-20251217062943
 
 ### Minor Changes
 
@@ -9,6 +9,6 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/lib.content-gen@0.0.0-canary-20251217060834
-  - @lssm/lib.contracts@0.0.0-canary-20251217060834
-  - @lssm/lib.logger@0.0.0-canary-20251217060834
+  - @lssm/lib.content-gen@0.0.0-canary-20251217062943
+  - @lssm/lib.contracts@0.0.0-canary-20251217062943
+  - @lssm/lib.logger@0.0.0-canary-20251217062943

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

@@ -1,4 +1,4 @@
-import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{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
+import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{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).
 

package/dist/generate.js

@@ -1 +1 @@
-import{BlogGenerator as e,EmailCampaignGenerator as t,LandingPageGenerator as n,SocialPostGenerator as r}from"@lssm/lib.content-gen/generators";import{SeoOptimizer as i}from"@lssm/lib.content-gen/seo";import{LogLevel as a,Logger as o}from"@lssm/lib.logger";const s=new o({level:process.env.NODE_ENV===`production`?a.INFO:a.DEBUG,environment:process.env.NODE_ENV||`development`,enableColors:process.env.NODE_ENV!==`production`});async function c(){let a={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`},o=await new e().generate(a),c=await new n().generate(a),l=await new t().generate({brief:a,variant:`announcement`}),u=await new r().generate(a),d=new i().optimize(a);s.info(`Generated content assets`,{blogIntro:o.intro,landingHero:c.hero,emailSubject:l.subject,socialPosts:u.map(e=>e.body),seo:d})}export{c as runContentGenerationExample};
+import{e}from"./libs/content-gen/dist/generators/blog.js";import{e as t}from"./libs/content-gen/dist/generators/landing-page.js";import{e as n}from"./libs/content-gen/dist/generators/email.js";import{e as r}from"./libs/content-gen/dist/generators/social.js";import{e as i}from"./libs/content-gen/dist/seo/optimizer.js";import{e as a}from"./libs/logger/dist/types.js";import{o}from"./libs/logger/dist/logger.node.js";import"./libs/logger/dist/index.js";const s=new o({level:process.env.NODE_ENV===`production`?a.INFO:a.DEBUG,environment:process.env.NODE_ENV||`development`,enableColors:process.env.NODE_ENV!==`production`});async function c(){let a={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`},o=await new e().generate(a),c=await new t().generate(a),l=await new n().generate({brief:a,variant:`announcement`}),u=await new r().generate(a),d=new i().optimize(a);s.info(`Generated content assets`,{blogIntro:o.intro,landingHero:c.hero,emailSubject:l.subject,socialPosts:u.map(e=>e.body),seo:d})}export{c as runContentGenerationExample};

package/dist/libs/content-gen/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};

package/dist/libs/content-gen/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};

package/dist/libs/content-gen/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};

package/dist/libs/content-gen/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.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};

package/dist/libs/content-gen/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};

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

@@ -0,0 +1,76 @@
+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.
+`}]);