@outfitter/tooling 0.2.1 → 0.2.3

package/dist/cli/init.js

@@ -3,7 +3,8 @@ import {
   buildUltraciteCommand,
   detectFrameworks,
   runInit
-} from "../shared/@outfitter/tooling-xaxdr9da.js";
+} from "../shared/@outfitter/tooling-mxwc1n8w.js";
+import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
   runInit,
   detectFrameworks,

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

@@ -1,3 +1,36 @@
+/**
+* Check if branch is a TDD RED phase branch
+*/
+declare function isRedPhaseBranch(branch: string): boolean;
+/**
+* Check if branch is a scaffold branch
+*/
+declare function isScaffoldBranch(branch: string): boolean;
+declare function isTestOnlyPath(path: string): boolean;
+declare function areFilesTestOnly(paths: readonly string[]): boolean;
+interface PushChangedFiles {
+	readonly files: readonly string[];
+	readonly deterministic: boolean;
+	readonly source: "upstream" | "baseRef" | "undetermined";
+}
+declare function canBypassRedPhaseByChangedFiles(changedFiles: PushChangedFiles): boolean;
+type ScriptMap = Readonly<Record<string, string | undefined>>;
+type VerificationPlan = {
+	readonly ok: true;
+	readonly scripts: readonly string[];
+	readonly source: "verify:ci" | "fallback";
+} | {
+	readonly ok: false;
+	readonly error: string;
+};
+/**
+* Derive strict pre-push verification from package scripts.
+*
+* Priority:
+* 1) `verify:ci`
+* 2) fallback sequence: `typecheck`, `check|lint`, `build`, `test`
+*/
+declare function createVerificationPlan(scripts: ScriptMap): VerificationPlan;
 interface PrePushOptions {
 	force?: boolean;
 }
@@ -5,4 +38,4 @@ interface PrePushOptions {
 * Main pre-push command
 */
 declare function runPrePush(options?: PrePushOptions): Promise<void>;
-export { runPrePush, PrePushOptions };
+export { runPrePush, isTestOnlyPath, isScaffoldBranch, isRedPhaseBranch, createVerificationPlan, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, PrePushOptions };

package/dist/cli/pre-push.js

@@ -1,7 +1,20 @@
 // @bun
 import {
+  areFilesTestOnly,
+  canBypassRedPhaseByChangedFiles,
+  createVerificationPlan,
+  isRedPhaseBranch,
+  isScaffoldBranch,
+  isTestOnlyPath,
   runPrePush
-} from "../shared/@outfitter/tooling-qm7jeg0d.js";
+} from "../shared/@outfitter/tooling-8sd32ts6.js";
+import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
-  runPrePush
+  runPrePush,
+  isTestOnlyPath,
+  isScaffoldBranch,
+  isRedPhaseBranch,
+  createVerificationPlan,
+  canBypassRedPhaseByChangedFiles,
+  areFilesTestOnly
 };

package/dist/cli/upgrade-bun.js

@@ -1,7 +1,8 @@
 // @bun
 import {
   runUpgradeBun
-} from "../shared/@outfitter/tooling-75j500dv.js";
+} from "../shared/@outfitter/tooling-9yzd08v1.js";
+import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
   runUpgradeBun
 };

package/dist/index.d.ts

