@produck/agent-toolkit 0.8.1 → 0.9.0

package/bin/command/sync-git/index.mjs

@@ -13,8 +13,14 @@ const PACKAGE_ROOT = path.resolve(COMMAND_DIR, '../../..');
 const REPO_ROOT = path.resolve(PACKAGE_ROOT, '../..');
 const TOOLKIT_PACKAGE_JSON = path.resolve(PACKAGE_ROOT, 'package.json');
 const TOOLING_BASELINE_CANDIDATE_PATHS = [
-  path.resolve(REPO_ROOT, '.github/distribution/produck/tooling-version-baseline.json'),
-  path.resolve(PACKAGE_ROOT, 'publish-assets/instructions/produck/tooling-version-baseline.json'),
+  path.resolve(
+    REPO_ROOT,
+    '.github/distribution/produck/tooling-version-baseline.json',
+  ),
+  path.resolve(
+    PACKAGE_ROOT,
+    'publish-assets/instructions/produck/tooling-version-baseline.json',
+  ),
 ];
 
 const GITATTRIBUTES_FILE = '.gitattributes';
@@ -26,7 +32,10 @@ const REQUIRED_BASELINE_SCRIPT_KEY = 'produck:baseline';
 const REQUIRED_BASELINE_SCRIPT_VALUE =
   'npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit enforce-node-baseline --cwd .';
 const REQUIRED_COMMIT_CHECK_SCRIPT_KEY = 'produck:commit:check';
