@outfitter/tooling 0.2.3 → 0.3.0

package/dist/cli/index.js

@@ -1,12 +1,17 @@
 #!/usr/bin/env bun
 import {
-  VERSION
-} from "../shared/chunk-8aenrm6f.js";
+  VERSION,
+  analyzeSourceFile,
+  calculateCoverage,
+  runCheckTsdoc
+} from "../shared/chunk-cmde0fwx.js";
 import {
   __require
 } from "../shared/chunk-3s189drz.js";
 
 // src/cli/index.ts
+import { exitWithError } from "@outfitter/cli";
+import { createCLI } from "@outfitter/cli/command";
 import { Command } from "commander";
 
 // src/cli/check.ts
@@ -203,6 +208,8 @@ Add the missing entries to ${COLORS.blue}bunup.config.ts${COLORS.reset} defineWo
 }
 
 // src/cli/check-changeset.ts
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 function getChangedPackagePaths(files) {
   const packageNames = new Set;
   const pattern = /^packages\/([^/]+)\/src\//;
@@ -234,6 +241,73 @@ function checkChangesetRequired(changedPackages, changesetFiles) {
   }
   return { ok: false, missingFor: changedPackages };
 }
+function parseIgnoredPackagesFromChangesetConfig(jsonContent) {
+  try {
+    const parsed = JSON.parse(jsonContent);
+    if (!Array.isArray(parsed.ignore)) {
+      return [];
+    }
+    return parsed.ignore.filter((entry) => typeof entry === "string");
+  } catch {
+    return [];
+  }
+}
+function parseChangesetFrontmatterPackageNames(markdownContent) {
+  const frontmatterMatch = /^---\r?\n([\s\S]*?)\r?\n---/.exec(markdownContent);
+  if (!frontmatterMatch?.[1]) {
+    return [];
+  }
+  const packages = new Set;
+  for (const line of frontmatterMatch[1].split(/\r?\n/)) {
+    const trimmed = line.trim();
+    const match = /^(["']?)(@[^"':\s]+\/[^"':\s]+)\1\s*:/.exec(trimmed);
+    if (match?.[2]) {
+      packages.add(match[2]);
+    }
+  }
+  return [...packages].sort();
+}
+function findIgnoredPackageReferences(input) {
+  if (input.ignoredPackages.length === 0 || input.changesetFiles.length === 0) {
+    return [];
+  }
+  const ignored = new Set(input.ignoredPackages);
+  const results = [];
+  for (const file of input.changesetFiles) {
+    const content = input.readChangesetFile(file);
+    const referencedPackages = parseChangesetFrontmatterPackageNames(content);
+    const invalidReferences = referencedPackages.filter((pkg) => ignored.has(pkg));
+    if (invalidReferences.length > 0) {
+      results.push({ file, packages: invalidReferences.sort() });
+    }
+  }
+  return results.sort((a, b) => a.file.localeCompare(b.file));
+}
+function loadIgnoredPackages(cwd) {
+  const configPath = join(cwd, ".changeset", "config.json");
+  if (!existsSync(configPath)) {
+    return [];
+  }
+  try {
+    return parseIgnoredPackagesFromChangesetConfig(readFileSync(configPath, "utf-8"));
+  } catch {
+    return [];
+  }
+}
+function getIgnoredReferencesForChangedChangesets(cwd, changesetFiles) {
+  const ignoredPackages = loadIgnoredPackages(cwd);
+  return findIgnoredPackageReferences({
+    changesetFiles,
+    ignoredPackages,
+    readChangesetFile: (filename) => {
+      try {
+        return readFileSync(join(cwd, ".changeset", filename), "utf-8");
+      } catch {
+        return "";
+      }
+    }
+  });
+}
 var COLORS2 = {
   reset: "\x1B[0m",
   red: "\x1B[31m",
@@ -273,25 +347,46 @@ async function runCheckChangeset(options = {}) {
   }
   const changesetFiles = getChangedChangesetFiles(changedFiles);
   const check = checkChangesetRequired(changedPackages, changesetFiles);
-  if (check.ok) {
-    process.stdout.write(`${COLORS2.green}Changeset found for ${changedPackages.length} changed package(s).${COLORS2.reset}
+  if (!check.ok) {
+    process.stderr.write(`${COLORS2.red}Missing changeset!${COLORS2.reset}
+
 `);
-    process.exit(0);
+    process.stderr.write(`The following packages have source changes but no changeset:
+
+`);
+    for (const pkg of check.missingFor) {
+      process.stderr.write(`  ${COLORS2.yellow}@outfitter/${pkg}${COLORS2.reset}
+`);
+    }
+    process.stderr.write(`
+Run ${COLORS2.blue}bun run changeset${COLORS2.reset} to add a changeset, ` + `or add the ${COLORS2.blue}no-changeset${COLORS2.reset} label to skip.
+`);
+    process.exit(1);
   }
-  process.stderr.write(`${COLORS2.red}Missing changeset!${COLORS2.reset}
+  const ignoredReferences = getIgnoredReferencesForChangedChangesets(cwd, changesetFiles);
+  if (ignoredReferences.length > 0) {
+    process.stderr.write(`${COLORS2.red}Invalid changeset package reference(s).${COLORS2.reset}
 
 `);
-  process.stderr.write(`The following packages have source changes but no changeset:
+    process.stderr.write(`Changesets must not reference packages listed in .changeset/config.json ignore:
 
 `);
-  for (const pkg of check.missingFor) {
-    process.stderr.write(`  ${COLORS2.yellow}@outfitter/${pkg}${COLORS2.reset}
+    for (const reference of ignoredReferences) {
+      process.stderr.write(`  ${COLORS2.yellow}${reference.file}${COLORS2.reset}
 `);
+      for (const pkg of reference.packages) {
+        process.stderr.write(`    - ${pkg}
+`);
+      }
+    }
+    process.stderr.write(`
+Update the affected changeset files to remove ignored packages before merging.
+`);
+    process.exit(1);
   }
-  process.stderr.write(`
-Run ${COLORS2.blue}bun run changeset${COLORS2.reset} to add a changeset, ` + `or add the ${COLORS2.blue}no-changeset${COLORS2.reset} label to skip.
+  process.stdout.write(`${COLORS2.green}Changeset found for ${changedPackages.length} changed package(s).${COLORS2.reset}
 `);
-  process.exit(1);
+  process.exit(0);
 }
 
 // src/cli/check-clean-tree.ts
@@ -501,6 +596,9 @@ var COLORS4 = {
   blue: "\x1B[34m",
   dim: "\x1B[2m"
 };
+function resolveJsonMode(options = {}) {
+  return options.json ?? process.env["OUTFITTER_JSON"] === "1";
+}
 async function runCheckExports(options = {}) {
   const cwd = process.cwd();
   const configPath = resolve3(cwd, "bunup.config.ts");
@@ -543,7 +641,7 @@ async function runCheckExports(options = {}) {
     ok: results.every((r) => r.status === "ok"),
     packages: results
   };
-  if (options.json) {
+  if (resolveJsonMode(options)) {
     process.stdout.write(`${JSON.stringify(checkResult, null, 2)}
 `);
   } else {
@@ -669,8 +767,9 @@ async function runInit(cwd = process.cwd()) {
 }
 
 // src/cli/pre-push.ts
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { join as join2, resolve as resolve4 } from "node:path";
+import ts from "typescript";
 var COLORS5 = {
   reset: "\x1B[0m",
   red: "\x1B[31m",
@@ -707,6 +806,9 @@ function isRedPhaseBranch(branch) {
 function isScaffoldBranch(branch) {
   return branch.endsWith("-scaffold") || branch.endsWith("/scaffold") || branch.endsWith("_scaffold");
 }
+function isReleaseBranch(branch) {
+  return branch.startsWith("changeset-release/");
+}
 var TEST_PATH_PATTERNS = [
   /(^|\/)__tests__\//,
   /(^|\/)__snapshots__\//,
@@ -726,6 +828,32 @@ function areFilesTestOnly(paths) {
 function canBypassRedPhaseByChangedFiles(changedFiles) {
   return changedFiles.deterministic && areFilesTestOnly(changedFiles.files);
 }
+function hasPackageSourceChanges(changedFiles) {
+  const packageSrcPattern = /^packages\/[^/]+\/src\//;
+  return changedFiles.files.some((f) => packageSrcPattern.test(f));
+}
+async function printTsdocSummary() {
+  const glob = new Bun.Glob("packages/*/src/index.ts");
+  const cwd = process.cwd();
+  const allDeclarations = [];
+  for (const entry of glob.scanSync({ cwd })) {
+    const filePath = resolve4(cwd, entry);
+    const content = await Bun.file(filePath).text();
+    const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
+    allDeclarations.push(...analyzeSourceFile(sourceFile));
+  }
+  if (allDeclarations.length === 0)
+    return;
+  const coverage = calculateCoverage(allDeclarations);
+  const parts = [];
+  if (coverage.documented > 0)
+    parts.push(`${coverage.documented} documented`);
+  if (coverage.partial > 0)
+    parts.push(`${coverage.partial} partial`);
+  if (coverage.undocumented > 0)
+    parts.push(`${coverage.undocumented} undocumented`);
+  log(`${COLORS5.blue}TSDoc${COLORS5.reset}: ${coverage.percentage}% coverage (${parts.join(", ")} of ${coverage.total} total)`);
+}
 function resolveBaseRef() {
   const candidates = [
     "origin/main",
@@ -863,12 +991,12 @@ function createVerificationPlan(scripts) {
   };
 }
 function readPackageScripts(cwd = process.cwd()) {
-  const packageJsonPath = join(cwd, "package.json");
-  if (!existsSync(packageJsonPath)) {
+  const packageJsonPath = join2(cwd, "package.json");
+  if (!existsSync2(packageJsonPath)) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
     const scripts = parsed.scripts ?? {};
     const normalized = {};
     for (const [name, value] of Object.entries(scripts)) {
@@ -893,6 +1021,11 @@ async function runPrePush(options = {}) {
   log(`${COLORS5.blue}Pre-push verify${COLORS5.reset} (TDD-aware)`);
   log("");
   const branch = getCurrentBranch();
+  if (isReleaseBranch(branch)) {
+    log(`${COLORS5.yellow}Release branch detected${COLORS5.reset}: ${COLORS5.blue}${branch}${COLORS5.reset}`);
+    log(`${COLORS5.yellow}Skipping strict verification${COLORS5.reset} for automated changeset release push`);
+    process.exit(0);
+  }
   if (isRedPhaseBranch(branch)) {
     if (maybeSkipForRedPhase("branch", branch)) {
       process.exit(0);
@@ -938,14 +1071,20 @@ async function runPrePush(options = {}) {
     log("  - feature_tests");
     process.exit(1);
   }
+  const changedFiles = getChangedFilesForPush();
+  if (hasPackageSourceChanges(changedFiles)) {
+    try {
+      await printTsdocSummary();
+    } catch {}
+  }
   log("");
   log(`${COLORS5.green}Strict verification passed${COLORS5.reset}`);
   process.exit(0);
 }
 
 // src/cli/upgrade-bun.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync } from "node:fs";
+import { join as join3 } from "node:path";
 var COLORS6 = {
   reset: "\x1B[0m",
   red: "\x1B[31m",
@@ -983,13 +1122,13 @@ function findPackageJsonFiles(dir) {
   const glob = new Bun.Glob("**/package.json");
   for (const path of glob.scanSync({ cwd: dir })) {
     if (!path.includes("node_modules")) {
-      results.push(join2(dir, path));
+      results.push(join3(dir, path));
     }
   }
   return results;
 }
 function updateEnginesBun(filePath, version) {
-  const content = readFileSync2(filePath, "utf-8");
+  const content = readFileSync3(filePath, "utf-8");
   const pattern = /"bun":\s*">=[\d.]+"/;
   if (!pattern.test(content)) {
     return false;
@@ -1002,7 +1141,7 @@ function updateEnginesBun(filePath, version) {
   return false;
 }
 function updateTypesBun(filePath, version) {
-  const content = readFileSync2(filePath, "utf-8");
+  const content = readFileSync3(filePath, "utf-8");
   const pattern = /"@types\/bun":\s*"\^[\d.]+"/;
   if (!pattern.test(content)) {
     return false;
@@ -1016,14 +1155,14 @@ function updateTypesBun(filePath, version) {
 }
 async function runUpgradeBun(targetVersion, options = {}) {
   const cwd = process.cwd();
-  const bunVersionFile = join2(cwd, ".bun-version");
+  const bunVersionFile = join3(cwd, ".bun-version");
   let version = targetVersion;
   if (!version) {
     info("Fetching latest Bun version...");
     version = await fetchLatestVersion();
     log2(`Latest version: ${version}`);
   }
-  const currentVersion = existsSync2(bunVersionFile) ? readFileSync2(bunVersionFile, "utf-8").trim() : "unknown";
+  const currentVersion = existsSync3(bunVersionFile) ? readFileSync3(bunVersionFile, "utf-8").trim() : "unknown";
   log2(`Current version: ${currentVersion}`);
   if (currentVersion === version) {
     success(`Already on version ${version}`);
@@ -1088,40 +1227,58 @@ async function runUpgradeBun(targetVersion, options = {}) {
 }
 
 // src/cli/index.ts
-var program = new Command;
-program.name("tooling").description("Dev tooling configuration management for Outfitter projects").version(VERSION);
-program.command("init").description("Initialize tooling config in the current project").action(async () => {
-  await runInit();
+var cli = createCLI({
+  name: "tooling",
+  version: VERSION,
+  description: "Dev tooling configuration management for Outfitter projects",
+  onError: (error) => {
+    const err = error instanceof Error ? error : new Error("An unexpected error occurred");
+    exitWithError(err);
+  }
 });
-program.command("check").description("Run linting checks (wraps ultracite)").argument("[paths...]", "Paths to check").action(async (paths) => {
+function register(command) {
+  cli.register(command);
+}
+register(new Command("init").description("Initialize tooling config in the current project").action(async () => {
+  await runInit();
+}));
+register(new Command("check").description("Run linting checks (wraps ultracite)").argument("[paths...]", "Paths to check").action(async (paths) => {
   await runCheck(paths);
-});
-program.command("fix").description("Fix linting issues (wraps ultracite)").argument("[paths...]", "Paths to fix").action(async (paths) => {
+}));
+register(new Command("fix").description("Fix linting issues (wraps ultracite)").argument("[paths...]", "Paths to fix").action(async (paths) => {
   await runFix(paths);
-});
-program.command("upgrade-bun").description("Upgrade Bun version across the project").argument("[version]", "Target version (defaults to latest)").option("--no-install", "Skip installing Bun and updating lockfile").action(async (version, options) => {
+}));
+register(new Command("upgrade-bun").description("Upgrade Bun version across the project").argument("[version]", "Target version (defaults to latest)").option("--no-install", "Skip installing Bun and updating lockfile").action(async (version, options) => {
   await runUpgradeBun(version, options);
-});
-program.command("pre-push").description("TDD-aware pre-push strict verification hook").option("-f, --force", "Skip strict verification entirely").action(async (options) => {
+}));
+register(new Command("pre-push").description("TDD-aware pre-push strict verification hook").option("-f, --force", "Skip strict verification entirely").action(async (options) => {
   await runPrePush(options);
-});
-program.command("check-bunup-registry").description("Validate packages with bunup --filter are registered in bunup.config.ts").action(async () => {
+}));
+register(new Command("check-bunup-registry").description("Validate packages with bunup --filter are registered in bunup.config.ts").action(async () => {
   await runCheckBunupRegistry();
-});
-program.command("check-changeset").description("Validate PRs touching package source include a changeset").option("-s, --skip", "Skip changeset check").action(async (options) => {
+}));
+register(new Command("check-changeset").description("Validate PRs touching package source include a changeset").option("-s, --skip", "Skip changeset check").action(async (options) => {
   await runCheckChangeset(options);
-});
-program.command("check-exports").description("Validate package.json exports match source entry points").option("--json", "Output results as JSON").action(async (options) => {
+}));
+register(new Command("check-exports").description("Validate package.json exports match source entry points").option("--json", "Output results as JSON").action(async (options) => {
   await runCheckExports(options);
-});
-program.command("check-clean-tree").description("Assert working tree is clean (no modified or untracked files)").option("--paths <paths...>", "Limit check to specific paths").action(async (options) => {
+}));
+register(new Command("check-tsdoc").description("Check TSDoc coverage on exported declarations").argument("[paths...]", "Specific package paths to check").option("--strict", "Exit non-zero when coverage is below threshold").option("--json", "Output results as JSON").option("--min-coverage <percentage>", "Minimum coverage percentage", "0").action(async (paths, options) => {
+  await runCheckTsdoc({
+    paths: paths.length > 0 ? paths : undefined,
+    strict: options.strict,
+    json: options.json,
+    minCoverage: options.minCoverage ? Number.parseInt(options.minCoverage, 10) : undefined
+  });
+}));
+register(new Command("check-clean-tree").description("Assert working tree is clean (no modified or untracked files)").option("--paths <paths...>", "Limit check to specific paths").action(async (options) => {
   await runCheckCleanTree(options);
-});
-program.command("check-readme-imports").description("Validate README import examples match package exports").option("--json", "Output results as JSON").action(async (options) => {
-  const { runCheckReadmeImports } = await import("../shared/chunk-6a7tjcgm.js");
+}));
+register(new Command("check-readme-imports").description("Validate README import examples match package exports").option("--json", "Output results as JSON").action(async (options) => {
+  const { runCheckReadmeImports } = await import("../shared/chunk-7tdgbqb0.js");
   await runCheckReadmeImports(options);
-});
-program.command("check-boundary-invocations").description("Validate root/app scripts do not execute packages/*/src entrypoints directly").action(async () => {
+}));
+register(new Command("check-boundary-invocations").description("Validate root/app scripts do not execute packages/*/src entrypoints directly").action(async () => {
   await runCheckBoundaryInvocations();
-});
-program.parse();
+}));
+await cli.parse();

package/dist/cli/pre-push.d.ts

@@ -6,6 +6,7 @@ declare function isRedPhaseBranch(branch: string): boolean;
 * Check if branch is a scaffold branch
 */
 declare function isScaffoldBranch(branch: string): boolean;
+declare function isReleaseBranch(branch: string): boolean;
 declare function isTestOnlyPath(path: string): boolean;
 declare function areFilesTestOnly(paths: readonly string[]): boolean;
 interface PushChangedFiles {
@@ -14,6 +15,12 @@ interface PushChangedFiles {
 	readonly source: "upstream" | "baseRef" | "undetermined";
 }
 declare function canBypassRedPhaseByChangedFiles(changedFiles: PushChangedFiles): boolean;
+/**
+* Check whether any changed files are package source files.
+*
+* Matches files under "packages/PKGNAME/src/" (any depth).
+*/
+declare function hasPackageSourceChanges(changedFiles: PushChangedFiles): boolean;
 type ScriptMap = Readonly<Record<string, string | undefined>>;
 type VerificationPlan = {
 	readonly ok: true;
@@ -38,4 +45,4 @@ interface PrePushOptions {
 * Main pre-push command
 */
 declare function runPrePush(options?: PrePushOptions): Promise<void>;
-export { runPrePush, isTestOnlyPath, isScaffoldBranch, isRedPhaseBranch, createVerificationPlan, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, PrePushOptions };
+export { runPrePush, isTestOnlyPath, isScaffoldBranch, isReleaseBranch, isRedPhaseBranch, hasPackageSourceChanges, createVerificationPlan, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, PrePushOptions };

package/dist/cli/pre-push.js

@@ -3,17 +3,22 @@ import {
   areFilesTestOnly,
   canBypassRedPhaseByChangedFiles,
   createVerificationPlan,
+  hasPackageSourceChanges,
   isRedPhaseBranch,
+  isReleaseBranch,
   isScaffoldBranch,
   isTestOnlyPath,
   runPrePush
-} from "../shared/@outfitter/tooling-8sd32ts6.js";
+} from "../shared/@outfitter/tooling-2n2dpsaa.js";
+import"../shared/@outfitter/tooling-qk5xgmxr.js";
 import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
   runPrePush,
   isTestOnlyPath,
   isScaffoldBranch,
+  isReleaseBranch,
   isRedPhaseBranch,
+  hasPackageSourceChanges,
   createVerificationPlan,
   canBypassRedPhaseByChangedFiles,
   areFilesTestOnly

package/dist/index.d.ts

@@ -1,4 +1,79 @@
 import { ZodType } from "zod";
+/** Coverage classification for a single declaration. */
+type CoverageLevel = "documented" | "partial" | "undocumented";
+/** Result for a single exported declaration. */
+interface DeclarationCoverage {
+	readonly name: string;
+	readonly kind: string;
+	readonly level: CoverageLevel;
+	readonly file: string;
+	readonly line: number;
+}
+/** Coverage summary statistics. */
+interface CoverageSummary {
+	readonly documented: number;
+	readonly partial: number;
+	readonly undocumented: number;
+	readonly total: number;
+	readonly percentage: number;
+}
+/** Per-package TSDoc coverage stats. */
+interface PackageCoverage {
+	readonly name: string;
+	readonly path: string;
+	readonly declarations: readonly DeclarationCoverage[];
+	readonly documented: number;
+	readonly partial: number;
+	readonly undocumented: number;
+	readonly total: number;
+	readonly percentage: number;
+}
+/** Aggregated result across all packages. */
+interface TsDocCheckResult {
+	readonly ok: boolean;
+	readonly packages: readonly PackageCoverage[];
+	readonly summary: CoverageSummary;
+}
+/** Zod schema for {@link CoverageLevel}. */
+declare const coverageLevelSchema: ZodType<CoverageLevel>;
+/** Zod schema for {@link DeclarationCoverage}. */
+declare const declarationCoverageSchema: ZodType<DeclarationCoverage>;
+/** Zod schema for {@link PackageCoverage}. */
+declare const packageCoverageSchema: ZodType<PackageCoverage>;
+/** Zod schema for {@link TsDocCheckResult}. */
+declare const tsDocCheckResultSchema: ZodType<TsDocCheckResult>;
+/** Options for the check-tsdoc command. */
+interface CheckTsDocOptions {
+	readonly strict?: boolean | undefined;
+	readonly json?: boolean | undefined;
+	readonly minCoverage?: number | undefined;
+	readonly cwd?: string | undefined;
+	readonly paths?: readonly string[] | undefined;
+}
+/**
+* Analyze TSDoc coverage across workspace packages.
+*
+* Pure function that discovers packages, analyzes TSDoc coverage on exported
+* declarations, and returns the aggregated result. Does not print output or
+* call `process.exit()`.
+*
+* @param options - Analysis options (paths, strict mode, coverage threshold)
+* @returns Aggregated coverage result across all packages, or `null` if no packages found
+*/
+declare function analyzeCheckTsdoc(options?: CheckTsDocOptions): TsDocCheckResult | null;
+/**
+* Print a TSDoc coverage result in human-readable format.
+*
+* Renders a bar chart per package with summary statistics. Writes to stdout/stderr.
+*
+* @param result - The coverage result to print
+* @param options - Display options (strict mode, coverage threshold for warning)
+*/
+declare function printCheckTsdocHuman(result: TsDocCheckResult, options?: {
+	strict?: boolean | undefined;
+	minCoverage?: number | undefined;
+}): void;
+import { ZodType as ZodType2 } from "zod";
 /**
 * File entry in a block.
 */
@@ -16,7 +91,7 @@ interface FileEntry {
 * Schema for a file entry in a block.
 * Represents a file that will be copied to the user's project.
 */
-declare const FileEntrySchema: ZodType<FileEntry>;
+declare const FileEntrySchema: ZodType2<FileEntry>;
 /**
 * Block in the registry.
 */
@@ -38,7 +113,7 @@ interface Block {
 * Schema for a block in the registry.
 * A block is a collection of related files that can be added together.
 */
-declare const BlockSchema: ZodType<Block>;
+declare const BlockSchema: ZodType2<Block>;
 /**
 * Complete registry structure.
 */
@@ -52,7 +127,7 @@ interface Registry {
 * Schema for the complete registry.
 * Contains all available blocks with their files and metadata.
 */
-declare const RegistrySchema: ZodType<Registry>;
+declare const RegistrySchema: ZodType2<Registry>;
 /**
 * Block definition used in the build script.
 * Specifies how to collect source files into a block.
@@ -108,4 +183,4 @@ interface AddBlockOptions {
 }
 /** Package version, read from package.json at load time. */
 declare const VERSION: string;
-export { VERSION, RegistrySchema, RegistryBuildConfig, Registry, FileEntrySchema, FileEntry, BlockSchema, BlockDefinition, Block, AddBlockResult, AddBlockOptions };
+export { tsDocCheckResultSchema, printCheckTsdocHuman, packageCoverageSchema, declarationCoverageSchema, coverageLevelSchema, analyzeCheckTsdoc, VERSION, TsDocCheckResult, RegistrySchema, RegistryBuildConfig, Registry, PackageCoverage, FileEntrySchema, FileEntry, DeclarationCoverage, CoverageLevel, CheckTsDocOptions, BlockSchema, BlockDefinition, Block, AddBlockResult, AddBlockOptions };

package/dist/index.js

@@ -1,8 +1,13 @@
 import {
-  VERSION
-} from "./shared/chunk-8aenrm6f.js";
+  VERSION,
+  analyzeCheckTsdoc,
+  coverageLevelSchema,
+  declarationCoverageSchema,
+  packageCoverageSchema,
+  printCheckTsdocHuman,
+  tsDocCheckResultSchema
+} from "./shared/chunk-cmde0fwx.js";
 import"./shared/chunk-3s189drz.js";
-
 // src/registry/schema.ts
 import { z } from "zod";
 var FileEntrySchema = z.object({
@@ -15,15 +20,21 @@ var BlockSchema = z.object({
   name: z.string().min(1),
   description: z.string().min(1),
   files: z.array(FileEntrySchema).optional(),
-  dependencies: z.record(z.string()).optional(),
-  devDependencies: z.record(z.string()).optional(),
+  dependencies: z.record(z.string(), z.string()).optional(),
+  devDependencies: z.record(z.string(), z.string()).optional(),
   extends: z.array(z.string()).optional()
 });
 var RegistrySchema = z.object({
   version: z.string(),
-  blocks: z.record(BlockSchema)
+  blocks: z.record(z.string(), BlockSchema)
 });
 export {
+  tsDocCheckResultSchema,
+  printCheckTsdocHuman,
+  packageCoverageSchema,
+  declarationCoverageSchema,
+  coverageLevelSchema,
+  analyzeCheckTsdoc,
   VERSION,
   RegistrySchema,
   FileEntrySchema,

package/dist/registry/build.d.ts

@@ -1,4 +1,4 @@
-import { RegistryBuildConfig } from "../shared/@outfitter/tooling-sjm8nebx";
+import { RegistryBuildConfig } from "../shared/@outfitter/tooling-sjm8nebx.js";
 /**
 * Registry build configuration
 */

package/dist/registry/build.js

@@ -93,16 +93,16 @@ var REGISTRY_CONFIG = {
       description: "Biome linter/formatter configuration via Ultracite",
       files: ["packages/tooling/biome.json"],
       remap: { "packages/tooling/biome.json": "biome.json" },
-      devDependencies: { ultracite: "^7.1.1" }
+      devDependencies: { ultracite: "^7.2.3" }
     },
     lefthook: {
       description: "Git hooks via Lefthook for pre-commit and pre-push",
       files: ["packages/tooling/lefthook.yml"],
       remap: { "packages/tooling/lefthook.yml": ".lefthook.yml" },
       devDependencies: {
-        "@outfitter/tooling": "^0.2.1",
-        lefthook: "^2.0.16",
-        ultracite: "^7.1.1"
+        "@outfitter/tooling": "^0.2.4",
+        lefthook: "^2.1.1",
+        ultracite: "^7.2.3"
       }
     },
     markdownlint: {
@@ -114,7 +114,10 @@ var REGISTRY_CONFIG = {
     },
     bootstrap: {
       description: "Project bootstrap script for installing tools and dependencies",
-      files: ["scripts/bootstrap.sh"]
+      files: ["packages/tooling/templates/bootstrap.sh"],
+      remap: {
+        "packages/tooling/templates/bootstrap.sh": "scripts/bootstrap.sh"
+      }
     },
     scaffolding: {
       description: "Full starter kit: Claude settings, Biome, Lefthook, markdownlint, and bootstrap script",

package/dist/registry/index.d.ts

@@ -1,3 +1,3 @@
-import "../shared/@outfitter/tooling-xqwn46sx";
-import { AddBlockOptions, AddBlockResult, Block, BlockDefinition, BlockSchema, FileEntry, FileEntrySchema, Registry, RegistryBuildConfig, RegistrySchema } from "../shared/@outfitter/tooling-sjm8nebx";
+import "../shared/@outfitter/tooling-xqwn46sx.js";
+import { AddBlockOptions, AddBlockResult, Block, BlockDefinition, BlockSchema, FileEntry, FileEntrySchema, Registry, RegistryBuildConfig, RegistrySchema } from "../shared/@outfitter/tooling-sjm8nebx.js";
 export { RegistrySchema, RegistryBuildConfig, Registry, FileEntrySchema, FileEntry, BlockSchema, BlockDefinition, Block, AddBlockResult, AddBlockOptions };

package/dist/registry/index.js

@@ -4,7 +4,7 @@ import {
   BlockSchema,
   FileEntrySchema,
   RegistrySchema
-} from "../shared/@outfitter/tooling-g83d0kjv.js";
+} from "../shared/@outfitter/tooling-wv09k6hr.js";
 import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
   RegistrySchema,