@outfitter/tooling 0.2.4 → 0.3.3

package/dist/shared/chunk-cmde0fwx.js

@@ -0,0 +1,421 @@
+import {
+  __require
+} from "./chunk-3s189drz.js";
+
+// src/cli/check-tsdoc.ts
+import { resolve } from "node:path";
+import ts from "typescript";
+import { z } from "zod";
+var coverageLevelSchema = z.enum([
+  "documented",
+  "partial",
+  "undocumented"
+]);
+var declarationCoverageSchema = z.object({
+  name: z.string(),
+  kind: z.string(),
+  level: coverageLevelSchema,
+  file: z.string(),
+  line: z.number()
+});
+var coverageSummarySchema = z.object({
+  documented: z.number(),
+  partial: z.number(),
+  undocumented: z.number(),
+  total: z.number(),
+  percentage: z.number()
+});
+var packageCoverageSchema = z.object({
+  name: z.string(),
+  path: z.string(),
+  declarations: z.array(declarationCoverageSchema),
+  documented: z.number(),
+  partial: z.number(),
+  undocumented: z.number(),
+  total: z.number(),
+  percentage: z.number()
+});
+var tsDocCheckResultSchema = z.object({
+  ok: z.boolean(),
+  packages: z.array(packageCoverageSchema),
+  summary: coverageSummarySchema
+});
+function isExportedDeclaration(node) {
+  if (ts.isExportDeclaration(node))
+    return false;
+  if (ts.isExportAssignment(node))
+    return false;
+  const isDeclaration = ts.isFunctionDeclaration(node) || ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node) || ts.isClassDeclaration(node) || ts.isEnumDeclaration(node) || ts.isVariableStatement(node);
+  if (!isDeclaration)
+    return false;
+  const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+  if (!modifiers)
+    return false;
+  return modifiers.some((mod) => mod.kind === ts.SyntaxKind.ExportKeyword);
+}
+function getDeclarationName(node) {
+  if (ts.isVariableStatement(node)) {
+    const decl = node.declarationList.declarations[0];
+    if (decl && ts.isIdentifier(decl.name)) {
+      return decl.name.text;
+    }
+    return;
+  }
+  if (ts.isFunctionDeclaration(node) || ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node) || ts.isClassDeclaration(node) || ts.isEnumDeclaration(node)) {
+    return node.name?.text;
+  }
+  return;
+}
+function getDeclarationKind(node) {
+  if (ts.isFunctionDeclaration(node))
+    return "function";
+  if (ts.isInterfaceDeclaration(node))
+    return "interface";
+  if (ts.isTypeAliasDeclaration(node))
+    return "type";
+  if (ts.isClassDeclaration(node))
+    return "class";
+  if (ts.isEnumDeclaration(node))
+    return "enum";
+  if (ts.isVariableStatement(node))
+    return "variable";
+  return "unknown";
+}
+function hasJSDocComment(node, sourceFile) {
+  const sourceText = sourceFile.getFullText();
+  const ranges = ts.getLeadingCommentRanges(sourceText, node.getFullStart());
+  if (!ranges)
+    return false;
+  return ranges.some((range) => {
+    if (range.kind !== ts.SyntaxKind.MultiLineCommentTrivia)
+      return false;
+    const text = sourceText.slice(range.pos, range.end);
+    return text.startsWith("/**");
+  });
+}
+function memberHasJSDoc(member, sourceFile) {
+  const sourceText = sourceFile.getFullText();
+  const ranges = ts.getLeadingCommentRanges(sourceText, member.getFullStart());
+  if (!ranges)
+    return false;
+  return ranges.some((range) => {
+    if (range.kind !== ts.SyntaxKind.MultiLineCommentTrivia)
+      return false;
+    const text = sourceText.slice(range.pos, range.end);
+    return text.startsWith("/**");
+  });
+}
+function classifyDeclaration(node, sourceFile) {
+  const hasDoc = hasJSDocComment(node, sourceFile);
+  if (!hasDoc)
+    return "undocumented";
+  if (ts.isInterfaceDeclaration(node) || ts.isClassDeclaration(node)) {
+    const members = node.members;
+    if (members.length > 0) {
+      const allMembersDocumented = members.every((member) => memberHasJSDoc(member, sourceFile));
+      if (!allMembersDocumented)
+        return "partial";
+    }
+  }
+  return "documented";
+}
+function analyzeSourceFile(sourceFile) {
+  const results = [];
+  for (const statement of sourceFile.statements) {
+    if (!isExportedDeclaration(statement))
+      continue;
+    const name = getDeclarationName(statement);
+    if (!name)
+      continue;
+    const kind = getDeclarationKind(statement);
+    const level = classifyDeclaration(statement, sourceFile);
+    const { line } = sourceFile.getLineAndCharacterOfPosition(statement.getStart(sourceFile));
+    results.push({
+      name,
+      kind,
+      level,
+      file: sourceFile.fileName,
+      line: line + 1
+    });
+  }
+  return results;
+}
+function calculateCoverage(declarations) {
+  const total = declarations.length;
+  if (total === 0) {
+    return {
+      documented: 0,
+      partial: 0,
+      undocumented: 0,
+      total: 0,
+      percentage: 100
+    };
+  }
+  const documented = declarations.filter((d) => d.level === "documented").length;
+  const partial = declarations.filter((d) => d.level === "partial").length;
+  const undocumented = declarations.filter((d) => d.level === "undocumented").length;
+  const score = documented + partial * 0.5;
+  const percentage = Math.round(score / total * 100);
+  return { documented, partial, undocumented, total, percentage };
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  dim: "\x1B[2m",
+  bold: "\x1B[1m"
+};
+function resolveJsonMode(options = {}) {
+  return options.json ?? process.env["OUTFITTER_JSON"] === "1";
+}
+function bar(percentage, width = 20) {
+  const filled = Math.round(percentage / 100 * width);
+  const empty = width - filled;
+  const color = percentage >= 80 ? COLORS.green : percentage >= 50 ? COLORS.yellow : COLORS.red;
+  return `${color}${"█".repeat(filled)}${COLORS.dim}${"░".repeat(empty)}${COLORS.reset}`;
+}
+function discoverPackages(cwd) {
+  const packages = [];
+  const seenEntryPoints = new Set;
+  for (const pattern of ["packages/*/src/index.ts", "apps/*/src/index.ts"]) {
+    const glob = new Bun.Glob(pattern);
+    for (const match of glob.scanSync({ cwd, dot: false })) {
+      const parts = match.split("/");
+      const rootDir = parts[0];
+      const pkgDir = parts[1];
+      if (!rootDir || !pkgDir)
+        continue;
+      const entryPoint = resolve(cwd, match);
+      if (seenEntryPoints.has(entryPoint)) {
+        continue;
+      }
+      seenEntryPoints.add(entryPoint);
+      const pkgRoot = resolve(cwd, rootDir, pkgDir);
+      let pkgName = pkgDir;
+      try {
+        const pkgJson = JSON.parse(__require("node:fs").readFileSync(resolve(pkgRoot, "package.json"), "utf-8"));
+        if (pkgJson.name)
+          pkgName = pkgJson.name;
+      } catch {}
+      packages.push({
+        name: pkgName,
+        path: pkgRoot,
+        entryPoint
+      });
+    }
+  }
+  if (packages.length === 0) {
+    const entryPoint = resolve(cwd, "src/index.ts");
+    try {
+      __require("node:fs").accessSync(entryPoint);
+      let pkgName = "root";
+      try {
+        const pkgJson = JSON.parse(__require("node:fs").readFileSync(resolve(cwd, "package.json"), "utf-8"));
+        if (pkgJson.name)
+          pkgName = pkgJson.name;
+      } catch {}
+      packages.push({
+        name: pkgName,
+        path: cwd,
+        entryPoint
+      });
+      seenEntryPoints.add(entryPoint);
+    } catch {}
+  }
+  return packages.sort((a, b) => a.name.localeCompare(b.name));
+}
+function collectReExportedSourceFiles(sourceFile, program, pkgPath) {
+  const result = [];
+  const seen = new Set;
+  for (const statement of sourceFile.statements) {
+    if (!ts.isExportDeclaration(statement))
+      continue;
+    if (!statement.moduleSpecifier)
+      continue;
+    if (!ts.isStringLiteral(statement.moduleSpecifier))
+      continue;
+    const specifier = statement.moduleSpecifier.text;
+    if (!specifier.startsWith("."))
+      continue;
+    const resolvedModule = ts.resolveModuleName(specifier, sourceFile.fileName, program.getCompilerOptions(), ts.sys);
+    const resolvedFileName = resolvedModule.resolvedModule?.resolvedFileName;
+    if (!resolvedFileName)
+      continue;
+    if (!resolvedFileName.startsWith(pkgPath))
+      continue;
+    if (seen.has(resolvedFileName))
+      continue;
+    seen.add(resolvedFileName);
+    const sf = program.getSourceFile(resolvedFileName);
+    if (sf)
+      result.push(sf);
+  }
+  return result;
+}
+function analyzePackage(pkg, workspaceCwd) {
+  try {
+    __require("node:fs").accessSync(pkg.entryPoint);
+  } catch {
+    return {
+      name: pkg.name,
+      path: pkg.path,
+      declarations: [],
+      documented: 0,
+      partial: 0,
+      undocumented: 0,
+      total: 0,
+      percentage: 0
+    };
+  }
+  let tsconfigPath = resolve(pkg.path, "tsconfig.json");
+  try {
+    __require("node:fs").accessSync(tsconfigPath);
+  } catch {
+    tsconfigPath = resolve(workspaceCwd, "tsconfig.json");
+  }
+  const configFile = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
+  const parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, pkg.path);
+  const program = ts.createProgram({
+    rootNames: [pkg.entryPoint],
+    options: parsedConfig.options,
+    host: ts.createCompilerHost(parsedConfig.options)
+  });
+  const sourceFile = program.getSourceFile(pkg.entryPoint);
+  if (!sourceFile) {
+    return {
+      name: pkg.name,
+      path: pkg.path,
+      declarations: [],
+      documented: 0,
+      partial: 0,
+      undocumented: 0,
+      total: 0,
+      percentage: 0
+    };
+  }
+  const declarations = analyzeSourceFile(sourceFile);
+  const reExportedFiles = collectReExportedSourceFiles(sourceFile, program, pkg.path);
+  for (const sf of reExportedFiles) {
+    declarations.push(...analyzeSourceFile(sf));
+  }
+  const stats = calculateCoverage(declarations);
+  return {
+    name: pkg.name,
+    path: pkg.path,
+    declarations,
+    ...stats
+  };
+}
+function analyzeCheckTsdoc(options = {}) {
+  const cwd = options.cwd ? resolve(options.cwd) : process.cwd();
+  const minCoverage = options.minCoverage ?? 0;
+  let packages;
+  if (options.paths && options.paths.length > 0) {
+    packages = options.paths.map((p) => {
+      const absPath = resolve(cwd, p);
+      const entryPoint = resolve(absPath, "src/index.ts");
+      let name = p;
+      try {
+        const pkgJson = JSON.parse(__require("node:fs").readFileSync(resolve(absPath, "package.json"), "utf-8"));
+        if (pkgJson.name)
+          name = pkgJson.name;
+      } catch {}
+      return { name, path: absPath, entryPoint };
+    });
+  } else {
+    packages = discoverPackages(cwd);
+  }
+  if (packages.length === 0) {
+    return null;
+  }
+  const packageResults = [];
+  for (const pkg of packages) {
+    packageResults.push(analyzePackage(pkg, cwd));
+  }
+  const allDeclarations = packageResults.flatMap((p) => p.declarations);
+  const summary = calculateCoverage(allDeclarations);
+  const ok = !options.strict || summary.percentage >= minCoverage;
+  return {
+    ok,
+    packages: packageResults,
+    summary
+  };
+}
+function printCheckTsdocHuman(result, options) {
+  process.stdout.write(`
+${COLORS.bold}TSDoc Coverage Report${COLORS.reset}
+
+`);
+  for (const pkg of result.packages) {
+    const color = pkg.percentage >= 80 ? COLORS.green : pkg.percentage >= 50 ? COLORS.yellow : COLORS.red;
+    process.stdout.write(`  ${color}${pkg.percentage.toString().padStart(3)}%${COLORS.reset} ${bar(pkg.percentage)} ${pkg.name}
+`);
+    if (pkg.total > 0) {
+      const parts = [];
+      if (pkg.documented > 0)
+        parts.push(`${COLORS.green}${pkg.documented} documented${COLORS.reset}`);
+      if (pkg.partial > 0)
+        parts.push(`${COLORS.yellow}${pkg.partial} partial${COLORS.reset}`);
+      if (pkg.undocumented > 0)
+        parts.push(`${COLORS.red}${pkg.undocumented} undocumented${COLORS.reset}`);
+      process.stdout.write(`       ${COLORS.dim}${pkg.total} declarations:${COLORS.reset} ${parts.join(", ")}
+`);
+    } else {
+      process.stdout.write(`       ${COLORS.dim}no exported declarations${COLORS.reset}
+`);
+    }
+  }
+  const { summary } = result;
+  process.stdout.write(`
+  ${COLORS.bold}Summary:${COLORS.reset} ${summary.percentage}% coverage (${summary.documented} documented, ${summary.partial} partial, ${summary.undocumented} undocumented of ${summary.total} total)
+`);
+  const minCoverage = options?.minCoverage ?? 0;
+  if (options?.strict && summary.percentage < minCoverage) {
+    process.stderr.write(`
+  ${COLORS.red}Coverage ${summary.percentage}% is below minimum threshold of ${minCoverage}%${COLORS.reset}
+`);
+  }
+  process.stdout.write(`
+`);
+}
+async function runCheckTsdoc(options = {}) {
+  const result = analyzeCheckTsdoc(options);
+  if (!result) {
+    process.stderr.write(`No packages found with src/index.ts entry points.
+` + `Searched: packages/*/src/index.ts, apps/*/src/index.ts, src/index.ts
+` + `Use --package <path> to specify a package path explicitly.
+`);
+    process.exit(1);
+  }
+  if (resolveJsonMode(options)) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+  } else {
+    printCheckTsdocHuman(result, {
+      strict: options.strict,
+      minCoverage: options.minCoverage
+    });
+  }
+  process.exit(result.ok ? 0 : 1);
+}
+
+// src/version.ts
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+var DEFAULT_VERSION = "0.0.0";
+function readPackageVersion() {
+  try {
+    const require2 = createRequire(import.meta.url);
+    const pkgPath = require2.resolve("@outfitter/tooling/package.json");
+    const packageJson = JSON.parse(readFileSync(pkgPath, "utf8"));
+    if (typeof packageJson.version === "string" && packageJson.version.length > 0) {
+      return packageJson.version;
+    }
+  } catch {}
+  return DEFAULT_VERSION;
+}
+var VERSION = readPackageVersion();
+
+export { coverageLevelSchema, declarationCoverageSchema, packageCoverageSchema, tsDocCheckResultSchema, analyzeSourceFile, calculateCoverage, analyzeCheckTsdoc, printCheckTsdocHuman, runCheckTsdoc, VERSION };

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@outfitter/tooling",
 	"description": "Dev tooling configuration presets for Outfitter projects (biome, typescript, lefthook, markdownlint)",
