@produck/agent-toolkit 0.5.0 → 0.7.0

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

@@ -0,0 +1,157 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { getSingle, hasFlag } from '../shared/args.mjs';
+import { printTextResource } from '../shared/text-resource.mjs';
+
+const COMMAND_DIR = path.dirname(fileURLToPath(import.meta.url));
+const HELP_FILE = path.resolve(COMMAND_DIR, 'help.txt');
+const LERNA_CONFIG_FILE = 'lerna.json';
+
+const REQUIRED_PUBLISH_CHECK_SCRIPT_KEY = 'produck:publish:check';
+const REQUIRED_PUBLISH_CHECK_SCRIPT_VALUE =
+  'npm run produck:format && npm run produck:lint && npm run produck:coverage';
+const USER_PUBLISH_SCRIPT_KEY = 'publish';
+const REQUIRED_PUBLISH_SCRIPT_KEY = 'produck:publish';
+const REQUIRED_PUBLISH_SCRIPT_FALLBACK_VALUE = 'npm run produck:publish:check && lerna publish';
+
+const REQUIRED_LERNA_DEFAULT_CONFIG = `${JSON.stringify(
+  {
+    $schema: 'node_modules/lerna/schemas/lerna-schema.json',
+    version: 'independent',
+  },
+  null,
+  2,
+)}\n`;
+
+export function printSyncPublishHelp() {
+  printTextResource(HELP_FILE);
+}
+
+function parseJsonFile(filePath, label) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    console.error(`${label} is not valid JSON: ${filePath}`);
+    process.exit(2);
+  }
+}
+
+function buildRequiredPublishScriptValue(hasUserPublishScript) {
+  if (hasUserPublishScript) {
+    return 'npm run produck:publish:check && npm run publish --';
+  }
+
+  return REQUIRED_PUBLISH_SCRIPT_FALLBACK_VALUE;
+}
+
+export function runSyncPublish(options) {
+  const cwd = path.resolve(getSingle(options, '--cwd', process.cwd()));
+  const check = hasFlag(options, '--check');
+  const dryRun = hasFlag(options, '--dry-run') && !check;
+  const jsonFile = getSingle(options, '--json', '');
+  const mode = check ? 'check' : dryRun ? 'dry-run' : 'sync';
+
+  if (!fs.existsSync(cwd)) {
+    console.error(`CWD does not exist: ${cwd}`);
+    process.exit(2);
+  }
+
+  const lernaConfigPath = path.resolve(cwd, LERNA_CONFIG_FILE);
+  const lernaExistedBefore = fs.existsSync(lernaConfigPath);
+  let lernaDefaultCreated = false;
+
+  if (!lernaExistedBefore) {
+    if (mode === 'sync') {
+      fs.writeFileSync(lernaConfigPath, REQUIRED_LERNA_DEFAULT_CONFIG, 'utf8');
+      lernaDefaultCreated = true;
+    }
+  } else {
+    const lernaConfig = parseJsonFile(lernaConfigPath, 'lerna.json');
+
+    if (typeof lernaConfig.version !== 'string') {
+      console.error(`lerna.json must have a "version" field: ${lernaConfigPath}`);
+      process.exit(2);
+    }
+  }
+
+  const rootPackageJsonPath = path.resolve(cwd, 'package.json');
+  if (!fs.existsSync(rootPackageJsonPath)) {
+    console.error(`Root package.json does not exist: ${rootPackageJsonPath}`);
+    process.exit(2);
+  }
+
+  const pkg = parseJsonFile(rootPackageJsonPath, 'Root package.json');
+  const scripts =
+    pkg.scripts && typeof pkg.scripts === 'object' && !Array.isArray(pkg.scripts)
+      ? { ...pkg.scripts }
+      : {};
+  const hasUserPublishScript =
+    typeof scripts[USER_PUBLISH_SCRIPT_KEY] === 'string' &&
+    scripts[USER_PUBLISH_SCRIPT_KEY].trim() !== '';
+  const requiredPublishScriptValue = buildRequiredPublishScriptValue(hasUserPublishScript);
+
+  const previousPublishCheck =
+    typeof scripts[REQUIRED_PUBLISH_CHECK_SCRIPT_KEY] === 'string'
+      ? scripts[REQUIRED_PUBLISH_CHECK_SCRIPT_KEY]
+      : null;
+  const previousPublish =
+    typeof scripts[REQUIRED_PUBLISH_SCRIPT_KEY] === 'string'
+      ? scripts[REQUIRED_PUBLISH_SCRIPT_KEY]
+      : null;
+
+  const matchesRequiredPublishCheck = previousPublishCheck === REQUIRED_PUBLISH_CHECK_SCRIPT_VALUE;
+  const matchesRequiredPublish = previousPublish === requiredPublishScriptValue;
+  const lernaRequiresCreation = !lernaExistedBefore && !lernaDefaultCreated;
+  const requiresUpdate =
+    !matchesRequiredPublishCheck || !matchesRequiredPublish || lernaRequiresCreation;
+
+  if (mode === 'sync' && (!matchesRequiredPublishCheck || !matchesRequiredPublish)) {
+    scripts[REQUIRED_PUBLISH_CHECK_SCRIPT_KEY] = REQUIRED_PUBLISH_CHECK_SCRIPT_VALUE;
+    scripts[REQUIRED_PUBLISH_SCRIPT_KEY] = requiredPublishScriptValue;
+    pkg.scripts = scripts;
+    fs.writeFileSync(rootPackageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+  }
+
+  const report = {
+    cwd,
+    mode,
+    ok: true,
+    lernaConfigPath,
+    rootPackageJsonPath,
+    required: {
+      publishCheckScriptKey: REQUIRED_PUBLISH_CHECK_SCRIPT_KEY,
+      publishCheckScriptValue: REQUIRED_PUBLISH_CHECK_SCRIPT_VALUE,
+      publishScriptKey: REQUIRED_PUBLISH_SCRIPT_KEY,
+      publishScriptValue: requiredPublishScriptValue,
+    },
+    status: {
+      hasUserPublishScript,
+      lernaExistedBefore,
+      lernaDefaultCreated,
+      matchesRequiredPublishCheckBefore: matchesRequiredPublishCheck,
+      matchesRequiredPublishCheckAfter:
+        !matchesRequiredPublishCheck && mode === 'sync' ? true : matchesRequiredPublishCheck,
+      matchesRequiredPublishBefore: matchesRequiredPublish,
+      matchesRequiredPublishAfter:
+        !matchesRequiredPublish && mode === 'sync' ? true : matchesRequiredPublish,
+      updated: requiresUpdate && mode === 'sync',
+    },
+  };
+
+  if (mode === 'check' && requiresUpdate) {
+    report.ok = false;
+  }
+
+  if (jsonFile) {
+    const outPath = path.resolve(cwd, jsonFile);
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, `${JSON.stringify(report, null, 2)}\n`, 'utf8');
+  }
+
+  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+  if (!report.ok) {
+    process.exit(2);
+  }
+}

