@outfitter/tooling 0.3.5 → 0.3.6-canary-20260317163745

package/dist/cli/index.js

@@ -11,8 +11,8 @@ import {
 } from "../shared/@outfitter/tooling-9ram55dd.js";
 import {
   runPrePush
-} from "../shared/@outfitter/tooling-2vv5y3s4.js";
-import"../shared/@outfitter/tooling-c8q6mj8z.js";
+} from "../shared/@outfitter/tooling-j7bczn7t.js";
+import"../shared/@outfitter/tooling-jyanp8q2.js";
 import {
   runFix
 } from "../shared/@outfitter/tooling-1hez6j9d.js";

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

@@ -1,2 +1,2 @@
-import { BunVersionCheckResult, PushChangedFiles, VerificationPlan, areFilesTestOnly, canBypassRedPhaseByChangedFiles, checkBunVersion, createVerificationPlan, getChangedFilesForPush, getCurrentBranch, hasPackageSourceChanges, hasRedPhaseBranchInContext, isRedPhaseBranch, isReleaseBranch, isScaffoldBranch, isTestOnlyPath, printTsdocSummary, readPackageScripts, runGit } from "../../shared/@outfitter/tooling-8qcwr06t.js";
-export { runGit, readPackageScripts, printTsdocSummary, isTestOnlyPath, isScaffoldBranch, isReleaseBranch, isRedPhaseBranch, hasRedPhaseBranchInContext, hasPackageSourceChanges, getCurrentBranch, getChangedFilesForPush, createVerificationPlan, checkBunVersion, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, BunVersionCheckResult };
+import { BunVersionCheckResult, ChangeCategory, ChangeScope, PushChangedFiles, VerificationPlan, areFilesTestOnly, canBypassRedPhaseByChangedFiles, categorizeChangedFiles, checkBunVersion, createVerificationPlan, getChangedFilesForPush, getCurrentBranch, hasPackageSourceChanges, hasRedPhaseBranchInContext, isRedPhaseBranch, isReleaseBranch, isScaffoldBranch, isTestOnlyPath, printTsdocSummary, readPackageScripts, runGit } from "../../shared/@outfitter/tooling-h6br5wds.js";
+export { runGit, readPackageScripts, printTsdocSummary, isTestOnlyPath, isScaffoldBranch, isReleaseBranch, isRedPhaseBranch, hasRedPhaseBranchInContext, hasPackageSourceChanges, getCurrentBranch, getChangedFilesForPush, createVerificationPlan, checkBunVersion, categorizeChangedFiles, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, ChangeScope, ChangeCategory, BunVersionCheckResult };

package/dist/cli/internal/pre-push-checks.js

