blodemd 0.0.10 → 0.0.12

package/packages/@repo/models/src/docs-config.ts

@@ -1,6 +1,10 @@
 import { z } from "zod";
 
 const UrlOrPathSchema = z.string().min(1);
+const SlugSchema = z
+  .string()
+  .min(1)
+  .regex(/^[a-z0-9-]+$/);
 
 export const DocsColorsSchema = z
   .object({
@@ -364,6 +368,7 @@ export const ContextualBuiltinOptionSchema = z.enum([
   "cursor",
   "devin",
   "devin-mcp",
+  "gemini",
   "grok",
   "mcp",
   "perplexity",
@@ -432,6 +437,7 @@ export const DocsConfigSchema = z
     navigation: MintlifyNavigationSchema,
     search: MintlifySearchSchema.optional(),
     seo: DocsSeoSchema.optional(),
+    slug: SlugSchema.optional(),
   })
   .strict();
 
@@ -610,6 +616,7 @@ export const SiteConfigSchema = z
     openapiProxy: DocsOpenApiProxySchema.optional(),
     scripts: DocsScriptsSchema.optional(),
     seo: DocsSeoSchema.optional(),
+    slug: SlugSchema.optional(),
     theme: z.string().optional(),
   })
   .strict();

package/packages/@repo/previewing/dist/index.d.ts

