@produck/agent-toolkit 0.2.0 → 0.3.3

package/README.md

@@ -4,42 +4,86 @@ Central CLI toolkit for organization-level AI execution workflows.
 
 ## Commands
 
+- agent-toolkit enforce-node-baseline
 - agent-toolkit preflight
 - agent-toolkit run-capture
 - agent-toolkit summarize-log
+- agent-toolkit sync-coverage-script
+- agent-toolkit sync-husky-hooks
 - agent-toolkit validate-commit-msg
 - agent-toolkit sync-instructions
 
 ## Examples
 
+Run default mandatory baseline flow in downstream repository root:
+
+```
+npm exec -- agent-toolkit
+```
+
+Equivalent explicit form:
+
+```
+npm exec -- agent-toolkit enforce-node-baseline --cwd .
+```
+
 Run preflight checks:
 
 ```
-npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit preflight --cwd . --require package.json --ensure-dir logs
+npm exec -- agent-toolkit preflight --cwd . --require package.json --ensure-dir logs
+```
+
+Run one-shot mandatory baseline steps for downstream monorepo (1 -> 2 -> 3):
+
+```
+npm exec -- agent-toolkit enforce-node-baseline --cwd .
+```
+
+Validate monorepo root workspace package.json baseline:
+
+```
+npm exec -- agent-toolkit preflight --cwd . --check-workspace-package-json package.json
 ```
 
 Capture long output safely:
 
 ```
-npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit run-capture --cwd . --cmd "npm run test" --out logs/test.log
+npm exec -- agent-toolkit run-capture --cwd . --cmd "npm run test" --out logs/test.log
 ```
 
 Summarize captured output:
 
 ```
-npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit summarize-log --file logs/test.log --match "FAIL|ERROR"
+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 .
+```
+
+Deploy organization local anti-drift husky hooks to repository root:
+
+```
+npm exec -- agent-toolkit sync-husky-hooks --cwd .
 ```
 
+This command pins root local hook dependencies (`husky` and
+`@produck/agent-toolkit`) and syncs `.husky/pre-commit` and
+`.husky/commit-msg`.
+
 Validate commit message format:
 
 ```
-npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit validate-commit-msg --file .git/COMMIT_EDITMSG
+npm exec -- agent-toolkit validate-commit-msg --file .git/COMMIT_EDITMSG
 ```
 
 Manual per-repository instruction distribution (write .github/instructions/produck/\*.instructions.md):
 
 ```
-npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit sync-instructions --cwd .
+npm exec -- agent-toolkit sync-instructions --cwd .
 ```
 
 Legacy repository bootstrap behavior:
@@ -52,13 +96,13 @@ Legacy repository bootstrap behavior:
 Use organization source directory instead of built-in assets:
 
 ```
-npm exec --package=@produck/agent-toolkit@latest -- agent-toolkit sync-instructions --cwd . --source path/to/org/.github/distribution/produck --force --prune
+npm exec -- agent-toolkit sync-instructions --cwd . --source path/to/org/.github/distribution/produck --force --prune
 ```
 
-Built-in template location (for review and updates):
+Built-in command-local resource locations (for review and updates):
 
-- `templates/user-space-bootstrap.md`
-- `templates/help/*.txt`
+- `bin/command/*/help.txt`
+- `bin/command/sync-instructions/user-space-bootstrap.md`
 
 Publish-time generated instruction assets: