@next/codemod 16.3.0-canary.81 → 16.3.0-canary.82

package/bin/upgrade.js

@@ -47,6 +47,7 @@ const picocolors_1 = __importDefault(require("picocolors"));
 const handle_package_1 = require("../lib/handle-package");
 const transform_1 = require("./transform");
 const utils_1 = require("../lib/utils");
+const agents_md_1 = require("../lib/agents-md");
 const shared_1 = require("./shared");
 const optionalNextjsPackages = [
     'create-next-app',
@@ -380,6 +381,14 @@ async function runUpgrade(revision, options) {
     if (codemods.length > 0) {
         console.log(`${picocolors_1.default.green('✔')} Codemods have been applied successfully.`);
     }
+    try {
+        if ((0, agents_md_1.refreshAgentRulesBlock)(cwd) === 'refreshed') {
+            console.log(`${picocolors_1.default.green('✔')} Refreshed the managed agent-rules block in AGENTS.md / CLAUDE.md to match the upgraded Next.js.`);
+        }
+    }
+    catch {
+        // The block refresh is best-effort — never fail the upgrade over it.
+    }
     warnDependenciesOutOfRange(appPackageJson, versionMapping);
     endMessage(targetNextVersion);
 }

package/lib/agents-md.js

@@ -9,6 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshAgentRulesBlock = refreshAgentRulesBlock;
 exports.getNextjsVersion = getNextjsVersion;
 exports.getBundledDocsInfo = getBundledDocsInfo;
 exports.getBundledDocsLinkPath = getBundledDocsLinkPath;
@@ -22,6 +23,49 @@ const execa_1 = __importDefault(require("execa"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
+const AGENT_RULES_START_MARKER = '<!-- BEGIN:nextjs-agent-rules -->';
+/**
+ * After an upgrade, refresh the managed agent-rules block in
+ * AGENTS.md / CLAUDE.md so its content matches the Next.js version
+ * that is now installed.
+ *
+ * Delegates to the installed package's own generator
+ * (`next/dist/server/lib/generate-agent-files`), so the block text is
+ * always the one shipped with that version — this codemod never
+ * carries its own copy. Returns `'refreshed'` when a file was
+ * rewritten, `'current'` when the block was already up to date, and
+ * `'skipped'` when there is nothing to do: the project never adopted
+ * the managed block, or the installed Next.js predates the generator
+ * (< 16.3).
+ */
+function refreshAgentRulesBlock(cwd) {
+    const hostsBlock = ['AGENTS.md', 'CLAUDE.md'].some((file) => {
+        try {
+            return fs_1.default
+                .readFileSync(path_1.default.join(cwd, file), 'utf-8')
+                .includes(AGENT_RULES_START_MARKER);
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!hostsBlock)
+        return 'skipped';
+    let writeAgentFiles;
+    try {
+        const generatorPath = require.resolve('next/dist/server/lib/generate-agent-files', { paths: [cwd] });
+        writeAgentFiles = require(generatorPath).writeAgentFiles;
+        if (typeof writeAgentFiles !== 'function')
+            return 'skipped';
+    }
+    catch {
+        return 'skipped';
+    }
+    const result = writeAgentFiles(cwd);
+    return result.agentsMd === 'updated' || result.claudeMd === 'updated'
+        ? 'refreshed'
+        : 'current';
+}
 function getNextjsVersion(cwd) {
     try {
         const nextPkgPath = require.resolve('next/package.json', { paths: [cwd] });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next/codemod",
-  "version": "16.3.0-canary.81",
+  "version": "16.3.0-canary.82",
   "license": "MIT",
   "repository": {
     "type": "git",