@xylabs/ts-scripts-yarn3 7.5.6 → 7.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/ts-scripts-yarn3",
-  "version": "7.5.6",
+  "version": "7.5.7",
   "description": "TypeScript project scripts",
   "keywords": [
     "xylabs",
@@ -50,14 +50,15 @@
   },
   "devDependencies": {
     "@types/yargs": "~17.0.35",
-    "@xylabs/tsconfig": "~7.5.6",
+    "@xylabs/ts-scripts-common": "~7.5.7",
+    "@xylabs/tsconfig": "~7.5.7",
     "publint": "~0.3.18",
     "tsup": "~8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.1"
   },
   "peerDependencies": {
-    "@xylabs/ts-scripts-common": "~7.5.6",
+    "@xylabs/ts-scripts-common": "~7.5.7",
     "typescript": "~5"
   },
   "engines": {

package/templates/claude/commands/xy-build.md

@@ -1,5 +1,7 @@
-Run a full build of the current project using `yarn xy build`. This compiles TypeScript, runs publint, deplint, and lint. Review the output for errors and fix any issues found.
+Run a full build of the current project using `xy build`. This compiles TypeScript, runs publint, deplint, and lint. Review the output for errors and fix any issues found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy build
+xy build
 ```

package/templates/claude/commands/xy-clean.md

@@ -1,5 +1,7 @@
-Clean build artifacts from the current project using `yarn xy clean`. This removes dist, build, and other generated directories.
+Clean build artifacts from the current project using `xy clean`. This removes dist, build, and other generated directories.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy clean
+xy clean
 ```

package/templates/claude/commands/xy-compile.md

@@ -1,5 +1,7 @@
-Compile the current project using `yarn xy compile`. This runs TypeScript compilation via tsup and publint validation. Review the output for errors and fix any issues found.
+Compile the current project using `xy compile`. This runs TypeScript compilation via tsup and publint validation. Review the output for errors and fix any issues found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy compile
+xy compile
 ```

package/templates/claude/commands/xy-cycle.md

@@ -1,5 +1,7 @@
-Check for circular dependency cycles in the current project using `yarn xy cycle`. Review the output and refactor any circular dependencies found.
+Check for circular dependency cycles in the current project using `xy cycle`. Review the output and refactor any circular dependencies found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy cycle
+xy cycle
 ```

package/templates/claude/commands/xy-dead.md

@@ -1,5 +1,7 @@
-Check for dead (unreachable) code in the current project using `yarn xy dead`. Review the output and remove any dead code found.
+Check for dead (unreachable) code in the current project using `xy dead`. Review the output and remove any dead code found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy dead
+xy dead
 ```

package/templates/claude/commands/xy-deplint.md

@@ -1,5 +1,7 @@
-Check dependency declarations in the current project using `yarn xy deplint`. This verifies that all imports have corresponding entries in package.json dependencies. Review the output for missing or extraneous dependencies and fix them.
+Check dependency declarations in the current project using `xy deplint`. This verifies that all imports have corresponding entries in package.json dependencies. Review the output for missing or extraneous dependencies and fix them.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy deplint
+xy deplint
 ```

package/templates/claude/commands/xy-dupdeps.md

@@ -1,5 +1,7 @@
-Check for duplicate dependency declarations in package.json files using `yarn xy dupdeps`. Review and resolve any duplicates found.
+Check for duplicate dependency declarations in package.json files using `xy dupdeps`. Review and resolve any duplicates found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy dupdeps
+xy dupdeps
 ```

package/templates/claude/commands/xy-fix.md

@@ -1,5 +1,7 @@
-Auto-fix lint issues in the current project using `yarn xy fix`. This runs ESLint with the --fix flag. Review the output for any remaining issues that could not be auto-fixed and fix them manually.
+Auto-fix lint issues in the current project using `xy fix`. This runs ESLint with the --fix flag. Review the output for any remaining issues that could not be auto-fixed and fix them manually.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy fix
+xy fix
 ```

package/templates/claude/commands/xy-gen-docs.md

@@ -1,5 +1,7 @@
-Generate TypeDoc API documentation using `yarn xy gen-docs`. Output is written to the docs directory.
+Generate TypeDoc API documentation using `xy gen-docs`. Output is written to the docs directory.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy gen-docs
+xy gen-docs
 ```

package/templates/claude/commands/xy-gitignore.md

@@ -1,5 +1,7 @@
-Generate the root .gitignore from the standard template and remove any .gitignore files from workspace packages using `yarn xy gitignore`. Custom entries are preserved under a `# Custom` section.
+Generate the root .gitignore from the standard template and remove any .gitignore files from workspace packages using `xy gitignore`. Custom entries are preserved under a `# Custom` section.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy gitignore
+xy gitignore
 ```

package/templates/claude/commands/xy-gitlint.md

@@ -1,5 +1,7 @@
-Lint the git configuration using `yarn xy gitlint`. Checks settings like `core.ignorecase`, `core.autocrlf`, and `core.eol`. Use `--fix` to auto-fix issues.
+Lint the git configuration using `xy gitlint`. Checks settings like `core.ignorecase`, `core.autocrlf`, and `core.eol`. Use `--fix` to auto-fix issues.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy gitlint
+xy gitlint
 ```

package/templates/claude/commands/xy-knip.md

@@ -1,5 +1,7 @@
-Check for unused exports and dead code in the current project using `yarn xy knip`. Review the output and remove any unused exports, files, or dependencies.
+Check for unused exports and dead code in the current project using `xy knip`. Review the output and remove any unused exports, files, or dependencies.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy knip
+xy knip
 ```

package/templates/claude/commands/xy-license.md

@@ -1,5 +1,7 @@
-Check licenses of all dependencies using `yarn xy license`. Review the output for any disallowed or problematic licenses.
+Check licenses of all dependencies using `xy license`. Review the output for any disallowed or problematic licenses.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy license
+xy license
 ```

package/templates/claude/commands/xy-lint.md

@@ -1,5 +1,7 @@
-Lint the current project using `yarn xy lint`. This runs ESLint across all packages. Review the output for errors and fix any issues found.
+Lint the current project using `xy lint`. This runs ESLint across all packages. Review the output for errors and fix any issues found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy lint
+xy lint
 ```

package/templates/claude/commands/xy-publint.md

@@ -1,5 +1,7 @@
-Validate package.json files for npm publishing correctness using `yarn xy publint`. Review the output for issues and fix them.
+Validate package.json files for npm publishing correctness using `xy publint`. Review the output for issues and fix them.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy publint
+xy publint
 ```

package/templates/claude/commands/xy-rebuild.md

@@ -1,5 +1,7 @@
-Rebuild the current project from scratch using `yarn xy rebuild`. This cleans build artifacts, then compiles and lints. Review the output for errors and fix any issues found.
+Rebuild the current project from scratch using `xy rebuild`. This cleans build artifacts, then compiles and lints. Review the output for errors and fix any issues found.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy rebuild
+xy rebuild
 ```

package/templates/claude/commands/xy-recompile.md

@@ -1,5 +1,7 @@
-Re-compile the current project using `yarn xy recompile`. This cleans compiled output and recompiles all packages from scratch.
+Re-compile the current project using `xy recompile`. This cleans compiled output and recompiles all packages from scratch.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy recompile
+xy recompile
 ```

package/templates/claude/commands/xy-reinstall.md

@@ -1,5 +1,7 @@
-Clean and reinstall all dependencies using `yarn xy reinstall`. This removes node_modules and reinstalls from scratch.
+Clean and reinstall all dependencies using `xy reinstall`. This removes node_modules and reinstalls from scratch.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy reinstall
+xy reinstall
 ```

package/templates/claude/commands/xy-relint.md

@@ -1,5 +1,7 @@
-Clean ESLint cache and re-lint the current project using `yarn xy relint`. Use this when lint results seem stale or inconsistent.
+Clean ESLint cache and re-lint the current project using `xy relint`. Use this when lint results seem stale or inconsistent.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy relint
+xy relint
 ```

package/templates/claude/commands/xy-retest.md

@@ -1,5 +1,7 @@
-Re-run tests with a cleaned cache using `yarn xy retest`. Use this when test results seem stale or cached state may be causing issues.
+Re-run tests with a cleaned cache using `xy retest`. Use this when test results seem stale or cached state may be causing issues.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy retest
+xy retest
 ```

package/templates/claude/commands/xy-sonar.md

@@ -1,5 +1,7 @@
-Run SonarQube analysis on the current project using `yarn xy sonar`. Review the output for code quality issues.
+Run SonarQube analysis on the current project using `xy sonar`. Review the output for code quality issues.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy sonar
+xy sonar
 ```

package/templates/claude/commands/xy-test.md

@@ -1,5 +1,7 @@
-Run tests for the current project using `yarn xy test`. Review the output for failures and fix any failing tests.
+Run tests for the current project using `xy test`. Review the output for failures and fix any failing tests.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy test
+xy test
 ```

package/templates/claude/commands/xy-up.md

@@ -1,7 +1,9 @@
-Update all dependencies to their latest compatible versions using `yarn xy up`.
+Update all dependencies to their latest compatible versions using `xy up`.
 
-**Important:** Confirm with the user before running this command, as it modifies package.json and yarn.lock files.
+**Important:** Confirm with the user before running this command, as it modifies package.json and lock files.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
 
 ```bash
-yarn xy up
+xy up
 ```

package/templates/claude/skills/xylabs-xy-cli/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: xylabs-xy-cli
+description: >
+  Comprehensive reference for the `xy` CLI provided by `@xylabs/ts-scripts-yarn3`.
+  Use this skill whenever the user asks how to build, lint, test, deploy, or run any
+  tooling command in an XY Labs monorepo — even if they just say something like
+  "how do I compile" or "check my deps". Covers every command, common workflows,
+  single-package targeting, and troubleshooting.
+---
+# xylabs-xy-cli
+
+The `xy` CLI is the unified build toolchain for all XY Labs and XYO Network TypeScript
+monorepos. It wraps compilation, linting, testing, dependency analysis, deployment, and
+repo maintenance into a single tool.
+
+**Always run `xy` commands from the repo root**, never from inside a package directory.
+
+---
+
+## Package Manager Detection
+
+Before running any command, detect the repo's package manager by checking the repo root:
+- `yarn.lock` present → use **yarn** (e.g. `yarn xy build`)
+- `pnpm-lock.yaml` present → use **pnpm** (e.g. `pnpm xy build`)
+
+All commands below are shown without a prefix. Prepend the detected package manager
+when executing (e.g. `xy build` → `yarn xy build` or `pnpm xy build`).
+
+---
+
+## Installation
+
+The CLI is provided by `@xylabs/ts-scripts-yarn3` (or `@xylabs/ts-scripts-react-yarn3`
+for React repos). It is already a devDependency in every XY Labs repo — no separate
+install is needed.
+
+---
+
+## Command Reference
+
+### Build & Compile
+
+| Command | Description |
+|---|---|
+| `xy build` | Full build: compile + publint + deplint + lint |
+| `xy compile` | Compile all packages (TypeScript via tsup) + publint |
+| `xy recompile` | Clean compiled output, then compile again |
+| `xy rebuild` | Clean everything, then full build |
+| `xy copy-assets` | Copy non-TS assets from `src/` to `dist/` |
+
+### Lint & Fix
+
+| Command | Description |
+|---|---|
+| `xy lint` | Run ESLint across all packages |
+| `xy fix` | Run ESLint with `--fix` to auto-fix issues |
+| `xy relint` | Clean ESLint cache, then lint from scratch |
+| `xy deplint` | Verify imports match `package.json` dependency declarations |
+| `xy publint` | Validate `package.json` correctness for npm publishing |
+| `xy cycle` | Detect circular dependency cycles |
+| `xy knip` | Find unused exports and dead code |
+| `xy dead` | Check for dead (unreachable) code |
+| `xy sonar` | Run SonarQube analysis |
+| `xy dupdeps` | Find duplicate dependency declarations across packages |
+| `xy lintlint` | Check for redundant or overridden ESLint rules |
+
+### Testing
+
+| Command | Description |
+|---|---|
+| `xy test` | Run Vitest tests |
+| `xy retest` | Clean test cache, then run tests |
+
+### Deploy & Publish
+
+| Command | Description |
+|---|---|
+| `xy deploy` | Patch version bump + build + publish |
+| `xy deploy-minor` | Minor version bump + build + publish |
+| `xy deploy-major` | Major version bump + build + publish |
+| `xy deploy-next` | Deploy as `next` tag (pre-release) |
+
+### Dependency Management
+
+| Command | Description |
+|---|---|
+| `xy clean` | Remove `dist/` and `build/` artifacts |
+| `xy reinstall` | Remove `node_modules`, reinstall from scratch |
+| `xy up` | Update all dependencies to latest compatible versions |
+
+### Git & Repo Maintenance
+
+| Command | Description |
+|---|---|
+| `xy gitlint` | Lint git configuration (ignorecase, autocrlf, etc.) |
+| `xy gitignore` | Generate root `.gitignore` and remove package-level ones |
+| `xy license` | Check dependency licenses for compliance |
+| `xy gen-docs` | Generate TypeDoc API documentation |
+
+### Claude Code Integration
+
+| Command | Description |
+|---|---|
+| `xy claude init` | Initialize all Claude configuration (commands, rules, skills, settings) |
+| `xy claude clean` | Remove all Claude configuration files |
+| `xy claude commands` | Sync slash commands to `.claude/commands/` |
+| `xy claude rules` | Sync rules to `.claude/rules/` |
+| `xy claude skills` | Sync skills to `.claude/skills/` |
+| `xy claude settings` | Initialize `.claude/settings.local.json` |
+
+---
+
+## Targeting a Single Package
+
+Most commands accept an optional `[package]` argument to scope to one package:
+
+```bash
+xy compile my-package
+xy lint my-package
+xy deplint my-package
+```
+
+Use the **package name** from `package.json` (e.g. `@xylabs/assert`), not the directory
+path. You can also use just the short name without the scope (e.g. `assert`).
+
+---
+
+## Common Workflows
+
+### Before pushing code
+```bash
+xy build
+```
+This runs the full pipeline: compile, publint, deplint, and lint. If it passes, the code
+is ready to push.
+
+### After modifying dependencies
+```bash
+xy deplint
+```
+Catches missing or extraneous entries in `package.json` relative to actual imports.
+
+### When lint results seem stale
+```bash
+xy relint
+```
+Clears the ESLint cache and re-lints everything.
+
+### When tests seem stale
+```bash
+xy retest
+```
+Clears the Vitest cache and re-runs tests.
+
+### When things are broken and you want a clean slate
+```bash
+xy rebuild
+```
+Cleans all artifacts, recompiles, and re-lints.
+
+### Nuclear option — full reset
+```bash
+xy reinstall
+```
+Removes `node_modules` and reinstalls everything from scratch.
+
+---
+
+## Troubleshooting
+
+### "Command not found: xy"
+The `xy` binary comes from `@xylabs/ts-scripts-yarn3`. Run `install` via your package
+manager to ensure it is linked. The binary is at `node_modules/.bin/xy`.
+
+### Compile errors in other packages
+`ts-scripts-yarn3` must compile before other packages that depend on it. The repo's
+`compile` script handles this ordering automatically — always use `xy compile`
+from the root, not `tsc` directly.
+
+### Deplint false positives
+Deplint scans TypeScript source imports and `tsconfig.json` extends chains. If a
+dependency is used only in config files (not source), it may flag as unused. Check the
+output carefully before removing.
+
+### Version conflicts
+All packages in a repo share a single version. Never edit version fields manually —
+use `xy deploy` variants to bump versions.

package/templates/readme/README.body.md

@@ -1,11 +1,5 @@
 ## Install
 
 ```sh
-npm install {{name}}
-```
-
-or
-
-```sh
-yarn add {{name}}
+{{pm}} add {{name}}
 ```