-	"version": "0.2.4",
+	"version": "0.3.3",
 	"type": "module",
 	"files": [
 		"dist",
@@ -31,6 +31,12 @@
 				"default": "./dist/cli/check.js"
 			}
 		},
+		"./cli/check-tsdoc": {
+			"import": {
+				"types": "./dist/cli/check-tsdoc.d.ts",
+				"default": "./dist/cli/check-tsdoc.js"
+			}
+		},
 		"./cli/fix": {
 			"import": {
 				"types": "./dist/cli/fix.d.ts",
@@ -70,19 +76,20 @@
 		"prepack": "bun run sync:exports",
 		"lint": "biome lint ./src",
 		"lint:fix": "biome lint --write ./src",
-		"test": "bun test",
+		"test": "bun run build:registry && bun test",
 		"typecheck": "tsc --noEmit",
 		"clean": "rm -rf dist registry",
 		"prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
 	},
 	"dependencies": {
-		"@outfitter/cli": "0.5.1",
+		"@outfitter/cli": "0.5.2",
 		"commander": "^14.0.2",
-		"zod": "^3.25.17"
+		"typescript": "^5.9.3",
+		"zod": "^4.3.5"
 	},
 	"devDependencies": {
-		"@types/bun": "^1.3.7",
-		"typescript": "^5.9.3",
+		"@outfitter/presets": "0.2.0",
+		"@types/bun": "^1.3.9",
 		"yaml": "^2.8.2"
 	},
 	"peerDependencies": {
@@ -102,7 +109,7 @@
 		}
 	},
 	"engines": {
-		"bun": ">=1.3.7"
+		"bun": ">=1.3.9"
 	},
 	"keywords": [
 		"outfitter",

package/registry/registry.json

@@ -22,11 +22,11 @@
 			"files": [
 				{
 					"path": "biome.json",
-					"content": "{\n\t\"$schema\": \"https://biomejs.dev/schemas/2.3.12/schema.json\",\n\t\"root\": false,\n\t\"javascript\": {\n\t\t\"globals\": [\"Bun\"]\n\t},\n\t\"linter\": {\n\t\t\"rules\": {\n\t\t\t\"complexity\": {\n\t\t\t\t\"useLiteralKeys\": \"off\",\n\t\t\t\t\"noVoid\": \"off\",\n\t\t\t\t\"noExcessiveCognitiveComplexity\": \"off\"\n\t\t\t},\n\t\t\t\"performance\": {\n\t\t\t\t\"useTopLevelRegex\": \"off\"\n\t\t\t},\n\t\t\t\"style\": {\n\t\t\t\t\"useBlockStatements\": \"off\"\n\t\t\t},\n\t\t\t\"suspicious\": {\n\t\t\t\t\"noConsole\": \"error\"\n\t\t\t}\n\t\t}\n\t},\n\t\"vcs\": {\n\t\t\"enabled\": true,\n\t\t\"clientKind\": \"git\",\n\t\t\"useIgnoreFile\": true\n\t},\n\t\"files\": {\n\t\t\"ignoreUnknown\": true,\n\t\t\"includes\": [\n\t\t\t\"**\",\n\t\t\t\"!**/node_modules\",\n\t\t\t\"!**/dist\",\n\t\t\t\"!**/.turbo\",\n\t\t\t\"!**/*.gen.ts\",\n\t\t\t\"!registry/registry.json\"\n\t\t]\n\t},\n\t\"overrides\": [\n\t\t{\n\t\t\t\"includes\": [\n\t\t\t\t\"packages/*/src/index.ts\",\n\t\t\t\t\"apps/*/src/index.ts\",\n\t\t\t\t\"**/index.ts\"\n\t\t\t],\n\t\t\t\"linter\": {\n\t\t\t\t\"rules\": {\n\t\t\t\t\t\"performance\": {\n\t\t\t\t\t\t\"noBarrelFile\": \"off\"\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t\"includes\": [\"**/*.test.ts\", \"**/__tests__/**/*\"],\n\t\t\t\"linter\": {\n\t\t\t\t\"rules\": {\n\t\t\t\t\t\"suspicious\": {\n\t\t\t\t\t\t\"useAwait\": \"off\",\n\t\t\t\t\t\t\"noConsole\": \"off\"\n\t\t\t\t\t},\n\t\t\t\t\t\"performance\": {\n\t\t\t\t\t\t\"noDelete\": \"off\"\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t\"includes\": [\"apps/**/*.ts\", \"scripts/**/*.ts\", \"**/scripts/**/*.ts\"],\n\t\t\t\"linter\": {\n\t\t\t\t\"rules\": {\n\t\t\t\t\t\"suspicious\": {\n\t\t\t\t\t\t\"noConsole\": \"off\"\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t]\n}\n"
+					"content": "{\n\t\"$schema\": \"https://biomejs.dev/schemas/2.4.4/schema.json\",\n\t\"root\": false,\n\t\"javascript\": {\n\t\t\"globals\": [\"Bun\"]\n\t},\n\t\"linter\": {\n\t\t\"rules\": {\n\t\t\t\"complexity\": {\n\t\t\t\t\"useLiteralKeys\": \"off\",\n\t\t\t\t\"noVoid\": \"off\",\n\t\t\t\t\"noExcessiveCognitiveComplexity\": \"off\"\n\t\t\t},\n\t\t\t\"performance\": {\n\t\t\t\t\"useTopLevelRegex\": \"off\"\n\t\t\t},\n\t\t\t\"style\": {\n\t\t\t\t\"useBlockStatements\": \"off\"\n\t\t\t},\n\t\t\t\"suspicious\": {\n\t\t\t\t\"noConsole\": \"error\"\n\t\t\t}\n\t\t}\n\t},\n\t\"vcs\": {\n\t\t\"enabled\": true,\n\t\t\"clientKind\": \"git\",\n\t\t\"useIgnoreFile\": true\n\t},\n\t\"files\": {\n\t\t\"ignoreUnknown\": true,\n\t\t\"includes\": [\n\t\t\t\"**\",\n\t\t\t\"!**/node_modules\",\n\t\t\t\"!**/dist\",\n\t\t\t\"!**/.turbo\",\n\t\t\t\"!**/*.gen.ts\",\n\t\t\t\"!registry/registry.json\"\n\t\t]\n\t},\n\t\"overrides\": [\n\t\t{\n\t\t\t\"includes\": [\n\t\t\t\t\"packages/*/src/index.ts\",\n\t\t\t\t\"apps/*/src/index.ts\",\n\t\t\t\t\"**/index.ts\"\n\t\t\t],\n\t\t\t\"linter\": {\n\t\t\t\t\"rules\": {\n\t\t\t\t\t\"performance\": {\n\t\t\t\t\t\t\"noBarrelFile\": \"off\"\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t\"includes\": [\"**/*.test.ts\", \"**/__tests__/**/*\"],\n\t\t\t\"linter\": {\n\t\t\t\t\"rules\": {\n\t\t\t\t\t\"suspicious\": {\n\t\t\t\t\t\t\"useAwait\": \"off\",\n\t\t\t\t\t\t\"noConsole\": \"off\"\n\t\t\t\t\t},\n\t\t\t\t\t\"performance\": {\n\t\t\t\t\t\t\"noDelete\": \"off\"\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t\"includes\": [\"apps/**/*.ts\", \"scripts/**/*.ts\", \"**/scripts/**/*.ts\"],\n\t\t\t\"linter\": {\n\t\t\t\t\"rules\": {\n\t\t\t\t\t\"suspicious\": {\n\t\t\t\t\t\t\"noConsole\": \"off\"\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t]\n}\n"
 				}
 			],
 			"devDependencies": {
-				"ultracite": "^7.1.1"
+				"ultracite": "7.2.3"
 			}
 		},
 		"lefthook": {
@@ -39,9 +39,9 @@
 				}
 			],
 			"devDependencies": {
-				"@outfitter/tooling": "^0.2.1",
-				"lefthook": "^2.0.16",
-				"ultracite": "^7.1.1"
+				"@outfitter/tooling": "^0.3.3",
+				"lefthook": "^2.1.1",
+				"ultracite": "7.2.3"
 			}
 		},
 		"markdownlint": {
@@ -60,7 +60,7 @@
 			"files": [
 				{
 					"path": "scripts/bootstrap.sh",
-					"content": "#!/usr/bin/env bash\n#\n# bootstrap.sh — Get this repo from clone to runnable\n#\n# Usage: ./scripts/bootstrap.sh [--force]\n#\n# By default, exits immediately if all tools and deps are present.\n# Use --force to run full bootstrap regardless.\n#\n\nset -euo pipefail\n\n# -----------------------------------------------------------------------------\n# Fast path — exit immediately if all tools and deps are present\n# -----------------------------------------------------------------------------\nif [[ \"${1:-}\" != \"--force\" ]]; then\n  all_present=true\n  command -v bun &>/dev/null || all_present=false\n  command -v gh &>/dev/null || all_present=false\n  command -v gt &>/dev/null || all_present=false\n  command -v markdownlint-cli2 &>/dev/null || all_present=false\n  [[ -d \"node_modules\" ]] || all_present=false\n\n  if $all_present; then\n    exit 0  # All good, nothing to do\n  fi\nfi\n\n# Strip --force if present\n[[ \"${1:-}\" == \"--force\" ]] && shift\n\n# Colors\nRED='\\033[0;31m'\nGREEN='\\033[0;32m'\nYELLOW='\\033[0;33m'\nBLUE='\\033[0;34m'\nNC='\\033[0m' # No Color\n\ninfo() { echo -e \"${BLUE}▸${NC} $1\"; }\nsuccess() { echo -e \"${GREEN}✓${NC} $1\"; }\nwarn() { echo -e \"${YELLOW}!${NC} $1\"; }\nerror() { echo -e \"${RED}✗${NC} $1\" >&2; }\n\n# Check if command exists\nhas() { command -v \"$1\" &>/dev/null; }\n\n# Detect OS\nOS=\"$(uname -s)\"\ncase \"$OS\" in\n  Darwin) IS_MACOS=true ;;\n  Linux)  IS_MACOS=false ;;\n  *)      error \"Unsupported OS: $OS\"; exit 1 ;;\nesac\n\n# -----------------------------------------------------------------------------\n# Homebrew (macOS only)\n# -----------------------------------------------------------------------------\ninstall_homebrew() {\n  if $IS_MACOS && ! has brew; then\n    info \"Installing Homebrew...\"\n    /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n    success \"Homebrew installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# Bun\n# -----------------------------------------------------------------------------\ninstall_bun() {\n  if has bun; then\n    success \"Bun already installed ($(bun --version))\"\n  else\n    info \"Installing Bun...\"\n    curl -fsSL https://bun.sh/install | bash\n    # Source the updated profile\n    export BUN_INSTALL=\"$HOME/.bun\"\n    export PATH=\"$BUN_INSTALL/bin:$PATH\"\n    success \"Bun installed ($(bun --version))\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# GitHub CLI (gh)\n# -----------------------------------------------------------------------------\ninstall_gh() {\n  if has gh; then\n    success \"GitHub CLI already installed ($(gh --version | head -1))\"\n  else\n    info \"Installing GitHub CLI...\"\n    if $IS_MACOS; then\n      brew install gh\n    else\n      # Linux: use official apt repo\n      curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg\n      echo \"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main\" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null\n      sudo apt update && sudo apt install gh -y\n    fi\n    success \"GitHub CLI installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# Graphite CLI (gt)\n# -----------------------------------------------------------------------------\ninstall_graphite() {\n  if has gt; then\n    success \"Graphite CLI already installed ($(gt --version 2>/dev/null || echo 'unknown'))\"\n  else\n    info \"Installing Graphite CLI...\"\n    if $IS_MACOS && has brew; then\n      brew install withgraphite/tap/graphite\n    else\n      bun install -g @withgraphite/graphite-cli\n    fi\n    success \"Graphite CLI installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# markdownlint-cli2\n# -----------------------------------------------------------------------------\ninstall_markdownlint() {\n  if has markdownlint-cli2; then\n    success \"markdownlint-cli2 already installed\"\n  else\n    info \"Installing markdownlint-cli2...\"\n    bun install -g markdownlint-cli2\n    success \"markdownlint-cli2 installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# Auth checks\n# -----------------------------------------------------------------------------\ncheck_auth() {\n  echo \"\"\n  info \"Checking authentication...\"\n\n  # GitHub CLI\n  if [[ -n \"${GH_TOKEN:-}\" ]] || [[ -n \"${GITHUB_TOKEN:-}\" ]]; then\n    success \"GitHub CLI token found in environment\"\n  elif gh auth status &>/dev/null; then\n    success \"GitHub CLI already authenticated\"\n  else\n    echo \"    GitHub CLI not authenticated. Run 'gh auth login' or set GH_TOKEN\"\n  fi\n\n  # Graphite CLI\n  if [[ -n \"${GT_AUTH_TOKEN:-}\" ]]; then\n    info \"Authenticating Graphite CLI...\"\n    gt auth --token \"$GT_AUTH_TOKEN\"\n    success \"Graphite CLI authenticated\"\n  elif gt auth status &>/dev/null 2>&1; then\n    success \"Graphite CLI already authenticated\"\n  else\n    echo \"    Graphite CLI not authenticated. Run 'gt auth' or set GT_AUTH_TOKEN\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# Project dependencies\n# -----------------------------------------------------------------------------\ninstall_deps() {\n  info \"Installing project dependencies...\"\n  bun install\n  success \"Dependencies installed\"\n}\n\n# -----------------------------------------------------------------------------\n# Main\n# -----------------------------------------------------------------------------\nmain() {\n  echo \"\"\n  echo -e \"${BLUE}Outfitter Kit Bootstrap${NC}\"\n  echo \"────────────────────────\"\n  echo \"\"\n\n  # Prerequisites\n  if $IS_MACOS; then\n    install_homebrew\n  fi\n\n  # Core tools\n  install_bun\n  install_gh\n  install_graphite\n  install_markdownlint\n\n  # Auth status\n  check_auth\n\n  echo \"\"\n\n  # Project setup\n  install_deps\n\n  echo \"\"\n  echo -e \"${GREEN}Bootstrap complete!${NC}\"\n  echo \"\"\n  echo \"Next steps:\"\n  echo \"  bun run build      # Build all packages\"\n  echo \"  bun run test       # Run tests\"\n  echo \"\"\n}\n\nmain \"$@\"\n",
+					"content": "#!/usr/bin/env bash\n#\n# bootstrap.sh — Get this repo from clone to runnable\n#\n# Usage: ./scripts/bootstrap.sh [--force]\n#\n# By default, exits immediately if all tools and deps are present.\n# Use --force to run full bootstrap regardless.\n#\n# This is the generic template distributed via `outfitter add bootstrap`.\n# It does NOT include project-specific tools like Graphite.\n# Add project-specific tools by extending this script or using the\n# TS bootstrap API's `extend` callback.\n\nset -euo pipefail\n\nSCRIPT_DIR=\"$(cd -- \"$(dirname -- \"${BASH_SOURCE[0]}\")\" && pwd)\"\nREPO_ROOT=\"$(cd -- \"$SCRIPT_DIR/..\" && pwd)\"\nBUN_VERSION_FILE=\"$REPO_ROOT/.bun-version\"\nPINNED_BUN_VERSION=\"\"\n\nif [[ -f \"$BUN_VERSION_FILE\" ]]; then\n  PINNED_BUN_VERSION=\"$(tr -d '[:space:]' < \"$BUN_VERSION_FILE\")\"\n  if [[ -z \"$PINNED_BUN_VERSION\" ]]; then\n    echo \"Warning: .bun-version is empty; falling back to latest Bun install\" >&2\n  fi\nfi\n\n# -----------------------------------------------------------------------------\n# Fast path — exit immediately if all tools and deps are present\n# -----------------------------------------------------------------------------\nif [[ \"${1:-}\" != \"--force\" ]]; then\n  all_present=true\n\n  if command -v bun &>/dev/null; then\n    installed_bun_version=\"$(bun --version)\"\n    if [[ -n \"$PINNED_BUN_VERSION\" ]]; then\n      [[ \"$installed_bun_version\" == \"$PINNED_BUN_VERSION\" ]] || all_present=false\n    fi\n  else\n    all_present=false\n  fi\n\n  command -v gh &>/dev/null || all_present=false\n  command -v markdownlint-cli2 &>/dev/null || all_present=false\n  [[ -d \"$REPO_ROOT/node_modules\" ]] || all_present=false\n\n  if $all_present; then\n    exit 0  # All good, nothing to do\n  fi\nfi\n\n# Strip --force if present\n[[ \"${1:-}\" == \"--force\" ]] && shift\n\n# Colors\nRED='\\033[0;31m'\nGREEN='\\033[0;32m'\nYELLOW='\\033[0;33m'\nBLUE='\\033[0;34m'\nNC='\\033[0m' # No Color\n\ninfo() { echo -e \"${BLUE}▸${NC} $1\"; }\nsuccess() { echo -e \"${GREEN}✓${NC} $1\"; }\nwarn() { echo -e \"${YELLOW}!${NC} $1\"; }\nerror() { echo -e \"${RED}✗${NC} $1\" >&2; }\n\n# Check if command exists\nhas() { command -v \"$1\" &>/dev/null; }\n\n# Detect OS\nOS=\"$(uname -s)\"\ncase \"$OS\" in\n  Darwin) IS_MACOS=true ;;\n  Linux)  IS_MACOS=false ;;\n  *)      error \"Unsupported OS: $OS\"; exit 1 ;;\nesac\n\n# -----------------------------------------------------------------------------\n# Homebrew (macOS only)\n# -----------------------------------------------------------------------------\ninstall_homebrew() {\n  if $IS_MACOS && ! has brew; then\n    info \"Installing Homebrew...\"\n    /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n    success \"Homebrew installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# Bun\n# -----------------------------------------------------------------------------\ninstall_bun() {\n  local installed_bun_version=\"\"\n\n  if has bun; then\n    installed_bun_version=\"$(bun --version)\"\n  fi\n\n  if [[ -n \"$installed_bun_version\" ]]; then\n    if [[ -n \"$PINNED_BUN_VERSION\" && \"$installed_bun_version\" == \"$PINNED_BUN_VERSION\" ]]; then\n      success \"Bun already installed ($installed_bun_version)\"\n      return\n    fi\n    if [[ -z \"$PINNED_BUN_VERSION\" ]]; then\n      success \"Bun already installed ($installed_bun_version)\"\n      return\n    fi\n  fi\n\n  if [[ -n \"$PINNED_BUN_VERSION\" && -n \"$installed_bun_version\" ]]; then\n    info \"Updating Bun from $installed_bun_version to $PINNED_BUN_VERSION...\"\n  elif [[ -n \"$PINNED_BUN_VERSION\" ]]; then\n    info \"Installing Bun $PINNED_BUN_VERSION...\"\n  else\n    info \"Installing Bun (latest stable)...\"\n  fi\n\n  if [[ -n \"$PINNED_BUN_VERSION\" ]]; then\n    curl -fsSL https://bun.sh/install | bash -s -- \"bun-v$PINNED_BUN_VERSION\"\n  else\n    curl -fsSL https://bun.sh/install | bash\n  fi\n\n  # Source the updated profile\n  export BUN_INSTALL=\"$HOME/.bun\"\n  export PATH=\"$BUN_INSTALL/bin:$PATH\"\n  hash -r\n\n  local resolved_bun_version\n  resolved_bun_version=\"$(bun --version)\"\n\n  if [[ -n \"$PINNED_BUN_VERSION\" && \"$resolved_bun_version\" != \"$PINNED_BUN_VERSION\" ]]; then\n    error \"Expected Bun $PINNED_BUN_VERSION but found $resolved_bun_version after install\"\n    exit 1\n  fi\n\n  success \"Bun ready ($resolved_bun_version)\"\n}\n\n# -----------------------------------------------------------------------------\n# GitHub CLI (gh)\n# -----------------------------------------------------------------------------\ninstall_gh() {\n  if has gh; then\n    success \"GitHub CLI already installed ($(gh --version | head -1))\"\n  else\n    info \"Installing GitHub CLI...\"\n    if $IS_MACOS; then\n      brew install gh\n    else\n      # Linux: use official apt repo\n      curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg\n      echo \"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main\" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null\n      sudo apt update && sudo apt install gh -y\n    fi\n    success \"GitHub CLI installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# markdownlint-cli2\n# -----------------------------------------------------------------------------\ninstall_markdownlint() {\n  if has markdownlint-cli2; then\n    success \"markdownlint-cli2 already installed\"\n  else\n    info \"Installing markdownlint-cli2...\"\n    bun install -g markdownlint-cli2\n    success \"markdownlint-cli2 installed\"\n  fi\n}\n\n# -----------------------------------------------------------------------------\n# Auth checks\n# -----------------------------------------------------------------------------\ncheck_auth() {\n  echo \"\"\n  info \"Checking authentication...\"\n\n  # GitHub CLI\n  if [[ -n \"${GH_TOKEN:-}\" ]] || [[ -n \"${GITHUB_TOKEN:-}\" ]]; then\n    success \"GitHub CLI token found in environment\"\n  elif gh auth status &>/dev/null; then\n    success \"GitHub CLI already authenticated\"\n  else\n    echo \"    GitHub CLI not authenticated. Run 'gh auth login' or set GH_TOKEN\"\n  fi\n\n  # Add project-specific auth checks (e.g., Graphite) below\n}\n\n# -----------------------------------------------------------------------------\n# Project dependencies\n# -----------------------------------------------------------------------------\ninstall_deps() {\n  info \"Installing project dependencies...\"\n  (\n    cd \"$REPO_ROOT\"\n    bun install\n  )\n  success \"Dependencies installed\"\n}\n\n# -----------------------------------------------------------------------------\n# Main\n# -----------------------------------------------------------------------------\nmain() {\n  echo \"\"\n  echo -e \"${BLUE}Outfitter Bootstrap${NC}\"\n  echo \"────────────────────────\"\n  echo \"\"\n\n  # Prerequisites\n  if $IS_MACOS; then\n    install_homebrew\n  fi\n\n  # Core tools\n  install_bun\n  install_gh\n  install_markdownlint\n  # Add project-specific tools (e.g., Graphite) below\n\n  # Auth status\n  check_auth\n\n  echo \"\"\n\n  # Project setup\n  install_deps\n\n  echo \"\"\n  echo -e \"${GREEN}Bootstrap complete!${NC}\"\n  echo \"\"\n  echo \"Next steps:\"\n  echo \"  bun run build      # Build all packages\"\n  echo \"  bun run test       # Run tests\"\n  echo \"\"\n}\n\nmain \"$@\"\n",
 					"executable": true
 				}
 			]

package/dist/cli/check-boundary-invocations.d.ts

@@ -1,34 +0,0 @@
-interface ScriptLocation {
-	readonly file: string;
-	readonly scriptName: string;
-	readonly command: string;
-}
-interface BoundaryViolation extends ScriptLocation {
-	readonly rule: "root-runs-package-src" | "cd-package-then-runs-src";
-}
-interface ReadScriptEntriesOptions {
-	readonly appManifestRelativePaths?: readonly string[];
-	readonly readPackageJson?: (filePath: string) => Promise<{
-		scripts?: Record<string, string>;
-	}>;
-}
-/**
-* Detect whether a single script command violates boundary invocation rules.
-*/
-declare function detectBoundaryViolation(location: ScriptLocation): BoundaryViolation | null;
-/**
-* Find all boundary violations across package/app script maps.
-*/
-declare function findBoundaryViolations(entries: readonly {
-	file: string;
-	scripts: Readonly<Record<string, string>>;
-}[]): BoundaryViolation[];
-declare function readScriptEntries(cwd: string, options?: ReadScriptEntriesOptions): Promise<{
-	file: string;
-	scripts: Record<string, string>;
-}[]>;
-/**
-* Run boundary invocation checks against root/apps package scripts.
-*/
-declare function runCheckBoundaryInvocations(): Promise<void>;
-export { runCheckBoundaryInvocations, readScriptEntries, findBoundaryViolations, detectBoundaryViolation, ScriptLocation, BoundaryViolation };

package/dist/cli/check-boundary-invocations.js

@@ -1,14 +0,0 @@
-// @bun
-import {
-  detectBoundaryViolation,
-  findBoundaryViolations,
-  readScriptEntries,
-  runCheckBoundaryInvocations
-} from "../shared/@outfitter/tooling-r9976n43.js";
-import"../shared/@outfitter/tooling-dvwh9qve.js";
-export {
-  runCheckBoundaryInvocations,
-  readScriptEntries,
-  findBoundaryViolations,
-  detectBoundaryViolation
-};

package/dist/cli/check-bunup-registry.d.ts

@@ -1,36 +0,0 @@
-/** Result of checking bunup workspace registration */
-interface RegistryCheckResult {
-	readonly ok: boolean;
-	readonly missing: string[];
-}
-/**
-* Extract the package name from a build script containing `bunup --filter`.
-*
-* @example
-* extractBunupFilterName("bunup --filter @outfitter/logging")
-* // => "@outfitter/logging"
-*
-* extractBunupFilterName("cd ../.. && bunup --filter @outfitter/types")
-* // => "@outfitter/types"
-*
-* extractBunupFilterName("tsc --noEmit")
-* // => null
-*/
-declare function extractBunupFilterName(script: string): string | null;
-/**
-* Find packages that have `bunup --filter` build scripts but are not
-* registered in the bunup workspace config.
-*
-* @param packagesWithFilter - Package names that have `bunup --filter` in their build script
-* @param registeredNames - Package names registered in bunup.config.ts
-* @returns Result with sorted list of missing packages
-*/
-declare function findUnregisteredPackages(packagesWithFilter: string[], registeredNames: string[]): RegistryCheckResult;
-/**
-* Run bunup registry check across all workspace packages.
-*
-* Scans packages/*/package.json for build scripts containing `bunup --filter`,
-* then verifies each is registered in bunup.config.ts.
-*/
-declare function runCheckBunupRegistry(): Promise<void>;
-export { runCheckBunupRegistry, findUnregisteredPackages, extractBunupFilterName, RegistryCheckResult };

package/dist/cli/check-bunup-registry.js

@@ -1,12 +0,0 @@
-// @bun
-import {
-  extractBunupFilterName,
-  findUnregisteredPackages,
-  runCheckBunupRegistry
-} from "../shared/@outfitter/tooling-t17gnh9b.js";
-import"../shared/@outfitter/tooling-dvwh9qve.js";
-export {
-  runCheckBunupRegistry,
-  findUnregisteredPackages,
-  extractBunupFilterName
-};