package/bin/command/validate-commit-msg/index.mjs

@@ -13,6 +13,7 @@ const HELP_FILE = path.resolve(COMMAND_DIR, 'help.txt');
 const ROOT_PACKAGE_FILE = path.resolve(COMMAND_DIR, '../../../../../package.json');
 const WORKSPACE_SCOPE = 'workspace';
 const WILDCARD_SCOPE = '*';
+const DEFAULT_COMMENT_CHAR = '#';
 
 export function printValidateCommitMsgHelp() {
   printTextResource(HELP_FILE);
@@ -170,6 +171,33 @@ function validateSectionFormat(lines, allowedSectionScopes = null) {
   return errors;
 }
 
+function getCommentCharFromConfig() {
+  const configured = String(process.env.GIT_COMMENT_CHAR || '').trim();
+  return configured || DEFAULT_COMMENT_CHAR;
+}
+
+function normalizeCommitMessageLines(raw, commentChar = DEFAULT_COMMENT_CHAR) {
+  const normalizedRaw = raw.replace(/\r\n/g, '\n');
+  const rawLines = normalizedRaw.split('\n');
+  const lines = [];
+
+  for (const line of rawLines) {
+    if (commentChar && line.startsWith(commentChar)) {
+      continue;
+    }
+    lines.push(line);
+  }
+
+  while (lines.length > 0 && lines[0].trim() === '') {
+    lines.shift();
+  }
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') {
+    lines.pop();
+  }
+
+  return lines;
+}
+
 export function runValidateCommitMsg(options) {
   const file = getSingle(options, '--file', '');
   if (!file) {
@@ -183,8 +211,8 @@ export function runValidateCommitMsg(options) {
     process.exit(2);
   }
 
-  const raw = fs.readFileSync(filePath, 'utf8').replace(/\r\n/g, '\n');
-  const lines = raw.endsWith('\n') ? raw.slice(0, -1).split('\n') : raw.split('\n');
+  const raw = fs.readFileSync(filePath, 'utf8');
+  const lines = normalizeCommitMessageLines(raw, getCommentCharFromConfig());
 
   if (lines.length === 0 || (lines.length === 1 && lines[0].trim() === '')) {
     console.error('Commit message is empty');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@produck/agent-toolkit",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Central CLI toolkit for organization AI execution workflows",
   "type": "module",
   "repository": {
@@ -13,9 +13,7 @@
   },
   "scripts": {
     "prepack": "node ./bin/build-publish-assets.mjs",
-    "test": "node --test test/index.mjs",
-    "verify": "node ./bin/agent-toolkit.mjs --help && node ./bin/agent-toolkit.mjs preflight --cwd . --require package.json",
-    "pack:check": "npm pack --dry-run",
+    "test": "node test/index.mjs",
     "produck:coverage": "c8 --reporter=lcov --reporter=html --reporter=text-summary npm test"
   },
   "files": [
@@ -32,5 +30,5 @@
   "devDependencies": {
     "c8": "11.0.0"
   },
-  "gitHead": "fb8c64919617ff5a76b1c736d1fe3903206ed131"
+  "gitHead": "61467ec369911fde65adc21bcf0c507c24735d90"
 }

package/publish-assets/gitattributes

@@ -0,0 +1,5 @@
+* text=auto eol=lf
+
+# Windows script entrypoints
+*.bat text eol=crlf
+*.cmd text eol=crlf

package/publish-assets/gitignore

@@ -0,0 +1,137 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Vscode
+.vscode
+
+# Specific ignored / generated.
+*.ign*
+*.gen*

package/publish-assets/instructions/produck/10-produck-node.instructions.md

@@ -19,15 +19,18 @@ applyTo: '**'
 
 Required script keys:
 
-- `deps:install`
+- `produck:install`
 - `test`
 - `produck:coverage`
-- `lint`
+- `produck:lint`
 - `publish`
 
 Notes:
 
 - Script key names are fixed and must match exactly.
+- Keep the script key name `produck:install` (organization-reserved key).
+- Required root script value for `produck:install` is:
+  `npm -v && npm install`
 - `publish` may be a no-op when repository-specific release workflow does not
   use npm publishing.
 - Coverage governance policy:
@@ -37,19 +40,18 @@ Notes:
     baseline.
   - Source of truth for tooling versions/template:
     `.github/distribution/produck/tooling-version-baseline.json`.
+  - Use central remediation command to deploy root install script baseline:
+    `npm exec -- agent-toolkit sync-install --cwd .`.
   - Use central remediation command to deploy coverage scripts:
-    `npm exec -- agent-toolkit sync-coverage-script --cwd .`.
+    `npm exec -- agent-toolkit sync-coverage --cwd .`.
   - Use central remediation command to deploy local anti-drift hook baseline:
-    `npm exec -- agent-toolkit sync-husky-hooks --cwd .`.
+    `npm exec -- agent-toolkit sync-git --cwd .`.
   - Use central remediation command to deploy root format script/config
     baseline:
-    `npm exec -- agent-toolkit sync-prettier-config --cwd .`.
+    `npm exec -- agent-toolkit sync-format --cwd .`.
   - Use central remediation command to deploy root lint script/config and
     eslint integration baseline:
-    `npm exec -- agent-toolkit sync-eslint-config --cwd .`.
-  - Use central remediation command to deploy root shared scripts/dependencies
-    baseline:
-    `npm exec -- agent-toolkit sync-workspace-config --cwd .`.
+    `npm exec -- agent-toolkit sync-lint --cwd .`.
   - `c8` execution baseline for deployed coverage scripts is fixed to the
     version specified in `tooling-version-baseline.json`.
   - Downstream repositories must not use unversioned `npx c8` or `c8@latest`
@@ -57,15 +59,15 @@ Notes:
   - Root local governance must pin `devDependencies.c8`,
     `devDependencies.husky`, `devDependencies.lerna`, and
     `devDependencies.@produck/agent-toolkit` via
-    `agent-toolkit sync-workspace-config`.
+    `agent-toolkit sync-git`.
   - Root local governance must pin `devDependencies.@produck/eslint-rules`
-    via `agent-toolkit sync-eslint-config`.
+    via `agent-toolkit sync-lint`.
 
 - Testing strategy and framework are repository-defined.
 - `verify` scripts are optional repository-local health checks and are not
   organization-required script keys.
 - `verify` is not part of organization commit gates; style gates remain
-  repository `format:check` and `lint` policy.
+  repository `produck:format` and `produck:lint` policy.
 - `test` script implementation is repository-defined and is not overwritten by
   organization coverage remediation.
 - Repositories should keep `npm run test` and `npm run produck:coverage`
@@ -73,7 +75,7 @@ Notes:
 - For intermediate commits, temporary non-executable state or failing tests are
   allowed.
 - Commit prechecks still require passing repository style gates (for example
-  `format:check` and `lint`).
+  `produck:format` and `produck:lint`).
 
 Central toolkit command role model:
 
@@ -83,19 +85,20 @@ Central toolkit command role model:
   but do not assume it can fully prevent AI hallucination or iterative drift.
 - `agent-toolkit preflight` is the hard guard for organization engineering
   baseline and is mandatory for required baseline checks.
-- `agent-toolkit sync-coverage-script` is the hard guard for monorepo coverage
+- `agent-toolkit sync-install` is the hard guard for root install script
+  governance and is mandatory in monorepo mode.
+- `agent-toolkit sync-coverage` is the hard guard for monorepo coverage
   governance and is mandatory in monorepo mode.
-- `agent-toolkit sync-husky-hooks` is the hard guard for local anti-drift hook
+- `agent-toolkit sync-git` is the hard guard for local anti-drift hook
   governance and is mandatory in monorepo mode.
-- `agent-toolkit sync-prettier-config` is the hard guard for root format
+- `agent-toolkit sync-format` is the hard guard for root format
   script/config governance and is mandatory in monorepo mode.
-- `agent-toolkit sync-eslint-config` is the hard guard for root lint
+- `agent-toolkit sync-lint` is the hard guard for root lint
   script/config and eslint integration governance and is mandatory in monorepo
   mode.
-- `agent-toolkit sync-workspace-config` is the hard guard for root shared
-  scripts/dependencies governance and is mandatory in monorepo mode.
-- For simplified downstream execution of mandatory flow (1 -> 2 -> 3 -> 4 ->
-  5 -> 6 -> 7),
+- `agent-toolkit sync-publish` is the hard guard for root publish script
+  governance when `lerna.json` is present.
+- For simplified downstream execution of mandatory flow (1 -> 2 -> ... -> 9),
   use:
   `npm exec -- agent-toolkit`.
 - Equivalent explicit form:
@@ -114,8 +117,13 @@ Central toolkit command role model:
 
 Test authoring baseline (required):
 
-- Prefer Node.js standard library test runner (`node:test`) with `describe` and
-  `it`.
+- MUST use Node.js standard library test runner (`node:test`) with `describe`
+  and `it`.
+- Execution MUST follow the **Single Entrypoint Rule**: always run tests via a
+  dedicated entrypoint (for example `test/index.mjs`) instead of targeting
+  individual files.
+- Command-line execution MUST NOT use the `--test` flag. Use
+  `node <entrypoint>` directly.
 - Each test case must be independently executable.
 - Test cases must not depend on execution order or state from other cases.
 - New test debugging should use local `only` mode for scoped regression.
@@ -125,7 +133,7 @@ Recommended local debug flow:
 
 1. Add `{ only: true }` to the target `describe/it` and all ancestor
    `describe` blocks.
-2. Run `node --test --test-only test/index.mjs`.
+2. Run `node --test-only test/index.mjs`.
 3. Remove all `only` markers.
 4. Run full regression via repository standard test command.
 
@@ -178,42 +186,46 @@ Repository layout:
 
 Script placement:
 
-- Root `package.json` must provide `deps:install`, `test`, `produck:coverage`,
-  and `lint` orchestration scripts.
-- Root `package.json` must reserve `produck:precommit-check` for organization
+- Root `package.json` must provide `produck:install`, `test`, `produck:coverage`,
+  and `produck:lint` orchestration scripts.
+- Root `package.json` must reserve `produck:commit:check` for organization
   anti-drift gate with required value:
   `npm run produck:format && npm run produck:lint`.
 - Root `package.json` must reserve `prepare` for husky setup with required
   value: `husky`.
 - Root `package.json` must reserve `produck:format` and `produck:lint` for
   organization-controlled format/lint gates.
+- Root `package.json` must reserve `produck:publish` for organization-controlled
+  publish gate when `lerna.json` is present (governed by
+  `agent-toolkit sync-publish`).
 - `publish` may be defined at root or package level based on release workflow.
 - Workspace subpackage `produck:coverage` scripts must be synchronized by
-  `agent-toolkit sync-coverage-script`.
+  `agent-toolkit sync-coverage`.
 - Root local hook governance must be synchronized by
-  `agent-toolkit sync-husky-hooks`.
+  `agent-toolkit sync-git`.
+- Root local shared script governance must initialize
+  `scripts.produck:install` with required value `npm -v && npm install`
+  via `agent-toolkit sync-install`.
 - Root local format governance must be synchronized by
-  `agent-toolkit sync-prettier-config`.
+  `agent-toolkit sync-format`.
 - Root local lint governance must be synchronized by
-  `agent-toolkit sync-eslint-config`.
-- Root local shared script/dependency governance must be synchronized by
-  `agent-toolkit sync-workspace-config`.
+  `agent-toolkit sync-lint`.
 - Root local shared script/dependency governance must pin root
   `devDependencies.c8`,
   `devDependencies.husky`, `devDependencies.lerna`,
   `devDependencies.@produck/agent-toolkit` via
-  `agent-toolkit sync-workspace-config`.
+  `agent-toolkit sync-git`.
 - Root local shared script/dependency governance must initialize
   `scripts.produck:coverage` with workspace-level execution behavior:
   attempt `test` on all workspace packages using `--workspaces --if-present`.
 - Root local shared script/dependency governance must initialize `.c8rc.json`
-  via `agent-toolkit sync-workspace-config`.
+  via `agent-toolkit sync-coverage`.
 - Root local format governance must initialize `.prettierrc` and
-  `scripts.produck:format` via `agent-toolkit sync-prettier-config`.
+  `scripts.produck:format` via `agent-toolkit sync-format`.
 - Root local lint governance must initialize `eslint.config.mjs`,
   `scripts.produck:lint`, and `devDependencies.@produck/eslint-rules`
   (including append-mode integration for existing eslint config) via
-  `agent-toolkit sync-eslint-config`.
+  `agent-toolkit sync-lint`.
 - Root `package.json` must define a `produck:baseline` script for organization
   baseline enforcement:
   ```json
@@ -240,7 +252,8 @@ Root workspace `package.json` minimal baseline (required):
 
 - `private`: `true`
 - `workspaces` (explicit package path list only)
-- `scripts` with at least: `deps:install`, `test`, `produck:coverage`, `lint`
+- `scripts` with at least: `produck:install`, `test`, `produck:coverage`,
+  `produck:lint`
 - `publish` script is optional at root when release is managed per package or
   by external workflow.
 
@@ -276,8 +289,8 @@ Repository layout:
 
 Script placement:
 
-- The repository root `package.json` must define `deps:install`, `test`,
-  `produck:coverage`, `lint`, and `publish`.
+- The repository root `package.json` must define `produck:install`, `test`,
+  `produck:coverage`, `produck:lint`, and `publish`.
 - Root `package.json` must define a `produck:baseline` script for organization
   baseline enforcement:
   ```json

package/publish-assets/instructions/produck/15-produck-workspace.instructions.md

@@ -137,20 +137,17 @@ export default [
 # Type check all packages (optional: only when root tsconfig.json is present)
 npm run type-check
 
-# Format check without writing
-npm run format:check
+# Format and write using the organization format gate
+npm run produck:format
 
-# Format and write
-npm run format
-
-# Lint (requires root eslint.config.mjs)
-npm run lint
+# Lint using the organization lint gate
+npm run produck:lint
 
 # Run all package tests
 npm run test
 
 # Check coverage across packages
-npm run coverage
+npm run produck:coverage
 ```
 
 ### Release & Coverage Tooling
@@ -168,10 +165,10 @@ npm run coverage
   policy.
 - Workspace subpackage coverage scripts are fully organization-governed.
 - Deploy/repair coverage scripts via central remediation command:
-  `npm exec -- agent-toolkit sync-coverage-script --cwd .`.
+  `npm exec -- agent-toolkit sync-coverage --cwd .`.
 - Root anti-drift local hook baseline is organization-governed.
 - Deploy/repair root local hooks via central remediation command:
-  `npm exec -- agent-toolkit sync-husky-hooks --cwd .`.
+  `npm exec -- agent-toolkit sync-git --cwd .`.
 - Deployed coverage scripts use the `c8` version specified in
   `tooling-version-baseline.json` for each governed workspace package.
 - Deployed local hook baseline uses the `husky` version specified in
@@ -181,9 +178,9 @@ npm run coverage
 - Shared scripts/CI must not use unversioned `npx c8` or `c8@latest`.
 - `test` script implementation remains repository-defined and is not overwritten
   by coverage remediation.
-- Root `devDependencies.c8` is pinned at root by `agent-toolkit sync-husky-hooks`;
+- Root `devDependencies.c8` is pinned at root by `agent-toolkit sync-git`;
   workspace package `devDependencies.c8` is pinned per package by
-  `agent-toolkit sync-coverage-script`.
+  `agent-toolkit sync-coverage`.
 - Root local hooks may be bypassed intentionally by developers (for example via
   `--no-verify`) and are treated as local strong guardrails rather than
   immutable release gates.
@@ -264,14 +261,14 @@ Root scripts are designed for CI pipelines:
 
 ```bash
 # Pre-commit checks
-npm run format:check
+npm run produck:format
+npm run produck:lint
 # Optional when root tsconfig.json is used
 npm run type-check
-npm run lint
 
 # Testing
 npm run test
-npm run coverage
+npm run produck:coverage
 ```
 
 ## Best Practices
@@ -297,7 +294,7 @@ npm install
 Root `.prettierrc` and `eslint.config.mjs` are synchronized. If conflict occurs:
 
 1. Check both configs have matching rules
-2. Run `npm run format` first, then `npm run lint`
+2. Run `npm run produck:format` first, then `npm run produck:lint`
 
 ### TypeScript includes too many files (when root tsconfig.json is used)
 

package/publish-assets/instructions/produck/20-produck-commit.instructions.md

@@ -175,8 +175,8 @@ Use the local validator before commit:
 Commit precheck gate (AI-agent required, human recommended):
 
 - For AI-agent-authored operations, complete repository style gates before both
-  `git commit` and `git commit --amend` (for example `format:check` and
-  `lint`).
+  `git commit` and `git commit --amend` (for example `produck:format` and
+  `produck:lint`).
 - For AI-agent-authored operations, `git commit --no-verify` and
   `git commit --amend --no-verify` are forbidden.
 - For human engineer-authored operations, style gates are recommended baseline