@@ -1,36 +1,111 @@
-import "./shared/@outfitter/tooling-xqwn46sx";
-import { AddBlockOptions, AddBlockResult, Block, BlockDefinition, BlockSchema, FileEntry, FileEntrySchema, Registry, RegistryBuildConfig, RegistrySchema } from "./shared/@outfitter/tooling-sjm8nebx";
-/**
-* @outfitter/tooling
-*
-* Dev tooling configuration presets for Outfitter projects.
-* Provides standardized biome, TypeScript, lefthook, and markdownlint configurations.
-*
-* @example
-* ```json
-* // biome.json
-* {
-*   "extends": ["ultracite/biome/core", "@outfitter/tooling/biome.json"]
-* }
-* ```
-*
-* @example
-* ```json
-* // tsconfig.json
-* {
-*   "extends": "@outfitter/tooling/tsconfig.preset.bun.json"
-* }
-* ```
-*
-* @example
-* ```yaml
-* # .lefthook.yml
-* extends:
-*   - node_modules/@outfitter/tooling/lefthook.yml
-* ```
-*
-* @packageDocumentation
-*/
-/** Package version */
-declare const VERSION = "0.1.0-rc.1";
+import { ZodType } from "zod";
+/**
+* File entry in a block.
+*/
+interface FileEntry {
+	/** Destination path relative to project root */
+	path: string;
+	/** File contents (embedded in registry) */
+	content: string;
+	/** Whether to chmod +x after copying */
+	executable?: boolean | undefined;
+	/** Whether to process as a template (future) */
+	template?: boolean | undefined;
+}
+/**
+* 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>;
+/**
+* Block in the registry.
+*/
+interface Block {
+	/** Block name (matches the key in blocks record) */
+	name: string;
+	/** Human-readable description */
+	description: string;
+	/** Files included in this block */
+	files?: FileEntry[] | undefined;
+	/** npm dependencies to add to package.json */
+	dependencies?: Record<string, string> | undefined;
+	/** npm devDependencies to add to package.json */
+	devDependencies?: Record<string, string> | undefined;
+	/** Other blocks this block extends (for composite blocks) */
+	extends?: string[] | undefined;
+}
+/**
+* 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>;
+/**
+* Complete registry structure.
+*/
+interface Registry {
+	/** Registry schema version */
+	version: string;
+	/** Map of block name to block definition */
+	blocks: Record<string, Block>;
+}
+/**
+* Schema for the complete registry.
+* Contains all available blocks with their files and metadata.
+*/
+declare const RegistrySchema: ZodType<Registry>;
+/**
+* Block definition used in the build script.
+* Specifies how to collect source files into a block.
+*/
+interface BlockDefinition {
+	/** Human-readable description */
+	description: string;
+	/** Source file paths (relative to repo root) */
+	files?: string[];
+	/** Remap source paths to destination paths */
+	remap?: Record<string, string>;
+	/** npm dependencies */
+	dependencies?: Record<string, string>;
+	/** npm devDependencies */
+	devDependencies?: Record<string, string>;
+	/** Other blocks this block extends */
+	extends?: string[];
+}
+/**
+* Configuration for the registry build.
+*/
+interface RegistryBuildConfig {
+	/** Registry schema version */
+	version: string;
+	/** Block definitions */
+	blocks: Record<string, BlockDefinition>;
+}
+/**
+* Result of adding a block to a project.
+*/
+interface AddBlockResult {
+	/** Files that were created */
+	created: string[];
+	/** Files that were skipped (already exist) */
+	skipped: string[];
+	/** Files that were overwritten (with --force) */
+	overwritten: string[];
+	/** Dependencies added to package.json */
+	dependencies: Record<string, string>;
+	/** devDependencies added to package.json */
+	devDependencies: Record<string, string>;
+}
+/**
+* Options for the add command.
+*/
+interface AddBlockOptions {
+	/** Overwrite existing files */
+	force?: boolean;
+	/** Show what would be added without making changes */
+	dryRun?: boolean;
+	/** Working directory (defaults to cwd) */
+	cwd?: string;
+}
+/** 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 };

package/dist/index.js

@@ -1,13 +1,28 @@
-// @bun
-import"./shared/@outfitter/tooling-kcvs6mys.js";
 import {
-  BlockSchema,
-  FileEntrySchema,
-  RegistrySchema
-} from "./shared/@outfitter/tooling-g83d0kjv.js";
+  VERSION
+} from "./shared/chunk-8aenrm6f.js";
+import"./shared/chunk-3s189drz.js";
 
-// packages/tooling/src/index.ts
-var VERSION = "0.1.0-rc.1";
+// src/registry/schema.ts
+import { z } from "zod";
+var FileEntrySchema = z.object({
+  path: z.string().min(1),
+  content: z.string(),
+  executable: z.boolean().optional(),
+  template: z.boolean().optional()
+});
+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(),
+  extends: z.array(z.string()).optional()
+});
+var RegistrySchema = z.object({
+  version: z.string(),
+  blocks: z.record(BlockSchema)
+});
 export {
   VERSION,
   RegistrySchema,

package/dist/registry/build.d.ts

@@ -0,0 +1,6 @@
+import { RegistryBuildConfig } from "../shared/@outfitter/tooling-sjm8nebx";
+/**
+* Registry build configuration
+*/
+declare const REGISTRY_CONFIG: RegistryBuildConfig;
+export { REGISTRY_CONFIG };

package/dist/registry/build.js

@@ -1,9 +1,20 @@
 #!/usr/bin/env bun
 // @bun
+import"../shared/@outfitter/tooling-dvwh9qve.js";
 
 // packages/tooling/src/registry/build.ts
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  statSync,
+  writeFileSync
+} from "fs";
 import { dirname, join } from "path";
