@produck/agent-toolkit 0.6.0 → 0.7.0

package/README.md

@@ -22,13 +22,12 @@ What it does (in order):
 3. Syncs root `produck:format` script and initializes `.prettierrc`
 4. Syncs root `produck:lint` script, initializes/patches `eslint.config.mjs`,
    and ensures `@produck/eslint-rules`
-5. Syncs root shared governance (`produck:baseline`,
-   `produck:coverage`, `produck:precommit-check`), initializes `.c8rc.json`,
-   and syncs shared pinned devDependencies
-   (`c8`, `husky`, `lerna`, `@produck/agent-toolkit`)
-6. Deploys the pinned `produck:coverage` script and `c8` devDependency to each workspace package, and enforces `scripts.test` (generates a default `test` script when missing).
+5. Syncs root shared governance (`produck:baseline`, `produck:coverage`, `produck:commit:check`) and syncs shared pinned devDependencies (`husky`, `lerna`, `@produck/agent-toolkit`)
+6. Deploys root `.c8rc.json` and root `c8` devDependency
    **Note:** The `produck:coverage` script in subpackages is for local and AI development use only. It is NOT enforced by organization CI or `.c8rc.json`. Only the root workspace (monorepo root) is subject to org-level coverage enforcement and `.c8rc.json`.
-7. Deploys `.husky/pre-commit` and `.husky/commit-msg`
+7. Deploys root `.gitattributes`
+8. Deploys the pinned `produck:coverage` script and `c8` devDependency to each workspace package, and enforces `scripts.test` (generates a default `test` script when missing).
+9. Deploys `.husky/pre-commit` and `.husky/commit-msg`
 
 After running, add the persistent enforcement entry to the repository
 `package.json`:
@@ -49,11 +48,12 @@ npm run produck:baseline
 - agent-toolkit preflight
 - agent-toolkit run-capture
 - agent-toolkit summarize-log
-- agent-toolkit sync-coverage-script
-- agent-toolkit sync-prettier-config
-- agent-toolkit sync-eslint-config
-- agent-toolkit sync-workspace-config
-- agent-toolkit sync-husky-hooks
+- agent-toolkit sync-coverage
+- agent-toolkit sync-git
+- agent-toolkit sync-format
+- agent-toolkit sync-install
+- agent-toolkit sync-lint
+- agent-toolkit sync-publish
 - agent-toolkit validate-commit-msg
 - agent-toolkit sync-instructions
 
@@ -71,25 +71,30 @@ Equivalent explicit form:
 npm exec -- agent-toolkit enforce-node-baseline --cwd .
 ```
 
-`enforce-node-baseline` runs seven steps in fixed order and stops at the first
+`enforce-node-baseline` runs nine steps in fixed order and stops at the first
 failure:
 
-1. `sync-instructions` — distribute organization AI instruction files into
+1. `preflight` — verify required files and directories exist
+2. `sync-instructions` — distribute organization AI instruction files into
    `.github/instructions/produck/`
-2. `preflight` — verify required files and directories exist
-3. `sync-prettier-config` — deploy organization format gate script
+3. `sync-editorconfig` — deploy organization `.editorconfig`
+4. `sync-format` — deploy organization format gate script
    (`produck:format`) and initialize `.prettierrc`
-4. `sync-eslint-config` — deploy organization lint gate script
+5. `sync-lint` — deploy organization lint gate script
    (`produck:lint`), initialize/patch `eslint.config.mjs`, and ensure
    `@produck/eslint-rules` integration
-5. `sync-workspace-config` — deploy shared root governance scripts
-   (`produck:baseline`, `produck:coverage`, `produck:precommit-check`),
-   initialize root `.c8rc.json`, and sync shared pinned root devDependencies
-   (`c8`, `husky`, `lerna`, `@produck/agent-toolkit`)
-6. `sync-coverage-script` — deploy pinned `produck:coverage` script and `c8`
-   devDependency into each workspace package, and ensure each workspace
+6. `sync-install` — deploy root `scripts.produck:install`
+   (`npm -v && npm install`) and remove legacy `scripts.deps:install`
+7. `sync-git` — deploy root `.gitattributes`, sync
+   `.husky/pre-commit`/`.husky/commit-msg`, and enforce shared root scripts
+   (`produck:baseline`, `produck:commit:check`) plus shared pinned root
+   devDependencies (`husky`, `lerna`, `@produck/agent-toolkit`)
+8. `sync-coverage` — deploy root `scripts.produck:coverage`, `.c8rc.json`, and
+   root `c8` devDependency, then deploy pinned `produck:coverage` script and
+   `c8` devDependency into each workspace package, and ensure each workspace
    package has `scripts.test` (auto-generate a default value when missing)
-7. `sync-husky-hooks` — deploy `.husky/pre-commit` and `.husky/commit-msg`
+9. `sync-publish` — create default `lerna.json` when missing and deploy root
+   `scripts.produck:publish:check` plus `scripts.produck:publish`
 
 Add to downstream repository root `package.json` for one-command enforcement:
 
@@ -142,7 +147,7 @@ npm exec -- agent-toolkit summarize-log --file logs/test.log --match "FAIL|ERROR
 Deploy organization coverage script and pinned local c8 devDependency to workspace packages:
 
 ```
