@ontrails/regrade 1.0.0-beta.29 → 1.0.0-beta.32

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # @ontrails/regrade
 
+## 1.0.0-beta.32
+
+### Patch Changes
+
+- f3c4fef: Export a shared `escapeRegExp` helper from core and migrate first-party callers off local copies.
+- fe72b84: Fold remaining Regrade and Warden scan-target surfaces onto the shared path-scope vocabulary.
+- Updated dependencies [3e5c0fc]
+- Updated dependencies [f3c4fef]
+- Updated dependencies [cb0a9d8]
+- Updated dependencies [21c6dda]
+- Updated dependencies [fe72b84]
+  - @ontrails/core@1.0.0-beta.32
+  - @ontrails/warden@1.0.0-beta.32
+
+## 1.0.0-beta.31
+
+### Patch Changes
+
+- e2f3d23: Default Regrade reports to actionable entries, add skip counts grouped by
+  reason, and expose an `includeEntries` option for full report inventories.
+- 9be2b7e: Load project-local Warden term-rewrite rules from the Regrade root so repo-owned
+  migration classes can run through `trails regrade`.
+- 47f782c: Add occurrence-level vocabulary regrade reports with plan, ledger,
+  and completion-gate facts. The Trails `regrade` operator command now supports
+  positional `<from> <to>` regrade runs and exposes the same capability through
+  the curated MCP surface.
+- ee9f3ae: Let Warden fix capabilities declare downstream scan targets and have Regrade
+  honor those targets for Warden-backed term-rewrite classes.
+
+  Dogfood the first safe facet-to-trailhead prose rewrite through project-local
+  Warden rules and Regrade.
+
+- 982a4d7: Add Regrade path-scope exclusion globs for vocabulary runs and expose them
+  through the `trails regrade` CLI/MCP contract.
+- 1540233: Add Regrade scan inventory summaries that group matched files by extension and
+  top-level path, with occurrence counts for vocabulary regrade reports.
+- a079073: Rename Regrade path-scope scan controls from `ignore` to `exclude` across CLI, MCP, and project config.
+- Updated dependencies [ee9f3ae]
+- Updated dependencies [a0126d9]
+- Updated dependencies [4cd5d4e]
+- Updated dependencies [6a26a08]
+- Updated dependencies [38907cc]
+  - @ontrails/warden@1.0.0-beta.31
+  - @ontrails/core@1.0.0-beta.31
+
+## 1.0.0-beta.30
+
+### Patch Changes
+
+- @ontrails/core@1.0.0-beta.30
+- @ontrails/warden@1.0.0-beta.30
+
 ## 1.0.0-beta.29
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/regrade",
-  "version": "1.0.0-beta.29",
+  "version": "1.0.0-beta.32",
   "description": "Downstream migration reporting and safe rewrite helpers for Trails.",
   "files": [
     "src/**/*.ts",
@@ -22,12 +22,12 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@ontrails/core": "^1.0.0-beta.29",
-    "@ontrails/warden": "^1.0.0-beta.29",
+    "@ontrails/core": "^1.0.0-beta.32",
+    "@ontrails/warden": "^1.0.0-beta.32",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@ontrails/testing": "^1.0.0-beta.29",
-    "@ontrails/topographer": "^1.0.0-beta.29"
+    "@ontrails/testing": "^1.0.0-beta.32",
+    "@ontrails/topographer": "^1.0.0-beta.32"
   }
 }

package/src/downstream/collect.ts

@@ -1,4 +1,9 @@
-import { NotFoundError, Result, trail } from '@ontrails/core';
+import {
+  NotFoundError,
+  Result,
+  matchesAnyPathGlob,
+  trail,
+} from '@ontrails/core';
 import { readdirSync } from 'node:fs';
 import { join, posix, relative, resolve, sep } from 'node:path';
 import { z } from 'zod';
@@ -66,6 +71,8 @@ export interface DownstreamCollectionOptions {
   readonly ignoredDirectories?: readonly string[];
   /** Source extensions to collect. Defaults to {@link DEFAULT_SOURCE_EXTENSIONS}. */
   readonly extensions?: readonly string[];
+  /** Root-relative path globs to skip before collection. */
+  readonly exclude?: readonly string[];
 }
 
 /** Outcome of classifying a single directory entry. */
@@ -79,6 +86,16 @@ const extensionOf = (name: string): string => {
   return dot <= 0 ? '' : name.slice(dot);
 };
 
+const normalizeExtension = (extension: string): string =>
+  extension === '' || extension.startsWith('.') ? extension : `.${extension}`;
+
+const collectionExtensions = (
+  extensions: readonly string[] | undefined
+): readonly string[] =>
+  extensions === undefined
+    ? DEFAULT_SOURCE_EXTENSIONS
+    : extensions.map(normalizeExtension);
+
 /**
  * Decide what to do with a single directory entry. Pure: no filesystem access,
  * so collection policy can be tested directly with synthetic entries.
@@ -90,7 +107,7 @@ export const classifyDownstreamEntry = (
 ): DownstreamEntryClassification => {
   const ignoredDirectories =
     options.ignoredDirectories ?? DEFAULT_IGNORED_DIRECTORIES;
-  const extensions = options.extensions ?? DEFAULT_SOURCE_EXTENSIONS;
+  const extensions = collectionExtensions(options.extensions);
 
   if (kind === 'directory') {
     return ignoredDirectories.includes(name)
@@ -100,7 +117,7 @@ export const classifyDownstreamEntry = (
   if (kind === 'other') {
     return { action: 'skip', reason: 'unsupported-entry' };
   }
-  return extensions.includes(extensionOf(name))
+  return extensions.length === 0 || extensions.includes(extensionOf(name))
     ? { action: 'collect' }
     : { action: 'skip', reason: 'unsupported-extension' };
 };
@@ -177,6 +194,10 @@ export const collectDownstreamSources = (
     for (const entry of read.entries) {
       const absolutePath = join(current, entry.name);
       const path = toPosixRelative(absoluteRoot, absolutePath);
+      if (matchesAnyPathGlob(path, options.exclude)) {
+        skipped.push({ path, reason: 'ignored-glob' });
+        continue;
+      }
       const classification = classifyDownstreamEntry(
         entry.name,
         entry.kind,
@@ -198,6 +219,10 @@ export const collectDownstreamSources = (
 };
 
 export const collectDownstreamSourcesInput = z.object({
+  exclude: z
+    .array(z.string())
+    .optional()
+    .describe('Root-relative path globs to skip before collection'),
   extensions: z
     .array(z.string())
     .optional()
@@ -247,6 +272,7 @@ export const collectDownstreamSourcesTrail = trail(
         ...(input.extensions === undefined
           ? {}
           : { extensions: input.extensions }),
+        ...(input.exclude === undefined ? {} : { exclude: input.exclude }),
         ...(input.ignoredDirectories === undefined
           ? {}
           : { ignoredDirectories: input.ignoredDirectories }),