+function log(message) {
+  process.stdout.write(`${message}
+`);
+}
 function findRepoRoot(startDir) {
   let dir = startDir;
   while (dir !== "/") {
@@ -76,27 +87,30 @@ var REGISTRY_CONFIG = {
   blocks: {
     claude: {
       description: "Claude Code settings and hooks for automated formatting",
-      files: [
-        ".claude/settings.json",
-        ".claude/hooks/format-code-on-stop.sh"
-      ]
+      files: [".claude/settings.json", ".claude/hooks/format-code-on-stop.sh"]
     },
     biome: {
       description: "Biome linter/formatter configuration via Ultracite",
       files: ["packages/tooling/biome.json"],
       remap: { "packages/tooling/biome.json": "biome.json" },
-      devDependencies: { ultracite: "^7.0.0" }
+      devDependencies: { ultracite: "^7.1.1" }
     },
     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: { lefthook: "^2.0.0" }
+      devDependencies: {
+        "@outfitter/tooling": "^0.2.1",
+        lefthook: "^2.0.16",
+        ultracite: "^7.1.1"
+      }
     },
     markdownlint: {
       description: "Markdown linting configuration via markdownlint-cli2",
       files: ["packages/tooling/.markdownlint-cli2.jsonc"],
-      remap: { "packages/tooling/.markdownlint-cli2.jsonc": ".markdownlint-cli2.jsonc" }
+      remap: {
+        "packages/tooling/.markdownlint-cli2.jsonc": ".markdownlint-cli2.jsonc"
+      }
     },
     bootstrap: {
       description: "Project bootstrap script for installing tools and dependencies",
@@ -113,16 +127,21 @@ function main() {
   const repoRoot = findRepoRoot(scriptDir);
   const outputDir = join(repoRoot, "packages/tooling/registry");
   const outputPath = join(outputDir, "registry.json");
-  console.log(`Building registry from: ${repoRoot}`);
+  log(`Building registry from: ${repoRoot}`);
   if (!existsSync(outputDir)) {
     mkdirSync(outputDir, { recursive: true });
   }
   const registry = buildRegistry(REGISTRY_CONFIG, repoRoot);
-  writeFileSync(outputPath, JSON.stringify(registry, null, 2) + `
+  writeFileSync(outputPath, `${JSON.stringify(registry, null, "\t")}
 `);
   const blockCount = Object.keys(registry.blocks).length;
   const fileCount = Object.values(registry.blocks).flatMap((b) => b.files ?? []).length;
-  console.log(`\u2713 Generated ${outputPath}`);
-  console.log(`  ${blockCount} blocks, ${fileCount} files embedded`);
+  log(`\u2713 Generated ${outputPath}`);
+  log(`  ${blockCount} blocks, ${fileCount} files embedded`);
+}
+if (import.meta.main) {
+  main();
 }
-main();
+export {
+  REGISTRY_CONFIG
+};

package/dist/registry/index.js

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

package/dist/registry/schema.js

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

package/dist/shared/@outfitter/{tooling-xx1146e3.js → tooling-0x5q15ec.js}

@@ -9,7 +9,8 @@ function buildCheckCommand(options) {
 }
 async function runCheck(paths = []) {
   const cmd = buildCheckCommand({ paths });
-  console.log(`Running: bun x ${cmd.join(" ")}`);
+  process.stdout.write(`Running: bun x ${cmd.join(" ")}
+`);
   const proc = Bun.spawn(["bun", "x", ...cmd], {
     stdio: ["inherit", "inherit", "inherit"]
   });

package/dist/shared/@outfitter/tooling-1y8w5ahg.js

@@ -0,0 +1,70 @@
+// @bun
+// packages/tooling/src/cli/check-clean-tree.ts
+function parseGitDiff(diffOutput) {
+  return diffOutput.split(`
+`).map((line) => line.trim()).filter(Boolean);
+}
+function parseUntrackedFiles(lsOutput) {
+  return lsOutput.split(`
+`).map((line) => line.trim()).filter(Boolean);
+}
+function isCleanTree(status) {
+  return status.modified.length === 0 && status.untracked.length === 0;
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  dim: "\x1B[2m"
+};
+async function runCheckCleanTree(options = {}) {
+  const pathArgs = options.paths ?? [];
+  const diffResult = Bun.spawnSync(["git", "diff", "HEAD", "--name-only", "--", ...pathArgs], { stderr: "pipe" });
+  if (diffResult.exitCode !== 0) {
+    process.stderr.write(`Failed to run git diff
+`);
+    process.exit(1);
+  }
+  const modified = parseGitDiff(diffResult.stdout.toString());
+  const lsResult = Bun.spawnSync(["git", "ls-files", "--others", "--exclude-standard", "--", ...pathArgs], { stderr: "pipe" });
+  if (lsResult.exitCode !== 0) {
+    process.stderr.write(`Failed to run git ls-files
+`);
+    process.exit(1);
+  }
+  const untracked = parseUntrackedFiles(lsResult.stdout.toString());
+  const clean = modified.length === 0 && untracked.length === 0;
+  const status = { clean, modified, untracked };
+  if (status.clean) {
+    process.stdout.write(`${COLORS.green}Working tree is clean.${COLORS.reset}
+`);
+    process.exit(0);
+  }
+  process.stderr.write(`${COLORS.red}Working tree is dirty after verification:${COLORS.reset}
+
+`);
+  if (modified.length > 0) {
+    process.stderr.write(`Modified files:
+`);
+    for (const file of modified) {
+      process.stderr.write(`  ${COLORS.dim}M${COLORS.reset} ${file}
+`);
+    }
+  }
+  if (untracked.length > 0) {
+    process.stderr.write(`Untracked files:
+`);
+    for (const file of untracked) {
+      process.stderr.write(`  ${COLORS.dim}?${COLORS.reset} ${file}
+`);
+    }
+  }
+  process.stderr.write(`
+This likely means a build step produced uncommitted changes.
+`);
+  process.stderr.write(`Commit these changes or add them to .gitignore.
+`);
+  process.exit(1);
+}
+
+export { parseGitDiff, parseUntrackedFiles, isCleanTree, runCheckCleanTree };

package/dist/shared/@outfitter/tooling-3w8vr2w3.js

@@ -0,0 +1,94 @@
+// @bun
+// packages/tooling/src/cli/check-changeset.ts
+function getChangedPackagePaths(files) {
+  const packageNames = new Set;
+  const pattern = /^packages\/([^/]+)\/src\//;
+  for (const file of files) {
+    const match = pattern.exec(file);
+    if (match?.[1]) {
+      packageNames.add(match[1]);
+    }
+  }
+  return [...packageNames].sort();
+}
+function getChangedChangesetFiles(files) {
+  const pattern = /^\.changeset\/([^/]+\.md)$/;
+  const results = [];
+  for (const file of files) {
+    const match = pattern.exec(file);
+    if (match?.[1] && match[1] !== "README.md") {
+      results.push(match[1]);
+    }
+  }
+  return results.sort();
+}
+function checkChangesetRequired(changedPackages, changesetFiles) {
+  if (changedPackages.length === 0) {
+    return { ok: true, missingFor: [] };
+  }
+  if (changesetFiles.length > 0) {
+    return { ok: true, missingFor: [] };
+  }
+  return { ok: false, missingFor: changedPackages };
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  dim: "\x1B[2m"
+};
+async function runCheckChangeset(options = {}) {
+  if (options.skip || process.env["NO_CHANGESET"] === "1") {
+    process.stdout.write(`${COLORS.dim}check-changeset skipped (NO_CHANGESET=1)${COLORS.reset}
+`);
+    process.exit(0);
+  }
+  if (process.env["GITHUB_EVENT_NAME"] === "push") {
+    process.stdout.write(`${COLORS.dim}check-changeset skipped (push event)${COLORS.reset}
+`);
+    process.exit(0);
+  }
+  const cwd = process.cwd();
+  let changedFiles;
+  try {
+    const proc = Bun.spawnSync(["git", "diff", "--name-only", "origin/main...HEAD"], { cwd });
+    if (proc.exitCode !== 0) {
+      process.exit(0);
+    }
+    changedFiles = proc.stdout.toString().trim().split(`
+`).filter((line) => line.length > 0);
+  } catch {
+    process.exit(0);
+  }
+  const changedPackages = getChangedPackagePaths(changedFiles);
+  if (changedPackages.length === 0) {
+    process.stdout.write(`${COLORS.green}No package source changes detected.${COLORS.reset}
+`);
+    process.exit(0);
+  }
+  const changesetFiles = getChangedChangesetFiles(changedFiles);
+  const check = checkChangesetRequired(changedPackages, changesetFiles);
+  if (check.ok) {
+    process.stdout.write(`${COLORS.green}Changeset found for ${changedPackages.length} changed package(s).${COLORS.reset}
+`);
+    process.exit(0);
+  }
+  process.stderr.write(`${COLORS.red}Missing changeset!${COLORS.reset}
+
+`);
+  process.stderr.write(`The following packages have source changes but no changeset:
+
+`);
+  for (const pkg of check.missingFor) {
+    process.stderr.write(`  ${COLORS.yellow}@outfitter/${pkg}${COLORS.reset}
+`);
+  }
+  process.stderr.write(`
+Run ${COLORS.blue}bun run changeset${COLORS.reset} to add a changeset, ` + `or add the ${COLORS.blue}no-changeset${COLORS.reset} label to skip.
+`);
+  process.exit(1);
+}
+
+export { getChangedPackagePaths, getChangedChangesetFiles, checkChangesetRequired, runCheckChangeset };