@@ -2,6 +2,7 @@
 import {
   areFilesTestOnly,
   canBypassRedPhaseByChangedFiles,
+  categorizeChangedFiles,
   checkBunVersion,
   createVerificationPlan,
   getChangedFilesForPush,
@@ -15,7 +16,7 @@ import {
   printTsdocSummary,
   readPackageScripts,
   runGit
-} from "../../shared/@outfitter/tooling-c8q6mj8z.js";
+} from "../../shared/@outfitter/tooling-jyanp8q2.js";
 import"../../shared/@outfitter/tooling-5xxctk9b.js";
 import"../../shared/@outfitter/tooling-jnrs9rqd.js";
 export {
@@ -32,6 +33,7 @@ export {
   getChangedFilesForPush,
   createVerificationPlan,
   checkBunVersion,
+  categorizeChangedFiles,
   canBypassRedPhaseByChangedFiles,
   areFilesTestOnly
 };

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

@@ -1,7 +1,7 @@
-import { BunVersionCheckResult, PushChangedFiles, VerificationPlan, areFilesTestOnly, canBypassRedPhaseByChangedFiles, checkBunVersion, createVerificationPlan, hasPackageSourceChanges, isRedPhaseBranch, isReleaseBranch, isScaffoldBranch, isTestOnlyPath } from "../shared/@outfitter/tooling-8qcwr06t.js";
+import { BunVersionCheckResult, ChangeCategory, ChangeScope, PushChangedFiles, VerificationPlan, areFilesTestOnly, canBypassRedPhaseByChangedFiles, categorizeChangedFiles, checkBunVersion, createVerificationPlan, hasPackageSourceChanges, isRedPhaseBranch, isReleaseBranch, isScaffoldBranch, isTestOnlyPath } from "../shared/@outfitter/tooling-h6br5wds.js";
 interface PrePushOptions {
 	force?: boolean;
 }
 /** Main pre-push command */
 declare function runPrePush(options?: PrePushOptions): Promise<void>;
-export { runPrePush, isTestOnlyPath, isScaffoldBranch, isReleaseBranch, isRedPhaseBranch, hasPackageSourceChanges, createVerificationPlan, checkBunVersion, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, PrePushOptions, BunVersionCheckResult };
+export { runPrePush, isTestOnlyPath, isScaffoldBranch, isReleaseBranch, isRedPhaseBranch, hasPackageSourceChanges, createVerificationPlan, checkBunVersion, categorizeChangedFiles, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, PrePushOptions, ChangeScope, ChangeCategory, BunVersionCheckResult };

package/dist/cli/pre-push.js

@@ -1,10 +1,11 @@
 // @bun
 import {
   runPrePush
-} from "../shared/@outfitter/tooling-2vv5y3s4.js";
+} from "../shared/@outfitter/tooling-j7bczn7t.js";
 import {
   areFilesTestOnly,
   canBypassRedPhaseByChangedFiles,
+  categorizeChangedFiles,
   checkBunVersion,
   createVerificationPlan,
   hasPackageSourceChanges,
@@ -12,7 +13,7 @@ import {
   isReleaseBranch,
   isScaffoldBranch,
   isTestOnlyPath
-} from "../shared/@outfitter/tooling-c8q6mj8z.js";
+} from "../shared/@outfitter/tooling-jyanp8q2.js";
 import"../shared/@outfitter/tooling-5xxctk9b.js";
 import"../shared/@outfitter/tooling-jnrs9rqd.js";
 export {
@@ -24,6 +25,7 @@ export {
   hasPackageSourceChanges,
   createVerificationPlan,
   checkBunVersion,
+  categorizeChangedFiles,
   canBypassRedPhaseByChangedFiles,
   areFilesTestOnly
 };

package/dist/shared/@outfitter/{tooling-8qcwr06t.d.ts → tooling-h6br5wds.d.ts}

@@ -29,6 +29,45 @@ declare function canBypassRedPhaseByChangedFiles(changedFiles: PushChangedFiles)
 declare function hasPackageSourceChanges(changedFiles: PushChangedFiles): boolean;
 /** Determine which files have changed for the current push */
 declare function getChangedFilesForPush(): PushChangedFiles;
+/**
+* Change scope categories from most to least impactful.
+*
+* - `core`: Foundation packages (contracts, types) — full suite required
+* - `runtime`: Active packages (cli, mcp, config, etc.) — full suite required
+* - `ci`: CI/workflow config — full suite required
+* - `tooling`: Tooling package itself — full suite required
+* - `app`: apps/ changes — full suite required (actions, commands)
+* - `template`: Preset templates only — lightweight lint/format + full test suite
+* - `docs`: Docs, plugins, READMEs — lightweight checks only (lint, format)
+* - `config`: Root config files (.lefthook.yml, etc.) — lightweight checks
+*/
+type ChangeScope = "core" | "runtime" | "ci" | "tooling" | "app" | "template" | "docs" | "config";
+/** Result of categorizing changed files by their impact on verification scope. */
+interface ChangeCategory {
+	/** The highest-impact scope found among the changed files. */
+	readonly scope: ChangeScope;
+	/** Whether any changed file requires running the full verification suite. */
+	readonly requiresFullSuite: boolean;
+}
+/**
+* Categorize changed files to determine verification scope.
+*
+* Returns the highest-impact category found. If any file requires the
+* full suite, the entire push gets full verification.
+*
+* @param changedFiles - Files changed in the current push
+* @returns Category with scope name and whether full suite is required
+*
+* @example
+* ```typescript
+* const changed = getChangedFilesForPush();
+* const category = categorizeChangedFiles(changed);
+* if (!category.requiresFullSuite) {
+*   // Run lightweight checks only
+* }
+* ```
+*/
+declare function categorizeChangedFiles(changedFiles: PushChangedFiles): ChangeCategory;
 /** Check if any branch in context is a RED phase branch */
 declare function hasRedPhaseBranchInContext(currentBranch: string): boolean;
 type ScriptMap = Readonly<Record<string, string | undefined>>;
@@ -71,4 +110,4 @@ declare function checkBunVersion(projectRoot?: string): BunVersionCheckResult;
 * only -- the result does not affect the exit code.
 */
 declare function printTsdocSummary(log: (msg: string) => void): Promise<void>;
-export { getCurrentBranch, runGit, isRedPhaseBranch, isScaffoldBranch, isReleaseBranch, isTestOnlyPath, areFilesTestOnly, PushChangedFiles, canBypassRedPhaseByChangedFiles, hasPackageSourceChanges, getChangedFilesForPush, hasRedPhaseBranchInContext, VerificationPlan, createVerificationPlan, readPackageScripts, BunVersionCheckResult, checkBunVersion, printTsdocSummary };
+export { getCurrentBranch, runGit, isRedPhaseBranch, isScaffoldBranch, isReleaseBranch, isTestOnlyPath, areFilesTestOnly, PushChangedFiles, canBypassRedPhaseByChangedFiles, hasPackageSourceChanges, getChangedFilesForPush, ChangeScope, ChangeCategory, categorizeChangedFiles, hasRedPhaseBranchInContext, VerificationPlan, createVerificationPlan, readPackageScripts, BunVersionCheckResult, checkBunVersion, printTsdocSummary };

package/dist/shared/@outfitter/{tooling-2vv5y3s4.js → tooling-j7bczn7t.js}

@@ -1,6 +1,7 @@
 // @bun
 import {
   canBypassRedPhaseByChangedFiles,
+  categorizeChangedFiles,
   checkBunVersion,
   createVerificationPlan,
   getChangedFilesForPush,
@@ -12,7 +13,7 @@ import {
   isScaffoldBranch,
   printTsdocSummary,
   readPackageScripts
-} from "./tooling-c8q6mj8z.js";
+} from "./tooling-jyanp8q2.js";
 // packages/tooling/src/cli/pre-push.ts
 var COLORS = {
   reset: "\x1B[0m",
@@ -33,8 +34,7 @@ function runScript(scriptName) {
   });
   return result.exitCode === 0;
 }
