@ontrails/regrade 1.0.0-beta.41 → 1.0.0-beta.43

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @ontrails/regrade
 
+## 1.0.0-beta.43
+
+### Minor Changes
+
+- [`4fb20a6`](https://github.com/outfitter-dev/trails/commit/4fb20a68e1ed98972d99fed8b2df96bfa6804bd3): Derive deterministic, provenance-bearing vocabulary plan proposals from a minimal `from`/`to` seed, including morphology, public and compound identifier review, filename and reference-closure candidates, namespace census, and validated live-topo API preserves. Classified governed transitions retain their registry identity while routing every governed form to review instead of inventing a single safe successor.
+- [`d3215b0`](https://github.com/outfitter-dev/trails/commit/d3215b0966f13af2a72ece9adbcc2c68c70f81b6): Add governed file renames to vocabulary Regrade plans, with move-first derived reference closure and persisted policy-aware evidence across CLI and MCP.
+- [`5a7d22a`](https://github.com/outfitter-dev/trails/commit/5a7d22ab9d674f86b28758f23c3e94a17efb5be1): Add three-tier vocabulary migration scope. Protected historical paths remain
+  scanned and counted as `historical-by-policy` without being rewritten, while
+  reports expose scope-tier totals and census-expected teaching-surface coverage
+  through equivalent CLI and MCP plan schemas. Applied vocabulary occurrences
+  remain auditable in history with an `applied` verdict, while policy-only
+  evidence does not make an active plan stale merely by being recorded.
+- [`88a6a62`](https://github.com/outfitter-dev/trails/commit/88a6a62a9e9e230ca6d368fa78dc3ece6c816204): Complete the v1 classification-first cutover from projection/project vocabulary
+  to derive/derived for contract-owned fact production and render/rendered for
+  surface presentation. Public type, helper, rule, relation, and report names move
+  without compatibility aliases; ordinary repository/project nouns remain
+  explicit preserves or structured review inventory.
+- [`9f0842e`](https://github.com/outfitter-dev/trails/commit/9f0842ee9d7c7155d86a4fd023760ac0a5636f5d): Retire the temporary root vocabulary-cutover toolchain now that Regrade owns
+  structured migration plans, safe rewrites, classification, census, CLI/MCP
+  reports, and immutable history. Remove the obsolete source exemptions so
+  Oxlint and Warden enforce the durable transition contract directly, and add a
+  history-driven Regrade audit surface for current-tree regression checks.
+- [`bd1bd96`](https://github.com/outfitter-dev/trails/commit/bd1bd96b90cd8b55f73061e4078a14cd75bed745): Require committed Regrade provenance for governed vocabulary transitions.
+
+  Applied governed plans now expose deterministic transition, plan, source,
+  safe-apply, and review-follow-up evidence through history results. Warden loads
+  committed history into project context, cites it for reintroduced symbols, and
+  rejects invalid or missing provenance for transitions that require Regrade in
+  the workspace that owns the governed registry, without making downstream apps
+  prove the framework's own migrations.
+  Portable validation accepts the authoritative numeric file-rename counters
+  persisted by Regrade history.
+
+### Patch Changes
+
+- [`53014a4`](https://github.com/outfitter-dev/trails/commit/53014a4593170edd5adfbaa2c94c895c67a320d1): Exclude immutable Regrade history artifacts from downstream migration source scans while preserving active plan and other policy-classified evidence. Warden continues to validate committed history through its dedicated provenance loader.
+- [`18a14e2`](https://github.com/outfitter-dev/trails/commit/18a14e220728be7108f3fe2864455c52305aef9f): Finish the v1 vocabulary reset cleanup by retaining the facet guard, adding a
+  durable TopoGraph artifact-family guard, teaching the live lexicon directly in
+  agent guidance, and replacing completed reset-family placeholders in public
+  Regrade examples and CLI schema help.
+
+## 1.0.0-beta.42
+
 ## 1.0.0-beta.41
 
 ## 1.0.0-beta.40

package/package.json

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

package/src/downstream/ast-rewrite.ts

@@ -233,6 +233,8 @@ export interface AstIdentifierRenameClassOptions {
   readonly from: string;
   readonly id?: string;
   readonly match?: AstIdentifierRenameMatchMode;
+  /** Route every matching identifier to review instead of producing an edit. */
+  readonly reviewAllMatches?: boolean;
   readonly reviewDeclarationTypes?: ReadonlySet<string>;
   readonly reviewExistingTargetSegments?: readonly string[];
   readonly shouldPreserve?: (
@@ -258,6 +260,7 @@ export interface AstStringLiteralRenameClassOptions {
   readonly from: string;
   readonly id?: string;
   readonly match?: 'exact' | 'property-key' | 'review';
+  readonly moduleSpecifierOnly?: boolean;
   readonly shouldPreserve?: (
     occurrence: AstIdentifierRenameOccurrence
   ) => boolean;
@@ -580,6 +583,34 @@ export const createAstIdentifierRenameClass = (
         };
       }
 
+      if (options.reviewAllMatches === true) {
+        const location = offsetToLineColumn(context.source, span.start);
+        const caution = `Identifier "${match.from}" is a derived naming candidate; routed to review.`;
+        return {
+          detail: {
+            candidateReplacement: match.to,
+            expectedTarget: `Review identifier "${match.from}" before renaming it to "${match.to}".`,
+            judgment: 'unresolved',
+            matchedForm: match.from,
+            nodeKind: node.type,
+            preserveCautions: [caution],
+            reason: 'ast-identifier-plan-review',
+            signals: ['ast:identifier-rename'],
+            span: {
+              column: location.column,
+              end: span.end,
+              line: location.line,
+              start: span.start,
+            },
+            suggestedValidation: 'bun run typecheck',
+            symbol: match.from,
+          },
+          kind: 'review',
+          note: caution,
+          reason: 'ast-identifier-plan-review',
+        };
+      }
+
       if (
         options.shouldPreserve?.({
           end: span.end,
@@ -755,6 +786,12 @@ export const createAstStringLiteralRenameClass = (
       if (match === null) {
         return null;
       }
+      if (
+        options.moduleSpecifierOnly === true &&
+        !isModuleSpecifierPosition(context)
+      ) {
+        return null;
+      }
       const { adjacentModuleRoute, value } = match;
 
       const span = stringLiteralValueSpan(node, context.source, value);

package/src/downstream/collect.ts

@@ -24,8 +24,8 @@ import { z } from 'zod';
 /** Directory names never descended into during collection. */
 export const DEFAULT_IGNORED_DIRECTORIES: readonly string[] = Object.freeze([
   '.git',
-  '.turbo',
   '.trails',
+  '.turbo',
   'dist',
   'node_modules',
 ]);
@@ -129,6 +129,10 @@ const toPosixRelative = (root: string, absolutePath: string): string => {
   return sep === posix.sep ? rel : rel.split(sep).join(posix.sep);
 };
 
+const isImmutableRegradeHistoryDirectory = (path: string): boolean =>
+  path === '.trails/regrade/history' ||
+  path.endsWith('/.trails/regrade/history');
+
 const direntKind = (dirent: {
   isDirectory(): boolean;
   isFile(): boolean;
@@ -200,6 +204,13 @@ export const collectDownstreamSources = (
         skipped.push({ path, reason: 'ignored-glob' });
         continue;
       }
+      if (
+        entry.kind === 'directory' &&
+        isImmutableRegradeHistoryDirectory(path)
+      ) {
+        skipped.push({ path, reason: 'immutable-regrade-history' });
+        continue;
+      }
       const classification = classifyDownstreamEntry(
         entry.name,
         entry.kind,

package/src/downstream/export-restructure.ts

@@ -1563,7 +1563,7 @@ export const loadWardenRegradeClasses = async (
   const restructureRules = [...wardenRules.values()];
   if (root !== undefined) {
     // Project diagnostics are already carried by the term-rewrite loader; this
-    // second pass only projects export-restructure-capable project rules.
+    // second pass only derives export-restructure-capable project rules.
     const projectRules = await loadProjectWardenRules(root);
     restructureRules.push(...projectRules.sourceRules);
   }