-npm exec -- agent-toolkit sync-coverage-script --cwd .
+npm exec -- agent-toolkit sync-coverage --cwd .
 ```
 
 This command also enforces `scripts.test` in each workspace package.
@@ -157,15 +162,17 @@ node -e "console.log('No tests configured')"
 Deploy organization format config and script baseline to repository root:
 
 ```
-npm exec -- agent-toolkit sync-prettier-config --cwd .
+npm exec -- agent-toolkit sync-format --cwd .
 ```
 
 This command manages `scripts.produck:format` and `.prettierrc` only.
+The managed `produck:format` script always writes formatting fixes via
+Prettier, so a separate root `format` script is not required.
 
 Deploy organization lint config and script baseline to repository root:
 
 ```
-npm exec -- agent-toolkit sync-eslint-config --cwd .
+npm exec -- agent-toolkit sync-lint --cwd .
 ```
 
 This command manages `scripts.produck:lint`, `eslint.config.mjs`, and
@@ -173,25 +180,50 @@ This command manages `scripts.produck:lint`, `eslint.config.mjs`, and
 `@produck/eslint-rules`, it appends Produck integration to the exported config
 array.
 
-Deploy organization root shared scripts and shared pinned dependencies to
-repository root:
+Deploy root and workspace coverage config plus root `c8` devDependency:
 
 ```