-function maybeSkipForRedPhase(reason, branch) {
-  const changedFiles = getChangedFilesForPush();
+function maybeSkipForRedPhase(reason, branch, changedFiles) {
   if (!changedFiles.deterministic) {
     log(`${COLORS.yellow}RED-phase bypass denied${COLORS.reset}: could not determine full push diff range`);
     log("Running strict verification.");
@@ -85,21 +85,63 @@ async function runPrePush(options = {}) {
     process.exitCode = 0;
     return;
   }
+  const changedFiles = getChangedFilesForPush();
   if (isRedPhaseBranch(branch)) {
-    if (maybeSkipForRedPhase("branch", branch)) {
+    if (maybeSkipForRedPhase("branch", branch, changedFiles)) {
       process.exitCode = 0;
       return;
     }
   }
   if (isScaffoldBranch(branch)) {
     if (hasRedPhaseBranchInContext(branch)) {
-      if (maybeSkipForRedPhase("context", branch)) {
+      if (maybeSkipForRedPhase("context", branch, changedFiles)) {
         process.exitCode = 0;
         return;
       }
     }
   }
-  const plan = createVerificationPlan(readPackageScripts());
+  const changeCategory = categorizeChangedFiles(changedFiles);
+  const scripts = readPackageScripts();
+  if (!changeCategory.requiresFullSuite) {
+    log(`${COLORS.yellow}Scoped verification${COLORS.reset}: changes are ${COLORS.blue}${changeCategory.scope}${COLORS.reset}-only`);
+    log(`Changed files (${changedFiles.files.length}): ${changedFiles.files.slice(0, 5).join(", ")}${changedFiles.files.length > 5 ? ` ...+${changedFiles.files.length - 5} more` : ""}`);
+    log("");
+    const lightweightScripts = [];
+    if (scripts["check"]) {
+      lightweightScripts.push("check");
+    } else if (scripts["lint"]) {
+      lightweightScripts.push("lint");
+    }
+    if (lightweightScripts.length === 0) {
+      log(`${COLORS.yellow}No lint/format script found${COLORS.reset} \u2014 falling through to full verification`);
+    } else {
+      if (changeCategory.scope === "template") {
+        if (scripts["test"]) {
+          lightweightScripts.push("test");
+          log(`Running: lint/format + tests (template changes need template guardrails)`);
+        } else {
+          log(`${COLORS.yellow}Warning${COLORS.reset}: no \`test\` script found \u2014 template guardrail tests will not run`);
+          log(`Running: lint/format only`);
+        }
+      } else {
+        log(`Running: lint/format only`);
+      }
+      for (const scriptName of lightweightScripts) {
+        if (runScript(scriptName)) {
+          continue;
+        }
+        log("");
+        log(`${COLORS.red}Scoped verification failed${COLORS.reset} on: ${scriptName}`);
+        process.exitCode = 1;
+        return;
+      }
+      log("");
+      log(`${COLORS.green}Scoped verification passed${COLORS.reset} (${changeCategory.scope}-only changes)`);
+      process.exitCode = 0;
+      return;
+    }
+  }
+  const plan = createVerificationPlan(scripts);
   if (!plan.ok) {
     log(`${COLORS.red}Strict pre-push verification is not configured${COLORS.reset}`);
     log(plan.error);
@@ -111,7 +153,10 @@ async function runPrePush(options = {}) {
     process.exitCode = 1;
     return;
   }
-  log(`Running strict verification for branch: ${COLORS.blue}${branch}${COLORS.reset}`);
+  log(`Running ${COLORS.blue}full${COLORS.reset} verification for branch: ${COLORS.blue}${branch}${COLORS.reset}`);
+  if (changeCategory.requiresFullSuite) {
+    log(`Change scope: ${COLORS.yellow}${changeCategory.scope}${COLORS.reset} (requires full suite)`);
+  }
   if (plan.source === "verify:push" || plan.source === "verify:ci") {
     log(`Using \`${plan.source}\` script.`);
   } else {
@@ -131,7 +176,6 @@ async function runPrePush(options = {}) {
     process.exitCode = 1;
     return;
   }
-  const changedFiles = getChangedFilesForPush();
   if (hasPackageSourceChanges(changedFiles)) {
     try {
       await printTsdocSummary(log);

package/dist/shared/@outfitter/{tooling-c8q6mj8z.js → tooling-jyanp8q2.js}

@@ -117,6 +117,91 @@ function getChangedFilesForPush() {
     source: "undetermined"
   };
 }
+var SCOPE_PATTERNS = [
+  { pattern: /^\.github\//, scope: "ci", requiresFullSuite: true },
+  { pattern: /^turbo\.json$/, scope: "ci", requiresFullSuite: true },
+  {
+    pattern: /^packages\/[^/]+\/(README|CHANGELOG|CONTRIBUTING|MIGRATION)\.md$/i,
+    scope: "docs",
+    requiresFullSuite: false
+  },
+  { pattern: /^packages\/contracts\//, scope: "core", requiresFullSuite: true },
+  { pattern: /^packages\/types\//, scope: "core", requiresFullSuite: true },
+  {
+    pattern: /^packages\/tooling\//,
+    scope: "tooling",
+    requiresFullSuite: true
+  },
+  { pattern: /^apps\//, scope: "app", requiresFullSuite: true },
+  {
+    pattern: /^packages\/presets\/presets\/.*\.template$/,
+    scope: "template",
+    requiresFullSuite: false
+  },
+  {
+    pattern: /^packages\/presets\//,
+    scope: "runtime",
+    requiresFullSuite: true
+  },
+  {
+    pattern: /^packages\//,
+    scope: "runtime",
+    requiresFullSuite: true
+  },
+  {
+    pattern: /^plugins\/.*\.md$/i,
+    scope: "docs",
+    requiresFullSuite: false
+  },
+  {
+    pattern: /^plugins\/(?:.+\/)?plugin\.json$/i,
+    scope: "docs",
+    requiresFullSuite: false
+  },
+  {
+    pattern: /^plugins\//,
+    scope: "app",
+    requiresFullSuite: true
+  },
+  { pattern: /^docs\//, scope: "docs", requiresFullSuite: false },
+  { pattern: /\.md$/i, scope: "docs", requiresFullSuite: false },
+  {
+    pattern: /^\.(lefthook|oxlintrc|oxfmtrc|markdownlint)(\.|$)/,
+    scope: "config",
+    requiresFullSuite: false
+  },
+  { pattern: /^scripts\//, scope: "config", requiresFullSuite: false }
+];
+var SCOPE_RANK = {
+  template: 2,
+  config: 1,
+  docs: 0
+};
+function categorizeChangedFiles(changedFiles) {
+  if (!changedFiles.deterministic) {
+    return { scope: "config", requiresFullSuite: true };
+  }
+  if (changedFiles.files.length === 0) {
+    return { scope: "config", requiresFullSuite: true };
+  }
+  let highestScope = null;
+  let highestRank = -1;
+  for (const file of changedFiles.files) {
+    const matched = SCOPE_PATTERNS.find((p) => p.pattern.test(file));
+    if (!matched) {
+      return { scope: "config", requiresFullSuite: true };
+    }
+    if (matched.requiresFullSuite) {
+      return { scope: matched.scope, requiresFullSuite: true };
+    }
+    const rank = SCOPE_RANK[matched.scope] ?? 0;
+    if (rank > highestRank) {
+      highestRank = rank;
+      highestScope = matched.scope;
+    }
+  }
+  return { scope: highestScope, requiresFullSuite: false };
+}
 function hasRedPhaseBranchInContext(currentBranch) {
   let branches = [];
   try {
@@ -225,4 +310,4 @@ async function printTsdocSummary(log) {
   log(`${BLUE}TSDoc${RESET}: ${coverage.percentage}% coverage (${parts.join(", ")} of ${coverage.total} total)`);
 }
 
-export { getCurrentBranch, runGit, isRedPhaseBranch, isScaffoldBranch, isReleaseBranch, isTestOnlyPath, areFilesTestOnly, canBypassRedPhaseByChangedFiles, hasPackageSourceChanges, getChangedFilesForPush, hasRedPhaseBranchInContext, createVerificationPlan, readPackageScripts, checkBunVersion, printTsdocSummary };
+export { getCurrentBranch, runGit, isRedPhaseBranch, isScaffoldBranch, isReleaseBranch, isTestOnlyPath, areFilesTestOnly, canBypassRedPhaseByChangedFiles, hasPackageSourceChanges, getChangedFilesForPush, categorizeChangedFiles, hasRedPhaseBranchInContext, createVerificationPlan, readPackageScripts, checkBunVersion, printTsdocSummary };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/tooling",
   "description": "Dev tooling configuration presets for Outfitter projects (oxlint/oxfmt, typescript, lefthook, markdownlint)",
-  "version": "0.3.5",
+  "version": "0.3.6-canary-20260317163745",
   "type": "module",
   "files": [
     "dist",
@@ -96,7 +96,7 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@outfitter/presets": "0.3.0",
+    "@outfitter/presets": "0.3.1-canary-20260317163745",
     "@types/bun": "^1.3.9",
     "yaml": "^2.8.2"
   },

package/registry/registry.json

@@ -46,7 +46,7 @@
 				}
 			],
 			"devDependencies": {
-				"@outfitter/tooling": "^0.3.5",
+				"@outfitter/tooling": "^0.3.6-canary-20260317163745",
 				"lefthook": "^2.1.1",
 				"ultracite": "7.2.3"
 			}