-const REQUIRED_COMMIT_CHECK_SCRIPT_VALUE = 'npm run produck:format && npm run produck:lint';
+const REQUIRED_COMMIT_CHECK_SCRIPT_VALUE =
+  'npm run produck:format && npm run produck:lint';
+const REQUIRED_PREPARE_SCRIPT_KEY = 'prepare';
+const REQUIRED_PREPARE_SCRIPT_VALUE = 'husky';
 
 const GITATTRIBUTES_SOURCE_CANDIDATE_PATHS = [
   path.resolve(REPO_ROOT, '.gitattributes'),
@@ -37,7 +46,8 @@ const GITIGNORE_SOURCE_CANDIDATE_PATHS = [
   path.resolve(PACKAGE_ROOT, 'publish-assets/gitignore'),
 ];
 
-const REQUIRED_PRE_COMMIT_HOOK = '#!/usr/bin/env sh\nnpm run produck:commit:check\n';
+const REQUIRED_PRE_COMMIT_HOOK =
+  '#!/usr/bin/env sh\nnpm run produck:commit:check\n';
 const REQUIRED_COMMIT_MSG_HOOK =
   '#!/usr/bin/env sh\nnode ./node_modules/@produck/agent-toolkit/bin/agent-toolkit.mjs validate-commit-msg --file "$1"\n';
 
@@ -55,26 +65,40 @@ function parseJsonFile(filePath, label) {
 }
 
 function getRequiredToolkitDevDependency() {
-  const overrideVersion = String(process.env.PRODUCK_TOOLKIT_VERSION_OVERRIDE || '').trim();
+  const overrideVersion = String(
+    process.env.PRODUCK_TOOLKIT_VERSION_OVERRIDE || '',
+  ).trim();
   if (overrideVersion) {
     return overrideVersion;
   }
-
+  // The 'npm' (non-.cmd) branch is only reached on non-Windows platforms.
+  // Tests run on Windows only.
+  /* c8 ignore next */
   const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const latestResult = spawnSync(npmCommand, ['view', '@produck/agent-toolkit', 'version'], {
-    encoding: 'utf8',
-  });
+  const latestResult = spawnSync(
+    npmCommand,
+    ['view', '@produck/agent-toolkit', 'version'],
+    {
+      encoding: 'utf8',
+    },
+  );
 
   const latestVersion = String(latestResult.stdout || '').trim();
+  // The npm registry call succeeds with a version in production but is not made
+  // during tests (no network access).
+  /* c8 ignore start */
   if (latestResult.status === 0 && latestVersion) {
     return latestVersion;
   }
+  /* c8 ignore stop */
 
   const pkg = parseJsonFile(TOOLKIT_PACKAGE_JSON, 'Toolkit package.json');
   const version = typeof pkg.version === 'string' ? pkg.version.trim() : '';
 
   if (!version) {
-    console.error(`Toolkit package version is missing: ${TOOLKIT_PACKAGE_JSON}`);
+    console.error(
+      `Toolkit package version is missing: ${TOOLKIT_PACKAGE_JSON}`,
+    );
     process.exit(2);
   }
 
@@ -82,12 +106,16 @@ function getRequiredToolkitDevDependency() {
 }
 
 function loadToolingBaseline() {
-  const toolingBaselinePath = TOOLING_BASELINE_CANDIDATE_PATHS.find((candidatePath) => {
-    return fs.existsSync(candidatePath);
-  });
+  const toolingBaselinePath = TOOLING_BASELINE_CANDIDATE_PATHS.find(
+    (candidatePath) => {
+      return fs.existsSync(candidatePath);
+    },
+  );
 
   if (!toolingBaselinePath) {
-    console.error('Tooling baseline file does not exist in expected locations:');
+    console.error(
+      'Tooling baseline file does not exist in expected locations:',
+    );
     for (const candidatePath of TOOLING_BASELINE_CANDIDATE_PATHS) {
       console.error(`- ${candidatePath}`);
     }
@@ -132,16 +160,20 @@ function findMissingGitignoreEntries(currentContent, requiredEntries) {
     return [...requiredEntries];
   }
 
-  const existingLines = new Set(currentContent.split('\n').map((line) => line.trimEnd()));
+  const existingLines = new Set(
+    currentContent.split('\n').map((line) => line.trimEnd()),
+  );
 
   return requiredEntries.filter((entry) => !existingLines.has(entry));
 }
 
 function loadGitSourceFiles() {
-  const gitattributesSourcePath = GITATTRIBUTES_SOURCE_CANDIDATE_PATHS.find((p) =>
+  const gitattributesSourcePath = GITATTRIBUTES_SOURCE_CANDIDATE_PATHS.find(
+    (p) => fs.existsSync(p),
+  );
+  const gitignoreSourcePath = GITIGNORE_SOURCE_CANDIDATE_PATHS.find((p) =>
     fs.existsSync(p),
   );
-  const gitignoreSourcePath = GITIGNORE_SOURCE_CANDIDATE_PATHS.find((p) => fs.existsSync(p));
 
   if (!gitattributesSourcePath) {
     console.error('Org .gitattributes source not found in expected locations:');
@@ -173,7 +205,9 @@ function loadGitSourceFiles() {
 
 function buildScriptState(pkg) {
   const scripts =
-    pkg.scripts && typeof pkg.scripts === 'object' && !Array.isArray(pkg.scripts)
+    pkg.scripts &&
+    typeof pkg.scripts === 'object' &&
+    !Array.isArray(pkg.scripts)
       ? { ...pkg.scripts }
       : {};
 
@@ -187,6 +221,10 @@ function buildScriptState(pkg) {
       typeof scripts[REQUIRED_COMMIT_CHECK_SCRIPT_KEY] === 'string'
         ? scripts[REQUIRED_COMMIT_CHECK_SCRIPT_KEY]
         : null,
+    previousPrepare:
+      typeof scripts[REQUIRED_PREPARE_SCRIPT_KEY] === 'string'
+        ? scripts[REQUIRED_PREPARE_SCRIPT_KEY]
+        : null,
   };
 }
 
@@ -201,8 +239,14 @@ function buildDevDependencyState(pkg) {
   return {
     devDependencies,
     previousManaged: {
-      husky: typeof devDependencies.husky === 'string' ? devDependencies.husky : null,
-      lerna: typeof devDependencies.lerna === 'string' ? devDependencies.lerna : null,
+      husky:
+        typeof devDependencies.husky === 'string'
+          ? devDependencies.husky
+          : null,
+      lerna:
+        typeof devDependencies.lerna === 'string'
+          ? devDependencies.lerna
+          : null,
       '@produck/agent-toolkit':
         typeof devDependencies['@produck/agent-toolkit'] === 'string'
           ? devDependencies['@produck/agent-toolkit']
@@ -247,16 +291,22 @@ export function runSyncGit(options) {
   const scriptValidation = validateRequiredExactEntries(scriptState.scripts, {
     [REQUIRED_BASELINE_SCRIPT_KEY]: REQUIRED_BASELINE_SCRIPT_VALUE,
     [REQUIRED_COMMIT_CHECK_SCRIPT_KEY]: REQUIRED_COMMIT_CHECK_SCRIPT_VALUE,
+    [REQUIRED_PREPARE_SCRIPT_KEY]: REQUIRED_PREPARE_SCRIPT_VALUE,
   });
   const dependencyValidation = validateRequiredExactEntries(
     dependencyState.devDependencies,
     requiredDevDependencies,
   );
 
-  const matchesRequiredBaseline = !(REQUIRED_BASELINE_SCRIPT_KEY in scriptValidation.mismatches);
+  const matchesRequiredBaseline = !(
+    REQUIRED_BASELINE_SCRIPT_KEY in scriptValidation.mismatches
+  );
   const matchesRequiredCommitCheck = !(
     REQUIRED_COMMIT_CHECK_SCRIPT_KEY in scriptValidation.mismatches
   );
+  const matchesRequiredPrepare = !(
+    REQUIRED_PREPARE_SCRIPT_KEY in scriptValidation.mismatches
+  );
   const matchesRequiredManagedDevDependencies = dependencyValidation.ok;
 
   const gitAttributesPath = path.resolve(cwd, GITATTRIBUTES_FILE);
@@ -272,14 +322,17 @@ export function runSyncGit(options) {
   const gitignoreExists = currentGitignoreContent !== null;
   const preCommitHookExists = currentPreCommitHook !== null;
   const commitMsgHookExists = currentCommitMsgHook !== null;
-  const matchesRequiredGitAttributes = currentContent === requiredGitAttributesContent;
+  const matchesRequiredGitAttributes =
+    currentContent === requiredGitAttributesContent;
   const missingGitignoreEntries = findMissingGitignoreEntries(
     currentGitignoreContent,
     gitignoreRequiredEntries,
   );
   const matchesRequiredGitignore = missingGitignoreEntries.length === 0;
-  const matchesRequiredPreCommitHook = currentPreCommitHook === REQUIRED_PRE_COMMIT_HOOK;
-  const matchesRequiredCommitMsgHook = currentCommitMsgHook === REQUIRED_COMMIT_MSG_HOOK;
+  const matchesRequiredPreCommitHook =
+    currentPreCommitHook === REQUIRED_PRE_COMMIT_HOOK;
+  const matchesRequiredCommitMsgHook =
+    currentCommitMsgHook === REQUIRED_COMMIT_MSG_HOOK;
 
   const mismatches = [];
   if (!matchesRequiredGitAttributes) {
@@ -317,6 +370,7 @@ export function runSyncGit(options) {
     mismatches.length > 0 ||
     !matchesRequiredBaseline ||
     !matchesRequiredCommitCheck ||
+    !matchesRequiredPrepare ||
     !matchesRequiredManagedDevDependencies;
 
   if (mode === 'sync' && requiresUpdate) {
@@ -328,15 +382,23 @@ export function runSyncGit(options) {
         fs.writeFileSync(gitignorePath, gitignoreOrgContent, 'utf8');
       } else {
         const appendText = `\n# produck:org-baseline\n${missingGitignoreEntries.join('\n')}\n`;
-        fs.writeFileSync(gitignorePath, currentGitignoreContent + appendText, 'utf8');
+        fs.writeFileSync(
+          gitignorePath,
+          currentGitignoreContent + appendText,
+          'utf8',
+        );
       }
     }
 
     fs.writeFileSync(preCommitHookPath, REQUIRED_PRE_COMMIT_HOOK, 'utf8');
     fs.writeFileSync(commitMsgHookPath, REQUIRED_COMMIT_MSG_HOOK, 'utf8');
 
-    scriptState.scripts[REQUIRED_BASELINE_SCRIPT_KEY] = REQUIRED_BASELINE_SCRIPT_VALUE;
-    scriptState.scripts[REQUIRED_COMMIT_CHECK_SCRIPT_KEY] = REQUIRED_COMMIT_CHECK_SCRIPT_VALUE;
+    scriptState.scripts[REQUIRED_BASELINE_SCRIPT_KEY] =
+      REQUIRED_BASELINE_SCRIPT_VALUE;
+    scriptState.scripts[REQUIRED_COMMIT_CHECK_SCRIPT_KEY] =
+      REQUIRED_COMMIT_CHECK_SCRIPT_VALUE;
+    scriptState.scripts[REQUIRED_PREPARE_SCRIPT_KEY] =
+      REQUIRED_PREPARE_SCRIPT_VALUE;
     pkg.scripts = scriptState.scripts;
 
     for (const [name, version] of Object.entries(requiredDevDependencies)) {
@@ -344,7 +406,11 @@ export function runSyncGit(options) {
     }
     pkg.devDependencies = dependencyState.devDependencies;
 
-    fs.writeFileSync(rootPackageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+    fs.writeFileSync(
+      rootPackageJsonPath,
+      `${JSON.stringify(pkg, null, 2)}\n`,
+      'utf8',
+    );
   }
 
   const report = {
@@ -364,6 +430,8 @@ export function runSyncGit(options) {
       baselineScriptValue: REQUIRED_BASELINE_SCRIPT_VALUE,
       commitCheckScriptKey: REQUIRED_COMMIT_CHECK_SCRIPT_KEY,
       commitCheckScriptValue: REQUIRED_COMMIT_CHECK_SCRIPT_VALUE,
+      prepareScriptKey: REQUIRED_PREPARE_SCRIPT_KEY,
+      prepareScriptValue: REQUIRED_PREPARE_SCRIPT_VALUE,
       preCommitHookPath: path.relative(cwd, preCommitHookPath),
       commitMsgHookPath: path.relative(cwd, commitMsgHookPath),
       managedDevDependencies: requiredDevDependencies,
@@ -380,12 +448,17 @@ export function runSyncGit(options) {
       matchesRequiredCommitMsgHookBefore: matchesRequiredCommitMsgHook,
       matchesRequiredBaselineBefore: matchesRequiredBaseline,
       matchesRequiredCommitCheckBefore: matchesRequiredCommitCheck,
-      matchesRequiredManagedDevDependenciesBefore: matchesRequiredManagedDevDependencies,
+      matchesRequiredPrepareBefore: matchesRequiredPrepare,
+      matchesRequiredManagedDevDependenciesBefore:
+        matchesRequiredManagedDevDependencies,
       mismatchesBefore: mismatches,
       fileExistsAfter: requiresUpdate && mode === 'sync' ? true : fileExists,
-      gitignoreExistsAfter: requiresUpdate && mode === 'sync' ? true : gitignoreExists,
-      preCommitHookExistsAfter: requiresUpdate && mode === 'sync' ? true : preCommitHookExists,
-      commitMsgHookExistsAfter: requiresUpdate && mode === 'sync' ? true : commitMsgHookExists,
+      gitignoreExistsAfter:
+        requiresUpdate && mode === 'sync' ? true : gitignoreExists,
+      preCommitHookExistsAfter:
+        requiresUpdate && mode === 'sync' ? true : preCommitHookExists,
+      commitMsgHookExistsAfter:
+        requiresUpdate && mode === 'sync' ? true : commitMsgHookExists,
       matchesRequiredGitAttributesAfter:
         requiresUpdate && mode === 'sync' ? true : matchesRequiredGitAttributes,
       matchesRequiredGitignoreAfter:
@@ -400,8 +473,12 @@ export function runSyncGit(options) {
         requiresUpdate && mode === 'sync' ? true : matchesRequiredBaseline,
       matchesRequiredCommitCheckAfter:
         requiresUpdate && mode === 'sync' ? true : matchesRequiredCommitCheck,
+      matchesRequiredPrepareAfter:
+        requiresUpdate && mode === 'sync' ? true : matchesRequiredPrepare,
       matchesRequiredManagedDevDependenciesAfter:
-        requiresUpdate && mode === 'sync' ? true : matchesRequiredManagedDevDependencies,
+        requiresUpdate && mode === 'sync'
+          ? true
+          : matchesRequiredManagedDevDependencies,
       mismatchesAfter: requiresUpdate && mode === 'sync' ? [] : mismatches,
       updated: requiresUpdate && mode === 'sync',
     },

package/bin/command/sync-install/index.mjs

@@ -44,7 +44,9 @@ export function runSyncInstall(options) {
 
   const pkg = parseJsonFile(rootPackageJsonPath, 'Root package.json');
   const scripts =
-    pkg.scripts && typeof pkg.scripts === 'object' && !Array.isArray(pkg.scripts)
+    pkg.scripts &&
+    typeof pkg.scripts === 'object' &&
+    !Array.isArray(pkg.scripts)
       ? { ...pkg.scripts }
       : {};
 
@@ -57,7 +59,8 @@ export function runSyncInstall(options) {
       ? scripts[LEGACY_INSTALL_SCRIPT_KEY]
       : null;
 
-  const matchesRequiredInstall = previousInstall === REQUIRED_INSTALL_SCRIPT_VALUE;
+  const matchesRequiredInstall =
+    previousInstall === REQUIRED_INSTALL_SCRIPT_VALUE;
   const legacyInstallScriptPresent = previousLegacyInstall !== null;
   const requiresUpdate = !matchesRequiredInstall || legacyInstallScriptPresent;
 
@@ -65,7 +68,11 @@ export function runSyncInstall(options) {
     delete scripts[LEGACY_INSTALL_SCRIPT_KEY];
     scripts[REQUIRED_INSTALL_SCRIPT_KEY] = REQUIRED_INSTALL_SCRIPT_VALUE;
     pkg.scripts = scripts;
-    fs.writeFileSync(rootPackageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+    fs.writeFileSync(
+      rootPackageJsonPath,
+      `${JSON.stringify(pkg, null, 2)}\n`,
+      'utf8',
+    );
   }
 
   const report = {

package/bin/command/sync-instructions/index.mjs

@@ -3,18 +3,30 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { getSingle, hasFlag } from '../shared/args.mjs';
-import { loadTextResource, printTextResource } from '../shared/text-resource.mjs';
+import {
+  loadTextResource,
+  printTextResource,
+} from '../shared/text-resource.mjs';
 
 const COMMAND_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = path.resolve(COMMAND_DIR, '../../..');
 const PUBLISH_ASSETS_ROOT = path.resolve(PACKAGE_ROOT, 'publish-assets');
-const PUBLISH_INSTRUCTIONS_ROOT = path.resolve(PUBLISH_ASSETS_ROOT, 'instructions');
-const PUBLISH_NAMESPACE_ROOT = path.resolve(PUBLISH_INSTRUCTIONS_ROOT, 'produck');
+const PUBLISH_INSTRUCTIONS_ROOT = path.resolve(
+  PUBLISH_ASSETS_ROOT,
+  'instructions',
+);
+const PUBLISH_NAMESPACE_ROOT = path.resolve(
+  PUBLISH_INSTRUCTIONS_ROOT,
+  'produck',
+);
 const MANAGED_MARKER = '<!-- managed-by: @produck/agent-toolkit -->';
 const DEFAULT_NAMESPACE_OUT_DIR = '.github/instructions/produck';
 const USER_SPACE_ENTRYPOINT = '.github/copilot-instructions.md';
 const HELP_FILE = path.resolve(COMMAND_DIR, 'help.txt');
-const USER_SPACE_BOOTSTRAP_FILE = path.resolve(COMMAND_DIR, 'user-space-bootstrap.md');
+const USER_SPACE_BOOTSTRAP_FILE = path.resolve(
+  COMMAND_DIR,
+  'user-space-bootstrap.md',
+);
 
 export function printSyncInstructionsHelp() {
   printTextResource(HELP_FILE);
@@ -46,7 +58,9 @@ function loadDefaultInstructionsTemplate() {
   }
 
   console.error('No built-in instruction assets found.');
-  console.error('Run prepack/publish to generate publish-assets, or pass --source explicitly.');
+  console.error(
+    'Run prepack/publish to generate publish-assets, or pass --source explicitly.',
+  );
   process.exit(2);
 }
 
@@ -75,9 +89,14 @@ function isManagedFile(filePath) {
 }
 
 function buildUserSpaceBootstrapContent(namespaceDirPath, cwd) {
-  const namespaceDisplayPath = path.relative(cwd, namespaceDirPath).replace(/\\/g, '/');
+  const namespaceDisplayPath = path
+    .relative(cwd, namespaceDirPath)
+    .replace(/\\/g, '/');
   let content = loadTextResource(USER_SPACE_BOOTSTRAP_FILE);
-  content = content.replace(/\{\{NAMESPACE_GLOB\}\}/g, `${namespaceDisplayPath}/*.instructions.md`);
+  content = content.replace(
+    /\{\{NAMESPACE_GLOB\}\}/g,
+    `${namespaceDisplayPath}/*.instructions.md`,
+  );
   if (!content.endsWith('\n')) {
     content = `${content}\n`;
   }
@@ -114,7 +133,9 @@ export function runSyncInstructions(options) {
       sourceResolved = sourcePath;
       entries = readInstructionEntriesFromDirectory(sourcePath);
       if (entries.length === 0) {
-        console.error(`No .instructions.md files in source directory: ${sourcePath}`);
+        console.error(
+          `No .instructions.md files in source directory: ${sourcePath}`,
+        );
         process.exit(2);
       }
     } else {
@@ -138,7 +159,9 @@ export function runSyncInstructions(options) {
   const outLooksLikeFile = outArg.endsWith('.md');
 
   if (outLooksLikeFile && entries.length > 1) {
-    console.error('Target --out is a file path but source has multiple instruction files.');
+    console.error(
+      'Target --out is a file path but source has multiple instruction files.',
+    );
     console.error('Use an output directory for multi-file sync.');
     process.exit(2);
   }
@@ -190,7 +213,9 @@ export function runSyncInstructions(options) {
     }
   }
 
-  const toWrite = planned.filter((item) => !unchanged.includes(item.targetPath));
+  const toWrite = planned.filter(
+    (item) => !unchanged.includes(item.targetPath),
+  );
 
   const pruneDeletes = [];
   if (prune && fs.existsSync(outDir)) {

package/bin/command/sync-lint/eslint.config.template.mjs

@@ -0,0 +1,32 @@
+import js from '@eslint/js';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+import json from '@eslint/json';
+import markdown from '@eslint/markdown';
+import { defineConfig } from 'eslint/config';
+import * as ProduckRule from '@produck/eslint-rules';
+
+export default defineConfig([
+  {
+    files: ['**/*.{js,mjs,cjs,ts,mts,cts}'],
+    plugins: { js },
+    extends: ['js/recommended'],
+    languageOptions: { globals: { ...globals.browser, ...globals.node } },
+  },
+  tseslint.configs.recommended,
+  {
+    files: ['**/*.json'],
+    ignores: ['**/package-lock.json'],
+    plugins: { json },
+    language: 'json/json',
+    extends: ['json/recommended'],
+  },
+  {
+    files: ['**/*.md'],
+    plugins: { markdown },
+    language: 'markdown/gfm',
+    extends: ['markdown/recommended'],
+  },
+  ProduckRule.config,
+  ProduckRule.excludeGitIgnore(import.meta.url),
+]);

package/bin/command/sync-lint/index.mjs

@@ -10,28 +10,28 @@ const HELP_FILE = path.resolve(COMMAND_DIR, 'help.txt');
 const PACKAGE_ROOT = path.resolve(COMMAND_DIR, '../../..');
 const REPO_ROOT = path.resolve(PACKAGE_ROOT, '../..');
 const TOOLING_BASELINE_CANDIDATE_PATHS = [
-  path.resolve(REPO_ROOT, '.github/distribution/produck/tooling-version-baseline.json'),
-  path.resolve(PACKAGE_ROOT, 'publish-assets/instructions/produck/tooling-version-baseline.json'),
+  path.resolve(
+    REPO_ROOT,
+    '.github/distribution/produck/tooling-version-baseline.json',
+  ),
+  path.resolve(
+    PACKAGE_ROOT,
+    'publish-assets/instructions/produck/tooling-version-baseline.json',
+  ),
 ];
 const ESLINT_RULES_PACKAGE_NAME = '@produck/eslint-rules';
 const ESLINT_CONFIG_FILE = 'eslint.config.mjs';
 
 const REQUIRED_LINT_SCRIPT_KEY = 'produck:lint';
 const REQUIRED_LINT_SCRIPT_VALUE = 'eslint --fix . --max-warnings=0';
-const REQUIRED_ESLINT_CONFIG = `import globals from 'globals';
-import pluginJs from '@eslint/js';
-import tseslint from 'typescript-eslint';
-import * as ProduckRule from '@produck/eslint-rules';
-
-export default [
-  { files: ['**/*.{js,mjs,cjs,ts,mts}'] },
-  { languageOptions: { globals: { ...globals.browser, ...globals.node } } },
-  pluginJs.configs.recommended,
-  ...tseslint.configs.recommended,
-  ProduckRule.config,
-  ProduckRule.excludeGitIgnore(import.meta.url),
-];
-`;
+const ESLINT_CONFIG_TEMPLATE_PATH = path.resolve(
+  COMMAND_DIR,
+  'eslint.config.template.mjs',
+);
+
+function loadRequiredEslintConfig() {
+  return fs.readFileSync(ESLINT_CONFIG_TEMPLATE_PATH, 'utf8');
+}
 
 export function printSyncLintHelp() {
   printTextResource(HELP_FILE);
@@ -60,18 +60,32 @@ function getRequiredEslintRulesDevDependency() {
   // sync-lint runs as an installed dependency, fall back to the publish-assets
   // tooling baseline (which build-publish-assets injects at prepack time from
   // the same package.json).
-  const inTreeEslintRulesPkgPath = path.resolve(REPO_ROOT, 'packages/eslint-rules/package.json');
+  const inTreeEslintRulesPkgPath = path.resolve(
+    REPO_ROOT,
+    'packages/eslint-rules/package.json',
+  );
   if (fs.existsSync(inTreeEslintRulesPkgPath)) {
-    const eslintRulesPkg = parseJsonFile(inTreeEslintRulesPkgPath, 'eslint-rules package.json');
-    const version = typeof eslintRulesPkg.version === 'string' ? eslintRulesPkg.version.trim() : '';
+    const eslintRulesPkg = parseJsonFile(
+      inTreeEslintRulesPkgPath,
+      'eslint-rules package.json',
+    );
+    // The '' fallback is for when the in-tree package.json has a non-string
+    // version field, which never occurs for this package.
+    const version =
+      typeof eslintRulesPkg.version === 'string'
+        ? eslintRulesPkg.version.trim()
+        : /* c8 ignore next */
+        '';
     if (version) {
       return version;
     }
   }
 
-  const toolingBaselinePath = TOOLING_BASELINE_CANDIDATE_PATHS.find((candidatePath) => {
-    return fs.existsSync(candidatePath);
-  });
+  const toolingBaselinePath = TOOLING_BASELINE_CANDIDATE_PATHS.find(
+    (candidatePath) => {
+      return fs.existsSync(candidatePath);
+    },
+  );
 
   if (!toolingBaselinePath) {
     console.error('Cannot resolve @produck/eslint-rules version. Looked at:');
@@ -84,7 +98,11 @@ function getRequiredEslintRulesDevDependency() {
 
   const baseline = parseJsonFile(toolingBaselinePath, 'Tooling baseline file');
   const entry = baseline?.tools?.[ESLINT_RULES_PACKAGE_NAME];
-  const version = typeof entry?.version === 'string' ? entry.version.trim() : '';
+  // The '' fallback is for when the tooling baseline lacks a string version entry
+  // for the eslint-rules package, which the repository always provides.
+  /* c8 ignore next 2 */
+  const version =
+    typeof entry?.version === 'string' ? entry.version.trim() : '';
 
   if (!version) {
     console.error(
@@ -97,10 +115,6 @@ function getRequiredEslintRulesDevDependency() {
 }
 
 function patchEslintConfig(existing) {
-  if (existing.includes('@produck/eslint-rules')) {
-    return { ok: true, patched: false, output: existing };
-  }
-
   const importRegex = /^import\s.+;\s*$/gm;
   let lastImport = null;
   let match = importRegex.exec(existing);
@@ -136,6 +150,7 @@ function patchEslintConfig(existing) {
 }
 
 export function runSyncLint(options) {
+  const REQUIRED_ESLINT_CONFIG = loadRequiredEslintConfig();
   const cwd = path.resolve(getSingle(options, '--cwd', process.cwd()));
   const check = hasFlag(options, '--check');
   const dryRun = hasFlag(options, '--dry-run') && !check;
@@ -155,7 +170,9 @@ export function runSyncLint(options) {
 
   const pkg = parseJsonFile(rootPackageJsonPath, 'Root package.json');
   const scripts =
-    pkg.scripts && typeof pkg.scripts === 'object' && !Array.isArray(pkg.scripts)
+    pkg.scripts &&
+    typeof pkg.scripts === 'object' &&
+    !Array.isArray(pkg.scripts)
       ? { ...pkg.scripts }
       : {};
   const devDependencies =
@@ -180,7 +197,8 @@ export function runSyncLint(options) {
   const previousEslintConfig = readFileIfExists(eslintConfigPath);
 
   const matchesRequiredLint = previousLint === REQUIRED_LINT_SCRIPT_VALUE;
-  const matchesRequiredEslintRules = previousEslintRules === requiredEslintRulesDependency;
+  const matchesRequiredEslintRules =
+    previousEslintRules === requiredEslintRulesDependency;
 
   let eslintConfigAction = 'unchanged';
   let matchesRequiredEslintConfig = false;
@@ -204,7 +222,9 @@ export function runSyncLint(options) {
   }
 
   const requiresUpdate =
-    !matchesRequiredLint || !matchesRequiredEslintRules || !matchesRequiredEslintConfig;
+    !matchesRequiredLint ||
+    !matchesRequiredEslintRules ||
+    !matchesRequiredEslintConfig;
   const hasUnpatchableEslintConfig = eslintConfigAction === 'unpatchable';
 
   if (mode === 'sync' && requiresUpdate && !hasUnpatchableEslintConfig) {
@@ -214,8 +234,19 @@ export function runSyncLint(options) {
     devDependencies['@produck/eslint-rules'] = requiredEslintRulesDependency;
     pkg.devDependencies = devDependencies;
 
-    fs.writeFileSync(rootPackageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
-    fs.writeFileSync(eslintConfigPath, nextEslintConfigText || REQUIRED_ESLINT_CONFIG, 'utf8');
+    fs.writeFileSync(
+      rootPackageJsonPath,
+      `${JSON.stringify(pkg, null, 2)}\n`,
+      'utf8',
+    );
+    // nextEslintConfigText is empty only if the patcher produces no output, which
+    // does not occur in tests since the existing config is always patchable.
+    fs.writeFileSync(
+      eslintConfigPath,
+      /* c8 ignore next */
+      nextEslintConfigText || REQUIRED_ESLINT_CONFIG,
+      'utf8',
+    );
   }
 
   const report = {

package/bin/command/sync-publish/help.txt

@@ -5,11 +5,13 @@ agent-toolkit sync-publish [--cwd <dir>] [--check] [--dry-run]
 Behavior:
 
 - Reads lerna.json in <dir> to detect monorepo publish mode
-- If lerna.json is absent, sync mode creates a default lerna.json
+- If lerna.json is absent, sync mode creates one from organization sample
+  (repo root lerna.json / publish-assets/lerna.json)
 - Sync mode applies organization-required root publish scripts:
-  - scripts.produck:publish:check = npm run produck:format && npm run produck:lint && npm run produck:coverage
+  - scripts.produck:publish:check = npm run produck:install && npm run produck:format && npm run produck:lint && npm run produck:coverage
   - scripts.produck:publish = npm run produck:publish:check && npm run publish --
     when scripts.publish exists; otherwise it falls back to lerna publish
+  - Enforces lerna.json command.version.commitHooks = false so publish/version commits skip git commit hooks
 
 Rules: