@kb-labs/scaffold 2.29.0

package/dist/commands/doctor.d.ts

@@ -0,0 +1,15 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { scanRoot } from '@kb-labs/scaffold-core';
+
+interface DoctorFlags {
+    path?: string;
+    json?: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, DoctorFlags, {
+    packagesScanned: number;
+    findings: ReturnType<typeof scanRoot> extends Promise<infer R> ? R extends {
+        findings: infer F;
+    } ? F : never : never;
+}>;
+
+export { _default as default };

package/dist/commands/doctor.js

@@ -0,0 +1,63 @@
+import { resolve } from 'path';
+import { defineCommand } from '@kb-labs/sdk';
+import { scanRoot } from '@kb-labs/scaffold-core';
+
+// src/commands/doctor.ts
+var GLYPH = {
+  info: "\u2139",
+  warn: "\u26A0",
+  error: "\u2717"
+};
+var doctor_default = defineCommand({
+  id: "scaffold:doctor",
+  description: "Scan user-authored plugins for common issues",
+  handler: {
+    async execute(ctx, input) {
+      const root = resolve(input.path ?? ".kb/plugins");
+      const workspaceRoot = ctx.cwd ?? process.cwd();
+      const scan = await scanRoot(root, { workspaceRoot });
+      const hasErrors = scan.findings.some((f) => f.severity === "error");
+      if (input.json) {
+        ctx.ui?.json?.({
+          root,
+          packagesScanned: scan.packagesScanned,
+          findings: scan.findings
+        });
+      } else {
+        ctx.ui?.info?.(
+          `Scanned ${scan.packagesScanned} package(s) under ${root}`
+        );
+        if (scan.findings.length === 0) {
+          ctx.ui?.success?.("No issues found.");
+        } else {
+          const byPkg = /* @__PURE__ */ new Map();
+          for (const f of scan.findings) {
+            const list = byPkg.get(f.package) ?? [];
+            list.push(f);
+            byPkg.set(f.package, list);
+          }
+          for (const [pkg, list] of byPkg) {
+            ctx.ui?.info?.(`
+  ${pkg}`);
+            for (const f of list) {
+              ctx.ui?.info?.(
+                `    ${GLYPH[f.severity] ?? "-"} ${f.severity.toUpperCase()}: ${f.message}`
+              );
+            }
+          }
+        }
+      }
+      return {
+        exitCode: hasErrors ? 1 : 0,
+        result: {
+          packagesScanned: scan.packagesScanned,
+          findings: scan.findings
+        }
+      };
+    }
+  }
+});
+
+export { doctor_default as default };
+//# sourceMappingURL=doctor.js.map
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/doctor.ts"],"names":[],"mappings":";;;;;AAqBA,IAAM,KAAA,GAAgC;AAAA,EACpC,IAAA,EAAM,QAAA;AAAA,EACN,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO;AACT,CAAA;AAEA,IAAO,iBAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,iBAAA;AAAA,EACJ,WAAA,EAAa,8CAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACuB;AACvB,MAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,KAAA,CAAM,IAAA,IAAQ,aAAa,CAAA;AAChD,MAAA,MAAM,aAAA,GAAgB,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAC7C,MAAA,MAAM,OAAO,MAAM,QAAA,CAAS,IAAA,EAAM,EAAE,eAAe,CAAA;AAEnD,MAAA,MAAM,SAAA,GAAY,KAAK,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,aAAa,OAAO,CAAA;AAElE,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,IAAI,IAAA,GAAO;AAAA,UACb,IAAA;AAAA,UACA,iBAAiB,IAAA,CAAK,eAAA;AAAA,UACtB,UAAU,IAAA,CAAK;AAAA,SAChB,CAAA;AAAA,MACH,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,EAAA,EAAI,IAAA;AAAA,UACN,CAAA,QAAA,EAAW,IAAA,CAAK,eAAe,CAAA,kBAAA,EAAqB,IAAI,CAAA;AAAA,SAC1D;AACA,QAAA,IAAI,IAAA,CAAK,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG;AAC9B,UAAA,GAAA,CAAI,EAAA,EAAI,UAAU,kBAAkB,CAAA;AAAA,QACtC,CAAA,MAAO;AACL,UAAA,MAAM,KAAA,uBAAY,GAAA,EAAkC;AACpD,UAAA,KAAA,MAAW,CAAA,IAAK,KAAK,QAAA,EAAU;AAC7B,YAAA,MAAM,OAAO,KAAA,CAAM,GAAA,CAAI,CAAA,CAAE,OAAO,KAAK,EAAC;AACtC,YAAA,IAAA,CAAK,KAAK,CAAC,CAAA;AACX,YAAA,KAAA,CAAM,GAAA,CAAI,CAAA,CAAE,OAAA,EAAS,IAAI,CAAA;AAAA,UAC3B;AACA,UAAA,KAAA,MAAW,CAAC,GAAA,EAAK,IAAI,CAAA,IAAK,KAAA,EAAO;AAC/B,YAAA,GAAA,CAAI,IAAI,IAAA,GAAO;AAAA,EAAA,EAAO,GAAG,CAAA,CAAE,CAAA;AAC3B,YAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,cAAA,GAAA,CAAI,EAAA,EAAI,IAAA;AAAA,gBACN,CAAA,IAAA,EAAO,KAAA,CAAM,CAAA,CAAE,QAAQ,CAAA,IAAK,GAAG,CAAA,CAAA,EAAI,CAAA,CAAE,QAAA,CAAS,WAAA,EAAa,CAAA,EAAA,EAAK,EAAE,OAAO,CAAA;AAAA,eAC3E;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,YAAY,CAAA,GAAI,CAAA;AAAA,QAC1B,MAAA,EAAQ;AAAA,UACN,iBAAiB,IAAA,CAAK,eAAA;AAAA,UACtB,UAAU,IAAA,CAAK;AAAA;AACjB,OACF;AAAA,IACF;AAAA;AAEJ,CAAC","file":"doctor.js","sourcesContent":["import { resolve } from 'node:path';\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { scanRoot } from '@kb-labs/scaffold-core';\n\ninterface DoctorFlags {\n  path?: string;\n  json?: boolean;\n}\n\ntype DoctorResult = {\n  exitCode: number;\n  result?: {\n    packagesScanned: number;\n    findings: ReturnType<typeof scanRoot> extends Promise<infer R>\n      ? R extends { findings: infer F }\n        ? F\n        : never\n      : never;\n  };\n};\n\nconst GLYPH: Record<string, string> = {\n  info: 'ℹ',\n  warn: '⚠',\n  error: '✗',\n};\n\nexport default defineCommand({\n  id: 'scaffold:doctor',\n  description: 'Scan user-authored plugins for common issues',\n\n  handler: {\n    async execute(\n      ctx: PluginContextV3,\n      input: DoctorFlags,\n    ): Promise<DoctorResult> {\n      const root = resolve(input.path ?? '.kb/plugins');\n      const workspaceRoot = ctx.cwd ?? process.cwd();\n      const scan = await scanRoot(root, { workspaceRoot });\n\n      const hasErrors = scan.findings.some((f) => f.severity === 'error');\n\n      if (input.json) {\n        ctx.ui?.json?.({\n          root,\n          packagesScanned: scan.packagesScanned,\n          findings: scan.findings,\n        });\n      } else {\n        ctx.ui?.info?.(\n          `Scanned ${scan.packagesScanned} package(s) under ${root}`,\n        );\n        if (scan.findings.length === 0) {\n          ctx.ui?.success?.('No issues found.');\n        } else {\n          const byPkg = new Map<string, typeof scan.findings>();\n          for (const f of scan.findings) {\n            const list = byPkg.get(f.package) ?? [];\n            list.push(f);\n            byPkg.set(f.package, list);\n          }\n          for (const [pkg, list] of byPkg) {\n            ctx.ui?.info?.(`\\n  ${pkg}`);\n            for (const f of list) {\n              ctx.ui?.info?.(\n                `    ${GLYPH[f.severity] ?? '-'} ${f.severity.toUpperCase()}: ${f.message}`,\n              );\n            }\n          }\n        }\n      }\n\n      return {\n        exitCode: hasErrors ? 1 : 0,\n        result: {\n          packagesScanned: scan.packagesScanned,\n          findings: scan.findings,\n        } as never,\n      };\n    },\n  },\n});\n"]}

package/dist/commands/scaffold.d.ts

@@ -0,0 +1,18 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+interface ScaffoldFlags {
+    blocks?: string;
+    yes?: boolean;
+    force?: boolean;
+    'dry-run'?: boolean;
+    out?: string;
+    scope?: string;
+    mode?: string;
+    argv?: string[];
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, ScaffoldFlags, {
+    outRoot: string;
+    files: number;
+}>;
+
+export { _default as default };

package/dist/commands/scaffold.js

@@ -0,0 +1,196 @@
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+import { readFile } from 'fs/promises';
+import { defineCommand } from '@kb-labs/sdk';
+import { listEntities, loadEntity, runValidator, resolveBlocks, build, inspectTarget, formatTree, writeFiles } from '@kb-labs/scaffold-core';
+import { log, outro as outro$1 } from '@clack/prompts';
+
+// src/commands/scaffold.ts
+function outro(msg) {
+  outro$1(msg);
+}
+function info(msg) {
+  log.info(msg);
+}
+function warn(msg) {
+  log.warn(msg);
+}
+function error(msg) {
+  log.error(msg);
+}
+
+// src/commands/scaffold.ts
+var here = dirname(fileURLToPath(import.meta.url));
+var TEMPLATES_ROOT = resolve(here, "..", "..", "templates");
+async function readVersion(pkgPath) {
+  try {
+    const raw = await readFile(pkgPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var FALLBACK_VERSIONS = {
+  sdk: "2.18.0",
+  devkit: "2.28.0"
+};
+async function detectVersions() {
+  const req = createRequire(import.meta.url);
+  const readPkg = async (spec, fallback) => {
+    try {
+      const resolved = req.resolve(spec);
+      const v = await readVersion(resolved);
+      return v === "0.0.0" ? fallback : v;
+    } catch {
+      return fallback;
+    }
+  };
+  const [sdk, devkit] = await Promise.all([
+    readPkg("@kb-labs/sdk/package.json", FALLBACK_VERSIONS.sdk),
+    readPkg("@kb-labs/devkit/package.json", FALLBACK_VERSIONS.devkit)
+  ]);
+  return { sdk, devkit };
+}
+function parsePositional(argv) {
+  if (!argv || argv.length === 0) return {};
+  const positional = argv.filter((a) => !a.startsWith("-"));
+  return { entity: positional[0], name: positional[1] };
+}
+async function runDefault(ctx, input) {
+  const { entity: entityArg, name: nameArg } = parsePositional(input.argv);
+  const available = await listEntities(TEMPLATES_ROOT);
+  if (available.length === 0) {
+    error(`No entities found in templates root: ${TEMPLATES_ROOT}`);
+    return { exitCode: 1 };
+  }
+  const entityId = entityArg ?? available[0];
+  if (!available.includes(entityId)) {
+    error(`Unknown entity: ${entityId}. Available: ${available.join(", ")}`);
+    return { exitCode: 1 };
+  }
+  const entity = await loadEntity(TEMPLATES_ROOT, entityId);
+  if (!nameArg) {
+    error("Usage: kb scaffold run <entity> <name> [flags]");
+    return { exitCode: 1 };
+  }
+  const problem = runValidator("npmName", nameArg);
+  if (problem) {
+    error(`Invalid name "${nameArg}": ${problem}`);
+    return { exitCode: 1 };
+  }
+  const name = nameArg;
+  const vars = {};
+  for (const v of entity.variables) {
+    if (v.name === "scope" && input.scope !== void 0) {
+      vars[v.name] = input.scope;
+    } else if (v.name === "mode" && input.mode !== void 0) {
+      vars[v.name] = input.mode;
+    } else {
+      vars[v.name] = v.default ?? "";
+    }
+  }
+  let selectedBlocks;
+  if (input.blocks) {
+    selectedBlocks = input.blocks.split(",").map((s) => s.trim()).filter(Boolean);
+  } else {
+    selectedBlocks = entity.defaults?.blocks ?? entity.blocks.map((b) => b.id);
+  }
+  try {
+    resolveBlocks(entity.blocks, selectedBlocks);
+  } catch (e) {
+    error(e.message);
+    return { exitCode: 1 };
+  }
+  for (const blockId of selectedBlocks) {
+    const block = entity.blocks.find((b) => b.id === blockId);
+    for (const v of block?.variables ?? []) {
+      vars[v.name] = v.default ?? "";
+    }
+  }
+  const scope = vars.scope ?? input.scope ?? "";
+  const mode = vars.mode ?? "in-workspace";
+  const versions = await detectVersions();
+  const context = {
+    name,
+    scope,
+    vars,
+    blocks: selectedBlocks,
+    mode,
+    versions
+  };
+  const result = await build({
+    entity,
+    selectedBlockIds: selectedBlocks,
+    context
+  });
+  const outRoot = input.out ?? result.outRoot;
+  const state = await inspectTarget(outRoot);
+  if (input["dry-run"]) {
+    info(`Would write to: ${outRoot}`);
+    info("Tree:");
+    info(formatTree(result.files));
+    outro("Dry run complete.");
+    return { exitCode: 0, result: { outRoot, files: result.files.length } };
+  }
+  if (state.exists && !state.empty) {
+    if (input.force) {
+      warn(`--force: overwriting ${outRoot}`);
+    } else {
+      error(`Target "${outRoot}" is not empty. Use --force to overwrite.`);
+      return { exitCode: 1 };
+    }
+  }
+  await writeFiles({ outRoot, files: result.files, force: input.force });
+  ctx.ui?.success?.(`Scaffolded ${entityId} "${name}"`);
+  info(`Output: ${outRoot}`);
+  const entryPkgDir = entityId === "plugin" ? `${outRoot}/packages/${name}-entry` : outRoot;
+  const linked = await linkWithMarketplace(ctx, entryPkgDir);
+  if (linked === "ok") {
+    info("Registered in .kb/marketplace.lock");
+  } else if (linked === "no-shell") {
+    warn("Could not auto-register (no shell). Run manually:");
+    info(`  kb marketplace plugins link ${entryPkgDir}`);
+  } else {
+    warn("Auto-register failed \u2014 register manually:");
+    info(`  kb marketplace plugins link ${entryPkgDir}`);
+  }
+  info("Next steps:");
+  info("  pnpm install");
+  info("  pnpm -w build");
+  info(`  pnpm kb ${name} hello   # try it`);
+  info(`  pnpm kb scaffold doctor --path ${dirname(outRoot)}`);
+  outro("Done.");
+  return {
+    exitCode: 0,
+    result: { outRoot, files: result.files.length }
+  };
+}
+async function linkWithMarketplace(ctx, entryPkgDir) {
+  const shell = ctx.api?.shell;
+  if (!shell?.exec) {
+    return "no-shell";
+  }
+  try {
+    const res = await shell.exec(
+      "kb",
+      ["marketplace", "plugins", "link", entryPkgDir],
+      { timeout: 6e4 }
+    );
+    return res.ok ? "ok" : "failed";
+  } catch {
+    return "failed";
+  }
+}
+var scaffold_default = defineCommand({
+  id: "scaffold:run",
+  description: "Scaffold <entity> <name> from blocks",
+  handler: {
+    execute: runDefault
+  }
+});
+
+export { scaffold_default as default };
+//# sourceMappingURL=scaffold.js.map
+//# sourceMappingURL=scaffold.js.map

package/dist/commands/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ui/prompt.ts","../../src/commands/scaffold.ts"],"names":["clackOutro","runValidator"],"mappings":"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","file":"scaffold.js","sourcesContent":["import {\n  intro as clackIntro,\n  outro as clackOutro,\n  text,\n  confirm,\n  select,\n  multiselect,\n  isCancel,\n  cancel,\n  log,\n} from '@clack/prompts';\nimport type { Variable } from '@kb-labs/scaffold-contracts';\nimport { runValidator } from '@kb-labs/scaffold-core';\n\nexport function intro(msg: string): void {\n  clackIntro(msg);\n}\nexport function outro(msg: string): void {\n  clackOutro(msg);\n}\n\nexport function info(msg: string): void {\n  log.info(msg);\n}\nexport function warn(msg: string): void {\n  log.warn(msg);\n}\nexport function error(msg: string): void {\n  log.error(msg);\n}\n\nfunction abortOnCancel<T>(value: T | symbol): T {\n  if (isCancel(value)) {\n    cancel('Aborted.');\n    process.exit(130);\n  }\n  return value as T;\n}\n\nexport async function askVariable(\n  variable: Variable,\n  defaults: Record<string, unknown>,\n): Promise<unknown> {\n  const preset = defaults[variable.name] ?? variable.default;\n\n  switch (variable.type) {\n    case 'boolean': {\n      const result = await confirm({\n        message: variable.describe,\n        initialValue: typeof preset === 'boolean' ? preset : false,\n      });\n      return abortOnCancel(result);\n    }\n    case 'select': {\n      if (!variable.choices || variable.choices.length === 0) {\n        throw new Error(`Variable \"${variable.name}\" is select but has no choices`);\n      }\n      const result = await select({\n        message: variable.describe,\n        options: variable.choices.map((c) => ({ value: c.value, label: c.label })),\n        initialValue: (preset as string) ?? variable.choices[0]?.value,\n      });\n      return abortOnCancel(result);\n    }\n    case 'multiselect': {\n      if (!variable.choices || variable.choices.length === 0) {\n        throw new Error(`Variable \"${variable.name}\" is multiselect but has no choices`);\n      }\n      const result = await multiselect({\n        message: variable.describe,\n        options: variable.choices.map((c) => ({ value: c.value, label: c.label })),\n        initialValues: Array.isArray(preset) ? (preset as string[]) : [],\n        required: false,\n      });\n      return abortOnCancel(result);\n    }\n    case 'string':\n    default: {\n      const result = await text({\n        message: variable.describe,\n        initialValue: typeof preset === 'string' ? preset : '',\n        validate: variable.validate\n          ? (value: string) => runValidator(variable.validate!, value) ?? undefined\n          : undefined,\n      });\n      return abortOnCancel(result);\n    }\n  }\n}\n\nexport async function askBlocks(\n  options: { value: string; label: string; hint?: string }[],\n  initialValues: string[],\n): Promise<string[]> {\n  const result = await multiselect({\n    message: 'Pick blocks to include',\n    options,\n    initialValues,\n    required: true,\n  });\n  return abortOnCancel(result) as string[];\n}\n\nexport async function confirmOverwrite(path: string): Promise<boolean> {\n  const result = await confirm({\n    message: `Target \"${path}\" is not empty. Overwrite?`,\n    initialValue: false,\n  });\n  return abortOnCancel(result);\n}\n","import { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { createRequire } from 'node:module';\nimport { readFile } from 'node:fs/promises';\nimport {\n  defineCommand,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport {\n  build,\n  inspectTarget,\n  formatTree,\n  listEntities,\n  loadEntity,\n  resolveBlocks,\n  runValidator,\n  writeFiles,\n} from '@kb-labs/scaffold-core';\nimport type {\n  RenderContext,\n} from '@kb-labs/scaffold-contracts';\nimport {\n  error,\n  info,\n  outro,\n  warn,\n} from '../ui/prompt.js';\n\nconst here = dirname(fileURLToPath(import.meta.url));\nconst TEMPLATES_ROOT = resolve(here, '..', '..', 'templates');\n\ninterface ScaffoldFlags {\n  blocks?: string;\n  yes?: boolean;\n  force?: boolean;\n  'dry-run'?: boolean;\n  out?: string;\n  scope?: string;\n  mode?: string;\n  argv?: string[];\n}\n\ntype ScaffoldResult = {\n  exitCode: number;\n  result?: { outRoot: string; files: number };\n};\n\nasync function readVersion(pkgPath: string): Promise<string> {\n  try {\n    const raw = await readFile(pkgPath, 'utf8');\n    const parsed = JSON.parse(raw) as { version?: string };\n    return parsed.version ?? '0.0.0';\n  } catch {\n    return '0.0.0';\n  }\n}\n\n// Conservative fallbacks — bumped when we cut a new scaffold release.\nconst FALLBACK_VERSIONS = {\n  sdk: '2.18.0',\n  devkit: '2.28.0',\n} as const;\n\nasync function detectVersions(): Promise<Record<string, string>> {\n  // Use require.resolve from this module as the anchor. Works under pnpm's\n  // virtual store because createRequire follows node's resolution rules.\n  const req = createRequire(import.meta.url);\n  const readPkg = async (\n    spec: string,\n    fallback: string,\n  ): Promise<string> => {\n    try {\n      const resolved = req.resolve(spec);\n      const v = await readVersion(resolved);\n      return v === '0.0.0' ? fallback : v;\n    } catch {\n      return fallback;\n    }\n  };\n  const [sdk, devkit] = await Promise.all([\n    readPkg('@kb-labs/sdk/package.json', FALLBACK_VERSIONS.sdk),\n    readPkg('@kb-labs/devkit/package.json', FALLBACK_VERSIONS.devkit),\n  ]);\n  return { sdk, devkit };\n}\n\nfunction parsePositional(argv: string[] | undefined): {\n  entity?: string;\n  name?: string;\n} {\n  if (!argv || argv.length === 0) return {};\n  const positional = argv.filter((a) => !a.startsWith('-'));\n  return { entity: positional[0], name: positional[1] };\n}\n\nasync function runDefault(\n  ctx: PluginContextV3,\n  input: ScaffoldFlags,\n): Promise<ScaffoldResult> {\n  const { entity: entityArg, name: nameArg } = parsePositional(input.argv);\n\n  const available = await listEntities(TEMPLATES_ROOT);\n  if (available.length === 0) {\n    error(`No entities found in templates root: ${TEMPLATES_ROOT}`);\n    return { exitCode: 1 };\n  }\n\n  // Resolve entity.\n  const entityId = entityArg ?? available[0]!;\n  if (!available.includes(entityId)) {\n    error(`Unknown entity: ${entityId}. Available: ${available.join(', ')}`);\n    return { exitCode: 1 };\n  }\n\n  const entity = await loadEntity(TEMPLATES_ROOT, entityId);\n\n  // Resolve name — required positional.\n  if (!nameArg) {\n    error('Usage: kb scaffold run <entity> <name> [flags]');\n    return { exitCode: 1 };\n  }\n  const problem = runValidator('npmName', nameArg);\n  if (problem) {\n    error(`Invalid name \"${nameArg}\": ${problem}`);\n    return { exitCode: 1 };\n  }\n  const name = nameArg;\n\n  // Collect entity-level variables — flags override, then entity defaults.\n  const vars: Record<string, unknown> = {};\n  for (const v of entity.variables) {\n    if (v.name === 'scope' && input.scope !== undefined) {\n      vars[v.name] = input.scope;\n    } else if (v.name === 'mode' && input.mode !== undefined) {\n      vars[v.name] = input.mode;\n    } else {\n      vars[v.name] = v.default ?? '';\n    }\n  }\n\n  // Select blocks — flag overrides, then entity defaults.\n  let selectedBlocks: string[];\n  if (input.blocks) {\n    selectedBlocks = input.blocks\n      .split(',')\n      .map((s) => s.trim())\n      .filter(Boolean);\n  } else {\n    selectedBlocks = entity.defaults?.blocks ?? entity.blocks.map((b) => b.id);\n  }\n\n  // Collect block-specific variables — use defaults.\n  try {\n    resolveBlocks(entity.blocks, selectedBlocks);\n  } catch (e) {\n    error((e as Error).message);\n    return { exitCode: 1 };\n  }\n  for (const blockId of selectedBlocks) {\n    const block = entity.blocks.find((b) => b.id === blockId);\n    for (const v of block?.variables ?? []) {\n      vars[v.name] = v.default ?? '';\n    }\n  }\n\n  const scope = (vars.scope as string) ?? input.scope ?? '';\n  const mode = ((vars.mode as string) ?? 'in-workspace') as\n    | 'in-workspace'\n    | 'standalone';\n\n  const versions = await detectVersions();\n\n  const context: RenderContext = {\n    name,\n    scope,\n    vars,\n    blocks: selectedBlocks,\n    mode,\n    versions,\n  };\n\n  const result = await build({\n    entity,\n    selectedBlockIds: selectedBlocks,\n    context,\n  });\n\n  const outRoot = input.out ?? result.outRoot;\n  const state = await inspectTarget(outRoot);\n\n  if (input['dry-run']) {\n    info(`Would write to: ${outRoot}`);\n    info('Tree:');\n    info(formatTree(result.files));\n    outro('Dry run complete.');\n    return { exitCode: 0, result: { outRoot, files: result.files.length } };\n  }\n\n  if (state.exists && !state.empty) {\n    if (input.force) {\n      warn(`--force: overwriting ${outRoot}`);\n    } else {\n      error(`Target \"${outRoot}\" is not empty. Use --force to overwrite.`);\n      return { exitCode: 1 };\n    }\n  }\n\n  await writeFiles({ outRoot, files: result.files, force: input.force });\n\n  ctx.ui?.success?.(`Scaffolded ${entityId} \"${name}\"`);\n  info(`Output: ${outRoot}`);\n\n  // The package that carries `\"kb\": { \"manifest\": \"...\" }` is the target\n  // marketplace.link needs. For plugin entity → <outRoot>/packages/<name>-entry.\n  // For adapter entity → <outRoot> itself.\n  const entryPkgDir =\n    entityId === 'plugin'\n      ? `${outRoot}/packages/${name}-entry`\n      : outRoot;\n\n  const linked = await linkWithMarketplace(ctx, entryPkgDir);\n  if (linked === 'ok') {\n    info('Registered in .kb/marketplace.lock');\n  } else if (linked === 'no-shell') {\n    warn('Could not auto-register (no shell). Run manually:');\n    info(`  kb marketplace plugins link ${entryPkgDir}`);\n  } else {\n    warn('Auto-register failed — register manually:');\n    info(`  kb marketplace plugins link ${entryPkgDir}`);\n  }\n\n  info('Next steps:');\n  info('  pnpm install');\n  info('  pnpm -w build');\n  info(`  pnpm kb ${name} hello   # try it`);\n  info(`  pnpm kb scaffold doctor --path ${dirname(outRoot)}`);\n  outro('Done.');\n\n  return {\n    exitCode: 0,\n    result: { outRoot, files: result.files.length },\n  };\n}\n\ntype LinkOutcome = 'ok' | 'no-shell' | 'failed';\n\nasync function linkWithMarketplace(\n  ctx: PluginContextV3,\n  entryPkgDir: string,\n): Promise<LinkOutcome> {\n  const shell = ctx.api?.shell;\n  if (!shell?.exec) {\n    return 'no-shell';\n  }\n  try {\n    const res = await shell.exec(\n      'kb',\n      ['marketplace', 'plugins', 'link', entryPkgDir],\n      { timeout: 60_000 },\n    );\n    return res.ok ? 'ok' : 'failed';\n  } catch {\n    return 'failed';\n  }\n}\n\nexport default defineCommand({\n  id: 'scaffold:run',\n  description: 'Scaffold <entity> <name> from blocks',\n\n  handler: {\n    execute: runDefault,\n  },\n});\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default as manifest } from './manifest.js';
+import '@kb-labs/perm-presets';

package/dist/index.js

@@ -0,0 +1,114 @@
+import { combinePermissions, kbPlatformPreset } from '@kb-labs/sdk';
+
+// src/manifest.ts
+var permissions = combinePermissions().with(kbPlatformPreset).withFs({
+  mode: "readWrite",
+  allow: [
+    ".kb/plugins/**",
+    ".kb/marketplace.lock",
+    "plugins/**",
+    "adapters/**"
+  ]
+}).withShell({
+  // Needed to call `kb marketplace plugins link` after scaffolding,
+  // so the generated plugin lands in .kb/marketplace.lock automatically.
+  allow: ["kb"]
+}).withQuotas({ timeoutMs: 12e4, memoryMb: 256 }).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/scaffold",
+  version: "0.1.0",
+  display: {
+    name: "Scaffold",
+    description: "Generic entity scaffolder for KB Labs plugins, adapters, and friends.",
+    tags: ["scaffold", "generator", "dx"]
+  },
+  cli: {
+    groupMeta: [
+      { name: "scaffold", describe: "Scaffold KB Labs entities" }
+    ],
+    commands: [
+      {
+        id: "run",
+        group: "scaffold",
+        describe: "Scaffold <entity> <name> from blocks",
+        handler: "./commands/scaffold.js#default",
+        handlerPath: "./commands/scaffold.js",
+        flags: [
+          {
+            name: "blocks",
+            type: "string",
+            description: "Comma-separated block ids"
+          },
+          {
+            name: "yes",
+            alias: "y",
+            type: "boolean",
+            description: "Accept defaults and skip prompts"
+          },
+          {
+            name: "force",
+            type: "boolean",
+            description: "Overwrite non-empty target directory"
+          },
+          {
+            name: "dry-run",
+            type: "boolean",
+            description: "Print the tree that would be written and exit"
+          },
+          {
+            name: "out",
+            type: "string",
+            description: "Override the output directory"
+          },
+          {
+            name: "scope",
+            type: "string",
+            description: "npm scope for the generated package"
+          },
+          {
+            name: "mode",
+            type: "string",
+            description: 'Layout mode: "in-workspace" (workspace:* deps) or "standalone" (semver deps + pnpm-workspace.yaml)'
+          }
+        ],
+        examples: [
+          "kb scaffold run plugin my-plugin",
+          "kb scaffold run adapter my-llm --blocks base",
+          "kb scaffold run plugin ui --scope @acme --yes",
+          "kb scaffold run plugin demo --dry-run"
+        ]
+      },
+      {
+        id: "doctor",
+        group: "scaffold",
+        describe: "Scan user plugins for common issues",
+        handler: "./commands/doctor.js#default",
+        handlerPath: "./commands/doctor.js",
+        flags: [
+          {
+            name: "path",
+            type: "string",
+            description: "Path to scan (default: .kb/plugins)"
+          },
+          {
+            name: "json",
+            type: "boolean",
+            description: "Emit JSON instead of text"
+          }
+        ],
+        examples: [
+          "kb scaffold doctor",
+          "kb scaffold doctor --path ./plugins",
+          "kb scaffold doctor --json"
+        ]
+      }
+    ]
+  },
+  permissions
+};
+var manifest_default = manifest;
+
+export { manifest_default as manifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":";;;AAEA,IAAM,cAAc,kBAAA,EAAmB,CACpC,IAAA,CAAK,gBAAgB,EACrB,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,WAAA;AAAA,EACN,KAAA,EAAO;AAAA,IACL,gBAAA;AAAA,IACA,sBAAA;AAAA,IACA,YAAA;AAAA,IACA;AAAA;AAEJ,CAAC,EACA,SAAA,CAAU;AAAA;AAAA;AAAA,EAGT,KAAA,EAAO,CAAC,IAAI;AACd,CAAC,CAAA,CACA,WAAW,EAAE,SAAA,EAAW,MAAQ,QAAA,EAAU,GAAA,EAAK,CAAA,CAC/C,KAAA,EAAM;AAET,IAAM,QAAA,GAAW;AAAA,EACf,MAAA,EAAQ,aAAA;AAAA,EACR,EAAA,EAAI,mBAAA;AAAA,EACJ,OAAA,EAAS,OAAA;AAAA,EACT,OAAA,EAAS;AAAA,IACP,IAAA,EAAM,UAAA;AAAA,IACN,WAAA,EACE,uEAAA;AAAA,IACF,IAAA,EAAM,CAAC,UAAA,EAAY,WAAA,EAAa,IAAI;AAAA,GACtC;AAAA,EACA,GAAA,EAAK;AAAA,IACH,SAAA,EAAW;AAAA,MACT,EAAE,IAAA,EAAM,UAAA,EAAY,QAAA,EAAU,2BAAA;AAA4B,KAC5D;AAAA,IACA,QAAA,EAAU;AAAA,MACR;AAAA,QACE,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,UAAA;AAAA,QACP,QAAA,EAAU,sCAAA;AAAA,QACV,OAAA,EAAS,gCAAA;AAAA,QACT,WAAA,EAAa,wBAAA;AAAA,QACb,KAAA,EAAO;AAAA,UACL;AAAA,YACE,IAAA,EAAM,QAAA;AAAA,YACN,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,KAAA;AAAA,YACN,KAAA,EAAO,GAAA;AAAA,YACP,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,OAAA;AAAA,YACN,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,SAAA;AAAA,YACN,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,KAAA;AAAA,YACN,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,OAAA;AAAA,YACN,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,MAAA;AAAA,YACN,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EACE;AAAA;AACJ,SACF;AAAA,QACA,QAAA,EAAU;AAAA,UACR,kCAAA;AAAA,UACA,8CAAA;AAAA,UACA,+CAAA;AAAA,UACA;AAAA;AACF,OACF;AAAA,MACA;AAAA,QACE,EAAA,EAAI,QAAA;AAAA,QACJ,KAAA,EAAO,UAAA;AAAA,QACP,QAAA,EAAU,qCAAA;AAAA,QACV,OAAA,EAAS,8BAAA;AAAA,QACT,WAAA,EAAa,sBAAA;AAAA,QACb,KAAA,EAAO;AAAA,UACL;AAAA,YACE,IAAA,EAAM,MAAA;AAAA,YACN,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA;AAAA,YACE,IAAA,EAAM,MAAA;AAAA,YACN,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA;AACf,SACF;AAAA,QACA,QAAA,EAAU;AAAA,UACR,oBAAA;AAAA,UACA,qCAAA;AAAA,UACA;AAAA;AACF;AACF;AACF,GACF;AAAA,EACA;AACF,CAAA;AAEA,IAAO,gBAAA,GAAQ","file":"index.js","sourcesContent":["import { combinePermissions, kbPlatformPreset } from '@kb-labs/sdk';\n\nconst permissions = combinePermissions()\n  .with(kbPlatformPreset)\n  .withFs({\n    mode: 'readWrite',\n    allow: [\n      '.kb/plugins/**',\n      '.kb/marketplace.lock',\n      'plugins/**',\n      'adapters/**',\n    ],\n  })\n  .withShell({\n    // Needed to call `kb marketplace plugins link` after scaffolding,\n    // so the generated plugin lands in .kb/marketplace.lock automatically.\n    allow: ['kb'],\n  })\n  .withQuotas({ timeoutMs: 120000, memoryMb: 256 })\n  .build();\n\nconst manifest = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/scaffold',\n  version: '0.1.0',\n  display: {\n    name: 'Scaffold',\n    description:\n      'Generic entity scaffolder for KB Labs plugins, adapters, and friends.',\n    tags: ['scaffold', 'generator', 'dx'],\n  },\n  cli: {\n    groupMeta: [\n      { name: 'scaffold', describe: 'Scaffold KB Labs entities' },\n    ],\n    commands: [\n      {\n        id: 'run',\n        group: 'scaffold',\n        describe: 'Scaffold <entity> <name> from blocks',\n        handler: './commands/scaffold.js#default',\n        handlerPath: './commands/scaffold.js',\n        flags: [\n          {\n            name: 'blocks',\n            type: 'string',\n            description: 'Comma-separated block ids',\n          },\n          {\n            name: 'yes',\n            alias: 'y',\n            type: 'boolean',\n            description: 'Accept defaults and skip prompts',\n          },\n          {\n            name: 'force',\n            type: 'boolean',\n            description: 'Overwrite non-empty target directory',\n          },\n          {\n            name: 'dry-run',\n            type: 'boolean',\n            description: 'Print the tree that would be written and exit',\n          },\n          {\n            name: 'out',\n            type: 'string',\n            description: 'Override the output directory',\n          },\n          {\n            name: 'scope',\n            type: 'string',\n            description: 'npm scope for the generated package',\n          },\n          {\n            name: 'mode',\n            type: 'string',\n            description:\n              'Layout mode: \"in-workspace\" (workspace:* deps) or \"standalone\" (semver deps + pnpm-workspace.yaml)',\n          },\n        ],\n        examples: [\n          'kb scaffold run plugin my-plugin',\n          'kb scaffold run adapter my-llm --blocks base',\n          'kb scaffold run plugin ui --scope @acme --yes',\n          'kb scaffold run plugin demo --dry-run',\n        ],\n      },\n      {\n        id: 'doctor',\n        group: 'scaffold',\n        describe: 'Scan user plugins for common issues',\n        handler: './commands/doctor.js#default',\n        handlerPath: './commands/doctor.js',\n        flags: [\n          {\n            name: 'path',\n            type: 'string',\n            description: 'Path to scan (default: .kb/plugins)',\n          },\n          {\n            name: 'json',\n            type: 'boolean',\n            description: 'Emit JSON instead of text',\n          },\n        ],\n        examples: [\n          'kb scaffold doctor',\n          'kb scaffold doctor --path ./plugins',\n          'kb scaffold doctor --json',\n        ],\n      },\n    ],\n  },\n  permissions,\n} as const;\n\nexport default manifest;\n"]}

package/dist/manifest.d.ts

@@ -0,0 +1,75 @@
+import * as _kb_labs_perm_presets from '@kb-labs/perm-presets';
+
+declare const manifest: {
+    readonly schema: "kb.plugin/3";
+    readonly id: "@kb-labs/scaffold";
+    readonly version: "0.1.0";
+    readonly display: {
+        readonly name: "Scaffold";
+        readonly description: "Generic entity scaffolder for KB Labs plugins, adapters, and friends.";
+        readonly tags: readonly ["scaffold", "generator", "dx"];
+    };
+    readonly cli: {
+        readonly groupMeta: readonly [{
+            readonly name: "scaffold";
+            readonly describe: "Scaffold KB Labs entities";
+        }];
+        readonly commands: readonly [{
+            readonly id: "run";
+            readonly group: "scaffold";
+            readonly describe: "Scaffold <entity> <name> from blocks";
+            readonly handler: "./commands/scaffold.js#default";
+            readonly handlerPath: "./commands/scaffold.js";
+            readonly flags: readonly [{
+                readonly name: "blocks";
+                readonly type: "string";
+                readonly description: "Comma-separated block ids";
+            }, {
+                readonly name: "yes";
+                readonly alias: "y";
+                readonly type: "boolean";
+                readonly description: "Accept defaults and skip prompts";
+            }, {
+                readonly name: "force";
+                readonly type: "boolean";
+                readonly description: "Overwrite non-empty target directory";
+            }, {
+                readonly name: "dry-run";
+                readonly type: "boolean";
+                readonly description: "Print the tree that would be written and exit";
+            }, {
+                readonly name: "out";
+                readonly type: "string";
+                readonly description: "Override the output directory";
+            }, {
+                readonly name: "scope";
+                readonly type: "string";
+                readonly description: "npm scope for the generated package";
+            }, {
+                readonly name: "mode";
+                readonly type: "string";
+                readonly description: "Layout mode: \"in-workspace\" (workspace:* deps) or \"standalone\" (semver deps + pnpm-workspace.yaml)";
+            }];
+            readonly examples: readonly ["kb scaffold run plugin my-plugin", "kb scaffold run adapter my-llm --blocks base", "kb scaffold run plugin ui --scope @acme --yes", "kb scaffold run plugin demo --dry-run"];
+        }, {
+            readonly id: "doctor";
+            readonly group: "scaffold";
+            readonly describe: "Scan user plugins for common issues";
+            readonly handler: "./commands/doctor.js#default";
+            readonly handlerPath: "./commands/doctor.js";
+            readonly flags: readonly [{
+                readonly name: "path";
+                readonly type: "string";
+                readonly description: "Path to scan (default: .kb/plugins)";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb scaffold doctor", "kb scaffold doctor --path ./plugins", "kb scaffold doctor --json"];
+        }];
+    };
+    readonly permissions: _kb_labs_perm_presets.RuntimePermissionSpec;
+};
+
+export { manifest as default };

package/dist/manifest.js

@@ -0,0 +1,114 @@
+import { combinePermissions, kbPlatformPreset } from '@kb-labs/sdk';
+
+// src/manifest.ts
+var permissions = combinePermissions().with(kbPlatformPreset).withFs({
+  mode: "readWrite",
+  allow: [
+    ".kb/plugins/**",
+    ".kb/marketplace.lock",
+    "plugins/**",
+    "adapters/**"
+  ]
+}).withShell({
+  // Needed to call `kb marketplace plugins link` after scaffolding,
+  // so the generated plugin lands in .kb/marketplace.lock automatically.
+  allow: ["kb"]
+}).withQuotas({ timeoutMs: 12e4, memoryMb: 256 }).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/scaffold",
+  version: "0.1.0",
+  display: {
+    name: "Scaffold",
+    description: "Generic entity scaffolder for KB Labs plugins, adapters, and friends.",
+    tags: ["scaffold", "generator", "dx"]
+  },
+  cli: {
+    groupMeta: [
+      { name: "scaffold", describe: "Scaffold KB Labs entities" }
+    ],
+    commands: [
+      {
+        id: "run",
+        group: "scaffold",
+        describe: "Scaffold <entity> <name> from blocks",
+        handler: "./commands/scaffold.js#default",
+        handlerPath: "./commands/scaffold.js",
+        flags: [
+          {
+            name: "blocks",
+            type: "string",
+            description: "Comma-separated block ids"
+          },
+          {
+            name: "yes",
+            alias: "y",
+            type: "boolean",
+            description: "Accept defaults and skip prompts"
+          },
+          {
+            name: "force",
+            type: "boolean",
+            description: "Overwrite non-empty target directory"
+          },
+          {
+            name: "dry-run",
+            type: "boolean",
+            description: "Print the tree that would be written and exit"
+          },
+          {
+            name: "out",
+            type: "string",
+            description: "Override the output directory"
+          },
+          {
+            name: "scope",
+            type: "string",
+            description: "npm scope for the generated package"
+          },
+          {
+            name: "mode",
+            type: "string",
+            description: 'Layout mode: "in-workspace" (workspace:* deps) or "standalone" (semver deps + pnpm-workspace.yaml)'
+          }
+        ],
+        examples: [
+          "kb scaffold run plugin my-plugin",
+          "kb scaffold run adapter my-llm --blocks base",
+          "kb scaffold run plugin ui --scope @acme --yes",
+          "kb scaffold run plugin demo --dry-run"
+        ]
+      },
+      {
+        id: "doctor",
+        group: "scaffold",
+        describe: "Scan user plugins for common issues",
+        handler: "./commands/doctor.js#default",
+        handlerPath: "./commands/doctor.js",
+        flags: [
+          {
+            name: "path",
+            type: "string",
+            description: "Path to scan (default: .kb/plugins)"
+          },
+          {
+            name: "json",
+            type: "boolean",
+            description: "Emit JSON instead of text"
+          }
+        ],
+        examples: [
+          "kb scaffold doctor",
+          "kb scaffold doctor --path ./plugins",
+          "kb scaffold doctor --json"
+        ]
+      }
+    ]
+  },
+  permissions
+};
+var manifest_default = manifest;
+
+export { manifest_default as default };
+//# sourceMappingURL=manifest.js.map
+//# sourceMappingURL=manifest.js.map