@@ -12,7 +12,10 @@ export declare const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
 export declare const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export declare const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export declare const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export declare const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export declare const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
 export declare const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export declare const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 export type SiteConfigResult = {
     ok: true;
     config: SiteConfig;
@@ -81,6 +84,7 @@ export interface UtilityIndex {
     description?: string;
     name: string;
     pages: UtilityPage[];
+    slug?: string;
 }
 export interface UtilityArtifact {
     content: string;

package/packages/@repo/previewing/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,WAAW,EAEX,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACX,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAC9D,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAC7C,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;CACnB;AAID,eAAO,MAAM,oBAAoB,GAC/B,OAAO,YAAY,KAClB,GAAG,CAAC,MAAM,EAAE,YAAY,CAoD1B,CAAC;AAgTF,eAAO,MAAM,cAAc,GACzB,QAAQ,aAAa,KACpB,OAAO,CAAC,gBAAgB,CAU1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,aAAa,EACrB,cAAc,MAAM,oBACkB,CAAC;AAyLzC,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,aAAa,EACrB,QAAQ,UAAU,KACjB,OAAO,CAAC,YAAY,CAkFtB,CAAC;AAuCF,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,OAAO,EAwBlD,CAAC;AAiBF,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,WAO/D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,KAAK,MAAM,EACX,QAAQ,MAAM,WAQf,CAAC;AA2QF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,YAAY,EACnB,QAAQ,UAAU,EAClB,eAAe,YAAY,KAC1B,eAAe,EAyBjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,OAAO,YAAY,EACnB,QAAQ,aAAa,EACrB,QAAQ,UAAU,KACjB,OAAO,CAAC,YAAY,CAuCtB,CAAC;AAaF,eAAO,MAAM,6BAA6B,GAAI,MAAM,MAAM,WAGzD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,YAAY,KAClB,eAAe,EAuDjB,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,YAAY,EACnB,QAAQ,aAAa,KACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAahC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,YAAY,KAAG,MAKvB,CAAC;AAEtC,eAAO,MAAM,qBAAqB,GAChC,SAAS,oBAAoB,EAAE,KAC9B,MAIkC,CAAC;AAEtC,eAAO,MAAM,wBAAwB,GACnC,QAAQ,aAAa,KACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CA8B7B,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,aAAa,KACpB,OAAO,CAAC,oBAAoB,EAAE,GAAG,IAAI,CAYvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,eAAe,EAAE,KAAG,MAI5B,CAAC;AAErC,eAAO,MAAM,uBAAuB,GAClC,QAAQ,aAAa,KACpB,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAYlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,KAClC,MAI8B,CAAC;AAElC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,KACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAYvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,YAAY,KAAG,MAIvB,CAAC;AAEtC,eAAO,MAAM,wBAAwB,GACnC,QAAQ,aAAa,KACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CAoB7B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/packages/@repo/previewing/dist/index.js

@@ -14,7 +14,10 @@ export const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
 export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
 export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 const validModes = new Set(PageModeSchema.options);
 export const buildPageMetadataMap = (index) => {
     const map = new Map();
@@ -203,8 +206,10 @@ const mapDocsConfig = (docs) => {
                 Boolean(docs.api?.openapi || docs.api?.asyncapi),
         },
         seo: docs.seo,
+        slug: docs.slug,
     };
 };
+const getProjectWarnings = (config) => config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
 const readJsonConfig = async (source, relativePath) => JSON.parse(await source.readFile(relativePath));
 const normalizeRefPath = (baseDirectory, reference) => {
     if (reference.startsWith("/") ||
@@ -277,7 +282,7 @@ const loadDocsConfig = async (source) => {
             return {
                 config: siteResult.data,
                 ok: true,
-                warnings: [],
+                warnings: getProjectWarnings(siteResult.data),
             };
         }
         // Fall back to DocsConfig format (Mintlify-compatible) and map to SiteConfig
@@ -286,7 +291,7 @@ const loadDocsConfig = async (source) => {
             return {
                 config: mapDocsConfig(docsResult.data),
                 ok: true,
-                warnings: [],
+                warnings: getProjectWarnings(docsResult.data),
             };
         }
         return { errors: docsResult.errors, ok: false };
@@ -777,6 +782,7 @@ export const buildUtilityIndex = async (index, source, config) => {
         description: config.description,
         name: config.name,
         pages: sortedPages,
+        slug: config.slug,
     };
 };
 const toUtilityDocPath = (value) => {
@@ -797,6 +803,7 @@ export const buildUtilityArtifacts = (index) => {
         index.description ? `> ${index.description}` : null,
         "",
         `Sitemap: ${toUtilityTemplatedDocUrl("sitemap.xml")}`,
+        `Skills: ${UTILITY_DOCS_ROOT_TOKEN}/.well-known/skills/index.json`,
         "",
         "## Docs",
         ...index.pages.map((page) => {
@@ -813,6 +820,40 @@ ${index.pages
     const llmsFull = index.pages
         .map((page) => formatMarkdownPageSection(page.title, toUtilityTemplatedDocUrl(page.slug), page.content))
         .join("\n\n");
+    const skillSlug = index.slug ?? slugify(index.name);
+    const skillDescription = `${index.name} documentation. ${index.description ?? ""}`.trim();
+    const skillsIndex = JSON.stringify({
+        skills: [
+            {
+                description: skillDescription,
+                files: ["SKILL.md"],
+                name: skillSlug,
+            },
+        ],
+    }, null, 2);
+    const topPages = index.pages.slice(0, 20);
+    const skillMdLines = [
+        "---",
+        `name: ${skillSlug}`,
+        `description: ${skillDescription} Use when working with ${index.name}, answering questions about its features, or helping users follow its guides.`,
+        "---",
+        "",
+        `# ${index.name}`,
+        "",
+        index.description ? `${index.description}\n` : "",
+        "## Documentation",
+        "",
+        `- Full docs index: ${UTILITY_DOCS_ROOT_TOKEN}/llms.txt`,
+        `- Complete docs content: ${UTILITY_DOCS_ROOT_TOKEN}/llms-full.txt`,
+        "- Append `.md` to any page URL for raw markdown",
+        "",
+        "## Key Pages",
+        "",
+        ...topPages.map((page) => {
+            const desc = page.description ? ` - ${page.description}` : "";
+            return `- [${page.title}](${toUtilityTemplatedDocUrl(page.slug)})${desc}`;
+        }),
+    ];
     return [
         {
             content: sitemap,
@@ -829,6 +870,16 @@ ${index.pages
             contentType: "text/plain; charset=utf-8",
             path: PREBUILT_UTILITY_LLMS_FULL_PATH,
         },
+        {
+            content: skillsIndex,
+            contentType: "application/json; charset=utf-8",
+            path: PREBUILT_UTILITY_SKILLS_INDEX_PATH,
+        },
+        {
+            content: skillMdLines.filter((line) => line !== null).join("\n"),
+            contentType: "text/markdown; charset=utf-8",
+            path: `${PREBUILT_UTILITY_SKILLS_MD_PREFIX}${skillSlug}/SKILL.md`,
+        },
         ...index.pages.map((page) => ({
             content: formatMarkdownPage(page.title, page.content),
             contentType: "text/markdown; charset=utf-8",

package/packages/@repo/previewing/src/index.ts

@@ -39,7 +39,11 @@ export const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
 export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
 export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
+export const LEGACY_PROJECT_NAME_FALLBACK_WARNING =
+  "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 
 export type SiteConfigResult =
   | { ok: true; config: SiteConfig; warnings: string[] }
@@ -113,6 +117,7 @@ export interface UtilityIndex {
   description?: string;
   name: string;
   pages: UtilityPage[];
+  slug?: string;
 }
 
 export interface UtilityArtifact {
@@ -334,9 +339,13 @@ const mapDocsConfig = (docs: DocsConfig): SiteConfig => {
         Boolean(docs.api?.openapi || docs.api?.asyncapi),
     },
     seo: docs.seo,
+    slug: docs.slug,
   };
 };
 
+const getProjectWarnings = (config: { slug?: string }): string[] =>
+  config.slug ? [] : [LEGACY_PROJECT_NAME_FALLBACK_WARNING];
+
 const readJsonConfig = async (source: ContentSource, relativePath: string) =>
   JSON.parse(await source.readFile(relativePath)) as unknown;
 
@@ -463,7 +472,7 @@ const loadDocsConfig = async (
       return {
         config: siteResult.data,
         ok: true,
-        warnings: [],
+        warnings: getProjectWarnings(siteResult.data),
       };
     }
 
@@ -473,7 +482,7 @@ const loadDocsConfig = async (
       return {
         config: mapDocsConfig(docsResult.data),
         ok: true,
-        warnings: [],
+        warnings: getProjectWarnings(docsResult.data),
       };
     }
 
@@ -1217,6 +1226,7 @@ export const buildUtilityIndex = async (
     description: config.description,
     name: config.name,
     pages: sortedPages,
+    slug: config.slug,
   };
 };
 
@@ -1244,6 +1254,7 @@ export const buildUtilityArtifacts = (
     index.description ? `> ${index.description}` : null,
     "",
     `Sitemap: ${toUtilityTemplatedDocUrl("sitemap.xml")}`,
+    `Skills: ${UTILITY_DOCS_ROOT_TOKEN}/.well-known/skills/index.json`,
     "",
     "## Docs",
     ...index.pages.map((page) => {
@@ -1271,6 +1282,47 @@ ${index.pages
     )
     .join("\n\n");
 
+  const skillSlug = index.slug ?? slugify(index.name);
+  const skillDescription =
+    `${index.name} documentation. ${index.description ?? ""}`.trim();
+  const skillsIndex = JSON.stringify(
+    {
+      skills: [
+        {
+          description: skillDescription,
+          files: ["SKILL.md"],
+          name: skillSlug,
+        },
+      ],
+    },
+    null,
+    2
+  );
+
+  const topPages = index.pages.slice(0, 20);
+  const skillMdLines = [
+    "---",
+    `name: ${skillSlug}`,
+    `description: ${skillDescription} Use when working with ${index.name}, answering questions about its features, or helping users follow its guides.`,
+    "---",
+    "",
+    `# ${index.name}`,
+    "",
+    index.description ? `${index.description}\n` : "",
+    "## Documentation",
+    "",
+    `- Full docs index: ${UTILITY_DOCS_ROOT_TOKEN}/llms.txt`,
+    `- Complete docs content: ${UTILITY_DOCS_ROOT_TOKEN}/llms-full.txt`,
+    "- Append `.md` to any page URL for raw markdown",
+    "",
+    "## Key Pages",
+    "",
+    ...topPages.map((page) => {
+      const desc = page.description ? ` - ${page.description}` : "";
+      return `- [${page.title}](${toUtilityTemplatedDocUrl(page.slug)})${desc}`;
+    }),
+  ];
+
   return [
     {
       content: sitemap,
@@ -1287,6 +1339,16 @@ ${index.pages
       contentType: "text/plain; charset=utf-8",
       path: PREBUILT_UTILITY_LLMS_FULL_PATH,
     },
+    {
+      content: skillsIndex,
+      contentType: "application/json; charset=utf-8",
+      path: PREBUILT_UTILITY_SKILLS_INDEX_PATH,
+    },
+    {
+      content: skillMdLines.filter((line) => line !== null).join("\n"),
+      contentType: "text/markdown; charset=utf-8",
+      path: `${PREBUILT_UTILITY_SKILLS_MD_PREFIX}${skillSlug}/SKILL.md`,
+    },
     ...index.pages.map((page) => ({
       content: formatMarkdownPage(page.title, page.content),
       contentType: "text/markdown; charset=utf-8",

package/packages/@repo/validation/src/blodemd-docs-schema.json

@@ -3233,7 +3233,7 @@
     "name": {
       "type": "string",
       "minLength": 1,
-      "description": "The name of the project, organization, or product"
+      "description": "Display name for your site, project, or organization."
     },
     "description": {
       "type": "string",
@@ -3476,6 +3476,7 @@
                   "cursor",
                   "devin",
                   "devin-mcp",
+                  "gemini",
                   "grok",
                   "mcp",
                   "perplexity",
@@ -3561,6 +3562,12 @@
       },
       "additionalProperties": false,
       "description": "Metadata configuration for documentation pages"
+    },
+    "slug": {
+      "description": "URL-safe project slug used for deployments and the default `{slug}.blode.md` hostname.",
+      "minLength": 1,
+      "pattern": "^[a-z0-9-]+$",
+      "type": "string"
     }
   },
   "required": ["name", "navigation"],

package/scripts/prepare-package.mjs

@@ -5,6 +5,8 @@ import { existsSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
+import { REPO_PACKAGES } from "./repo-packages.mjs";
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const cliRoot = path.resolve(__dirname, "..");
 const repoRoot = path.resolve(cliRoot, "../..");
@@ -28,6 +30,18 @@ if (!shouldPackage && !isGlobalInstall) {
 
 console.log("Preparing blodemd standalone package...");
 
+// Build @repo/* workspace packages first so tsdown can inline their dist/
+// output into the CLI bundle. Without this, tsdown falls back to treating
+// `@repo/common` etc. as external imports and the published tarball ships
+// unresolved imports that break `npx blodemd`.
+console.log("Building @repo packages...");
+for (const pkg of REPO_PACKAGES) {
+  execSync("npm run build", {
+    cwd: path.join(repoRoot, `packages/${pkg}`),
+    stdio: "inherit",
+  });
+}
+
 execSync("npm run build", {
   cwd: cliRoot,
   stdio: "inherit",

package/packages/@repo/contracts/dist/api-key.d.ts

@@ -1,30 +0,0 @@
-import { z } from "zod";
-export declare const ApiKeySchema: z.ZodObject<{
-    createdAt: z.ZodString;
-    id: z.ZodString;
-    lastUsedAt: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    prefix: z.ZodString;
-    projectId: z.ZodString;
-    revokedAt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type ApiKey = z.infer<typeof ApiKeySchema>;
-export declare const ApiKeyCreateSchema: z.ZodObject<{
-    name: z.ZodString;
-    projectId: z.ZodString;
-}, z.core.$strip>;
-export type ApiKeyCreateInput = z.infer<typeof ApiKeyCreateSchema>;
-export declare const ApiKeyCreateResponseSchema: z.ZodObject<{
-    apiKey: z.ZodObject<{
-        createdAt: z.ZodString;
-        id: z.ZodString;
-        lastUsedAt: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        prefix: z.ZodString;
-        projectId: z.ZodString;
-        revokedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    token: z.ZodString;
-}, z.core.$strip>;
-export type ApiKeyCreateResponse = z.infer<typeof ApiKeyCreateResponseSchema>;
-//# sourceMappingURL=api-key.d.ts.map

package/packages/@repo/contracts/dist/api-key.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../src/api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,YAAY;;;;;;;;iBAQvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,eAAO,MAAM,0BAA0B;;;;;;;;;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/packages/@repo/contracts/dist/api-key.js

@@ -1,20 +0,0 @@
-import { z } from "zod";
-import { IsoDateSchema } from "./dates.js";
-import { IdSchema } from "./ids.js";
-export const ApiKeySchema = z.object({
-    createdAt: IsoDateSchema,
-    id: IdSchema,
-    lastUsedAt: IsoDateSchema.optional(),
-    name: z.string().min(1),
-    prefix: z.string().min(1),
-    projectId: IdSchema,
-    revokedAt: IsoDateSchema.optional(),
-});
-export const ApiKeyCreateSchema = z.object({
-    name: z.string().min(1),
-    projectId: IdSchema,
-});
-export const ApiKeyCreateResponseSchema = z.object({
-    apiKey: ApiKeySchema,
-    token: z.string().min(1),
-});

package/packages/@repo/contracts/src/api-key.ts

@@ -1,27 +0,0 @@
-import { z } from "zod";
-
-import { IsoDateSchema } from "./dates.js";
-import { IdSchema } from "./ids.js";
-
-export const ApiKeySchema = z.object({
-  createdAt: IsoDateSchema,
-  id: IdSchema,
-  lastUsedAt: IsoDateSchema.optional(),
-  name: z.string().min(1),
-  prefix: z.string().min(1),
-  projectId: IdSchema,
-  revokedAt: IsoDateSchema.optional(),
-});
-export type ApiKey = z.infer<typeof ApiKeySchema>;
-
-export const ApiKeyCreateSchema = z.object({
-  name: z.string().min(1),
-  projectId: IdSchema,
-});
-export type ApiKeyCreateInput = z.infer<typeof ApiKeyCreateSchema>;
-
-export const ApiKeyCreateResponseSchema = z.object({
-  apiKey: ApiKeySchema,
-  token: z.string().min(1),
-});
-export type ApiKeyCreateResponse = z.infer<typeof ApiKeyCreateResponseSchema>;