-npm exec -- agent-toolkit sync-workspace-config --cwd .
+npm exec -- agent-toolkit sync-coverage --cwd .
 ```
 
-This command manages `scripts.produck:baseline`,
-`scripts.produck:coverage`, `scripts.produck:precommit-check`, initializes
-`.c8rc.json`, and pins `c8`, `husky`, `lerna`, and `@produck/agent-toolkit`
-in root `devDependencies`.
+This command manages root `scripts.produck:coverage`, root `.c8rc.json`, pins
+root `devDependencies.c8`, and updates workspace package `produck:coverage`,
+`test`, and `devDependencies.c8`. The generated `.c8rc.json` uses `src/**` and
+`extension/**` as the default include scope, excludes common build and
+dependency directories, and enables `check-coverage` with 99.5 thresholds for
+branches, functions, lines, and statements.
 
-Deploy organization local anti-drift husky hooks to repository root:
+Deploy root git attributes baseline:
 
 ```
-npm exec -- agent-toolkit sync-husky-hooks --cwd .
+npm exec -- agent-toolkit sync-git --cwd .
 ```
 
-This command syncs only `.husky/pre-commit` and `.husky/commit-msg`.
+This command manages root `.gitattributes`, `.husky/pre-commit`,
+`.husky/commit-msg`, `scripts.produck:baseline`,
+`scripts.produck:commit:check`, and shared pinned root devDependencies
+`husky`, `lerna`, and `@produck/agent-toolkit`.
+
+Deploy root install script baseline:
+
+```
+npm exec -- agent-toolkit sync-install --cwd .
+```
+
+This command manages `scripts.produck:install` with value
+`npm -v && npm install` and removes legacy `scripts.deps:install`.
+
+Deploy root publish script baseline:
+
+```
+npm exec -- agent-toolkit sync-publish --cwd .
+```
+
+This command manages `scripts.produck:publish:check` and
+`scripts.produck:publish`. If `lerna.json` is absent, sync mode creates a
+default file before writing the scripts. When `scripts.publish` already
+exists, `scripts.produck:publish` delegates to it after the shared checks;
+otherwise it falls back to `lerna publish`.
 
 Validate commit message format:
 
@@ -246,8 +278,8 @@ Use repository style gates first, then run package checks when needed.
 From repository root:
 
 ```bash
-npm run format:check
-npm run lint
+npm run produck:format
+npm run produck:lint
 npm --workspace @produck/agent-toolkit run test
 npm --workspace @produck/agent-toolkit run pack:check
 # optional health check
@@ -262,8 +294,7 @@ package-level release scripts.
 From monorepo root (`produck/.github`):
 
 ```bash
-npm run format:check
-npm run test
+npm run produck:publish:check
 npm run publish:dry-run
 npm run publish
 ```
@@ -289,9 +320,9 @@ Workflow behavior:
 Release policy:
 
 - Central package is installed locally in downstream repositories at a fixed
-  version managed by `agent-toolkit sync-husky-hooks`.
-- Run format:check and test first, then workspace `publish:dry-run` before
-  `publish`.
+  version managed by `agent-toolkit sync-git`.
+- Run `produck:publish:check` first.
+- Then run workspace `publish:dry-run` before `publish`.
 - Keep rollback option by republishing previous stable version if needed.
 
 Rollback quick steps:

package/bin/agent-toolkit.mjs

@@ -7,31 +7,20 @@ import {
 import { printPreflightHelp, runPreflight } from './command/preflight/index.mjs';
 import { printRunCaptureHelp, runCapture } from './command/run-capture/index.mjs';
 import { printSummarizeHelp, runSummarize } from './command/summarize-log/index.mjs';
-import {
-  printSyncCoverageScriptHelp,
-  runSyncCoverageScript,
-} from './command/sync-coverage-script/index.mjs';
-import { printSyncHuskyHooksHelp, runSyncHuskyHooks } from './command/sync-husky-hooks/index.mjs';
+import { printSyncCoverageHelp, runSyncCoverage } from './command/sync-coverage/index.mjs';
+import { printSyncInstallHelp, runSyncInstall } from './command/sync-install/index.mjs';
 import {
   printSyncInstructionsHelp,
   runSyncInstructions,
 } from './command/sync-instructions/index.mjs';
-import {
-  printSyncPrettierConfigHelp,
-  runSyncPrettierConfig,
-} from './command/sync-prettier-config/index.mjs';
+import { printSyncFormatHelp, runSyncFormat } from './command/sync-format/index.mjs';
 import {
   printSyncEditorconfigHelp,
   runSyncEditorconfig,
 } from './command/sync-editorconfig/index.mjs';
-import {
-  printSyncEslintConfigHelp,
-  runSyncEslintConfig,
-} from './command/sync-eslint-config/index.mjs';
-import {
-  printSyncWorkspaceConfigHelp,
-  runSyncWorkspaceConfig,
-} from './command/sync-workspace-config/index.mjs';
+import { printSyncLintHelp, runSyncLint } from './command/sync-lint/index.mjs';
+import { printSyncGitHelp, runSyncGit } from './command/sync-git/index.mjs';
+import { printSyncPublishHelp, runSyncPublish } from './command/sync-publish/index.mjs';
 import { hasFlag, parseCommonArgs } from './command/shared/args.mjs';
 import {
   printValidateCommitMsgHelp,
@@ -55,25 +44,21 @@ const COMMANDS = {
     printHelp: printSummarizeHelp,
     run: runSummarize,
   },
-  'sync-coverage-script': {
-    printHelp: printSyncCoverageScriptHelp,
-    run: runSyncCoverageScript,
+  'sync-coverage': {
+    printHelp: printSyncCoverageHelp,
+    run: runSyncCoverage,
   },
-  'sync-prettier-config': {
-    printHelp: printSyncPrettierConfigHelp,
-    run: runSyncPrettierConfig,
+  'sync-install': {
+    printHelp: printSyncInstallHelp,
+    run: runSyncInstall,
   },
-  'sync-eslint-config': {
-    printHelp: printSyncEslintConfigHelp,
-    run: runSyncEslintConfig,
+  'sync-format': {
+    printHelp: printSyncFormatHelp,
+    run: runSyncFormat,
   },
-  'sync-workspace-config': {
-    printHelp: printSyncWorkspaceConfigHelp,
-    run: runSyncWorkspaceConfig,
-  },
-  'sync-husky-hooks': {
-    printHelp: printSyncHuskyHooksHelp,
-    run: runSyncHuskyHooks,
+  'sync-lint': {
+    printHelp: printSyncLintHelp,
+    run: runSyncLint,
   },
   'validate-commit-msg': {
     printHelp: printValidateCommitMsgHelp,
@@ -87,6 +72,14 @@ const COMMANDS = {
     printHelp: printSyncEditorconfigHelp,
     run: runSyncEditorconfig,
   },
+  'sync-git': {
+    printHelp: printSyncGitHelp,
+    run: runSyncGit,
+  },
+  'sync-publish': {
+    printHelp: printSyncPublishHelp,
+    run: runSyncPublish,
+  },
 };
 
 const DEFAULT_COMMAND = 'enforce-node-baseline';

package/bin/build-publish-assets.mjs

@@ -10,6 +10,10 @@ const SOURCE_DIR = path.resolve(REPO_ROOT, '.github/distribution/produck');
 const OUTPUT_DIR = path.resolve(PACKAGE_ROOT, 'publish-assets/instructions/produck');
 const SOURCE_TOOLING_BASELINE_PATH = path.resolve(SOURCE_DIR, 'tooling-version-baseline.json');
 const OUTPUT_TOOLING_BASELINE_PATH = path.resolve(OUTPUT_DIR, 'tooling-version-baseline.json');
+const SOURCE_GITATTRIBUTES_PATH = path.resolve(REPO_ROOT, '.gitattributes');
+const SOURCE_GITIGNORE_PATH = path.resolve(REPO_ROOT, '.gitignore');
+const OUTPUT_GITATTRIBUTES_PATH = path.resolve(PACKAGE_ROOT, 'publish-assets/gitattributes');
+const OUTPUT_GITIGNORE_PATH = path.resolve(PACKAGE_ROOT, 'publish-assets/gitignore');
 const LEGACY_OUTPUT_PATH = path.resolve(
   PACKAGE_ROOT,
   'publish-assets/instructions/org.instructions.md',
@@ -127,6 +131,7 @@ function cleanStaleManagedFiles(expectedNames) {
 
 function run() {
   fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+  fs.mkdirSync(path.dirname(OUTPUT_GITATTRIBUTES_PATH), { recursive: true });
 
   const sourceEntries = readSourceEntries();
   const expectedNames = new Set(sourceEntries.map((entry) => entry.fileName));
@@ -143,6 +148,29 @@ function run() {
     `Generated ${OUTPUT_TOOLING_BASELINE_PATH} from ${SOURCE_TOOLING_BASELINE_PATH}\n`,
   );
 
+  if (!fs.existsSync(SOURCE_GITATTRIBUTES_PATH)) {
+    throw new Error(`Missing source .gitattributes: ${SOURCE_GITATTRIBUTES_PATH}`);
+  }
+  if (!fs.existsSync(SOURCE_GITIGNORE_PATH)) {
+    throw new Error(`Missing source .gitignore: ${SOURCE_GITIGNORE_PATH}`);
+  }
+
+  fs.writeFileSync(
+    OUTPUT_GITATTRIBUTES_PATH,
+    normalize(fs.readFileSync(SOURCE_GITATTRIBUTES_PATH, 'utf8')),
+    'utf8',
+  );
+  process.stdout.write(
+    `Generated ${OUTPUT_GITATTRIBUTES_PATH} from ${SOURCE_GITATTRIBUTES_PATH}\n`,
+  );
+
+  fs.writeFileSync(
+    OUTPUT_GITIGNORE_PATH,
+    normalize(fs.readFileSync(SOURCE_GITIGNORE_PATH, 'utf8')),
+    'utf8',
+  );
+  process.stdout.write(`Generated ${OUTPUT_GITIGNORE_PATH} from ${SOURCE_GITIGNORE_PATH}\n`);
+
   cleanStaleManagedFiles(expectedNames);
 
   if (fs.existsSync(LEGACY_OUTPUT_PATH)) {

package/bin/command/enforce-node-baseline/help.txt

@@ -5,18 +5,20 @@ Usage:
 
 Behavior:
   - Runs mandatory baseline flow in fixed order:
-    1) sync-instructions
-    2) preflight
-    3) sync-prettier-config
-    4) sync-eslint-config
-    5) sync-workspace-config
-    6) sync-coverage-script
-    7) sync-husky-hooks
+    1) preflight
+    2) sync-instructions
+    3) sync-editorconfig
+    4) sync-format
+    5) sync-lint
+    6) sync-install
+    7) sync-git
+    8) sync-coverage
+    9) sync-publish
   - Stops at first failed step and exits non-zero
   - Prints one combined JSON report for all executed steps
 
 Rules:
-  - --check runs non-mutating validation mode for step 1, step 3, step 4, step 5, step 6, and step 7
-  - --dry-run runs non-mutating preview mode for step 1, step 3, step 4, step 5, step 6, and step 7
+  - --check runs non-mutating validation mode for step 2, step 3, step 4, step 5, step 6, step 7, step 8, and step 9
+  - --dry-run runs non-mutating preview mode for step 2, step 3, step 4, step 5, step 6, step 7, step 8, and step 9
   - --check takes precedence over --dry-run
-  - --workspace filters coverage sync targets in step 6
+  - --workspace filters coverage sync targets in step 8

package/bin/command/enforce-node-baseline/index.mjs

@@ -103,7 +103,7 @@ export function runEnforceNodeBaseline(options) {
     preflightArgs.push('--check-workspace-package-json', 'package.json');
   }
 
-  const syncCoverageArgs = ['sync-coverage-script', '--cwd', cwd];
+  const syncCoverageArgs = ['sync-coverage', '--cwd', cwd];
   for (const workspacePath of workspaces) {
     syncCoverageArgs.push('--workspace', workspacePath);
   }
@@ -113,18 +113,25 @@ export function runEnforceNodeBaseline(options) {
     syncCoverageArgs.push('--dry-run');
   }
 
-  const syncHuskyArgs = ['sync-husky-hooks', '--cwd', cwd];
+  const syncPublishArgs = ['sync-publish', '--cwd', cwd];
   if (check) {
-    syncHuskyArgs.push('--check');
+    syncPublishArgs.push('--check');
   } else if (dryRun) {
-    syncHuskyArgs.push('--dry-run');
+    syncPublishArgs.push('--dry-run');
   }
 
-  const syncWorkspaceConfigArgs = ['sync-workspace-config', '--cwd', cwd];
+  const syncInstallArgs = ['sync-install', '--cwd', cwd];
   if (check) {
-    syncWorkspaceConfigArgs.push('--check');
+    syncInstallArgs.push('--check');
   } else if (dryRun) {
-    syncWorkspaceConfigArgs.push('--dry-run');
+    syncInstallArgs.push('--dry-run');
+  }
+
+  const syncGitArgs = ['sync-git', '--cwd', cwd];
+  if (check) {
+    syncGitArgs.push('--check');
+  } else if (dryRun) {
+    syncGitArgs.push('--dry-run');
   }
 
   const syncEditorconfigArgs = ['sync-editorconfig', '--cwd', cwd];
@@ -134,14 +141,14 @@ export function runEnforceNodeBaseline(options) {
     syncEditorconfigArgs.push('--dry-run');
   }
 
-  const syncPrettierConfigArgs = ['sync-prettier-config', '--cwd', cwd];
+  const syncPrettierConfigArgs = ['sync-format', '--cwd', cwd];
   if (check) {
     syncPrettierConfigArgs.push('--check');
   } else if (dryRun) {
     syncPrettierConfigArgs.push('--dry-run');
   }
 
-  const syncEslintConfigArgs = ['sync-eslint-config', '--cwd', cwd];
+  const syncEslintConfigArgs = ['sync-lint', '--cwd', cwd];
   if (check) {
     syncEslintConfigArgs.push('--check');
   } else if (dryRun) {
@@ -149,14 +156,15 @@ export function runEnforceNodeBaseline(options) {
   }
 
   const plan = [
-    { name: 'sync-instructions', args: syncInstructionsArgs },
     { name: 'preflight', args: preflightArgs },
+    { name: 'sync-instructions', args: syncInstructionsArgs },
     { name: 'sync-editorconfig', args: syncEditorconfigArgs },
-    { name: 'sync-prettier-config', args: syncPrettierConfigArgs },
-    { name: 'sync-eslint-config', args: syncEslintConfigArgs },
-    { name: 'sync-workspace-config', args: syncWorkspaceConfigArgs },
-    { name: 'sync-coverage-script', args: syncCoverageArgs },
-    { name: 'sync-husky-hooks', args: syncHuskyArgs },
+    { name: 'sync-format', args: syncPrettierConfigArgs },
+    { name: 'sync-lint', args: syncEslintConfigArgs },
+    { name: 'sync-install', args: syncInstallArgs },
+    { name: 'sync-git', args: syncGitArgs },
+    { name: 'sync-coverage', args: syncCoverageArgs },
+    { name: 'sync-publish', args: syncPublishArgs },
   ];
 
   for (const step of plan) {

package/bin/command/main/help.txt

@@ -3,12 +3,13 @@ agent-toolkit commands:
   preflight
   run-capture
   summarize-log
-  sync-coverage-script
+  sync-coverage
   sync-editorconfig
-  sync-prettier-config
-  sync-eslint-config
-  sync-workspace-config
-  sync-husky-hooks
+  sync-git
+  sync-format
+  sync-install
+  sync-lint
+  sync-publish
   validate-commit-msg
   sync-instructions
 

package/bin/command/preflight/help.txt

@@ -6,4 +6,4 @@ Usage:
 Rules for --check-workspace-package-json:
   - `private` must be true
   - `workspaces` must be a non-empty array of explicit paths (no glob tokens)
-  - `scripts` must include deps:install, test, produck:coverage, lint
+  - `scripts` must include produck:install, test, produck:coverage, produck:lint

package/bin/command/preflight/index.mjs

@@ -9,7 +9,7 @@ import { validateWorkspaceShape } from '../shared/workspace-validation.mjs';
 const COMMAND_DIR = path.dirname(fileURLToPath(import.meta.url));
 const HELP_FILE = path.resolve(COMMAND_DIR, 'help.txt');
 const REQUIRED_WORKSPACE_FIELDS = ['private', 'workspaces', 'scripts'];
-const REQUIRED_WORKSPACE_SCRIPTS = ['deps:install', 'test', 'produck:coverage', 'lint'];
+const REQUIRED_WORKSPACE_SCRIPTS = ['produck:install', 'test', 'produck:coverage', 'produck:lint'];
 
 export function printPreflightHelp() {
   printTextResource(HELP_FILE);

package/bin/command/{sync-coverage-script → sync-coverage}/help.txt

@@ -1,8 +1,9 @@
 Usage:
-  agent-toolkit sync-coverage-script [--cwd <dir>]
+  agent-toolkit sync-coverage [--cwd <dir>]
     [--workspace <path>] ... [--check] [--dry-run] [--json <file>]
 
 Behavior:
+  - Adds or updates root scripts.produck:coverage, root .c8rc.json, and root devDependencies.c8.
   - Adds or updates scripts.produck:coverage and devDependencies.c8 in each workspace package.json.
   - Enforces scripts.test in each workspace package.json.
   - If scripts.test is missing, generates: