@xylabs/toolchain 7.10.0

package/dist/xy/yarn/yarn3OnlyCommand.mjs

@@ -0,0 +1,70 @@
+// src/lib/yarn/isYarnVersionOrGreater.ts
+import { spawnSync } from "child_process";
+var isYarnVersionOrGreater = (major, minor, patch) => {
+  const result = spawnSync("yarn", ["-v"], { encoding: "utf8", shell: true });
+  const version = result.stdout.toString().replaceAll("\n", "");
+  const versionNumbers = version.split(".").map((ver) => Number.parseInt(ver));
+  const majorDelta = versionNumbers[0] - major;
+  const minorDelta = versionNumbers[1] - (minor ?? versionNumbers[1]);
+  const patchDelta = versionNumbers[2] - (patch ?? versionNumbers[2]);
+  const majorOk = majorDelta >= 0;
+  const minorOk = majorDelta > 0 || minorDelta >= 0;
+  const patchOk = majorDelta > 0 || minorDelta > 0 || patchDelta >= 0;
+  return [majorOk && minorOk && patchOk, version];
+};
+
+// src/lib/processEx.ts
+import chalk from "chalk";
+
+// src/lib/withError.ts
+var withError = (ex, closure, predicate = (ex2) => !!ex2.name && !!ex2.message) => {
+  return predicate(ex) ? closure(ex) : void 0;
+};
+
+// src/lib/withErrnoException.ts
+var withErrnoException = (ex, closure) => {
+  return withError(ex, closure, (ex2) => ex2.errno !== void 0);
+};
+
+// src/lib/processEx.ts
+var processEx = (ex) => {
+  const error = typeof ex === "string" ? new Error(ex) : ex;
+  const exitCode = withErrnoException(error, (error2) => {
+    if (error2.code === "ENOENT") {
+      console.error(chalk.red(`'${error2.path}' not found.`));
+    } else {
+      console.error(chalk.red(`Errno: ${error2.code}`));
+    }
+    return error2.errno ?? -1;
+  }) ?? withError(error, (error2) => {
+    console.error(chalk.red(`${error2.name}: ${error2.message}`));
+    return -1;
+  }) ?? (() => {
+    console.error(chalk.red(`Unexpected Error: ${JSON.stringify(ex, null, 2)}`));
+    return -1;
+  })();
+  process.exit(process.exitCode ?? exitCode);
+};
+
+// src/actions/yarn3only.ts
+var yarn3Only = () => {
+  const [valid, version] = isYarnVersionOrGreater(3);
+  if (!valid) {
+    processEx(`Invalid Yarn version [${version}]`);
+  }
+  return 0;
+};
+
+// src/xy/yarn/yarn3OnlyCommand.ts
+var yarn3OnlyCommand = {
+  command: "yarn3only",
+  describe: "Yarn3Only - Check if using Yarn v3",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Yarn 3 Check");
+    process.exitCode = yarn3Only();
+  }
+};
+export {
+  yarn3OnlyCommand
+};
+//# sourceMappingURL=yarn3OnlyCommand.mjs.map

package/dist/xy/yarn/yarn3OnlyCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/yarn/isYarnVersionOrGreater.ts","../../../src/lib/processEx.ts","../../../src/lib/withError.ts","../../../src/lib/withErrnoException.ts","../../../src/actions/yarn3only.ts","../../../src/xy/yarn/yarn3OnlyCommand.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process'\n\nexport const isYarnVersionOrGreater = (major: number, minor?: number, patch?: number): [boolean, string] => {\n  const result = spawnSync('yarn', ['-v'], { encoding: 'utf8', shell: true })\n  const version = result.stdout.toString().replaceAll('\\n', '')\n  const versionNumbers = version.split('.').map(ver => Number.parseInt(ver))\n  const majorDelta = versionNumbers[0] - major\n  const minorDelta = versionNumbers[1] - (minor ?? versionNumbers[1])\n  const patchDelta = versionNumbers[2] - (patch ?? versionNumbers[2])\n\n  const majorOk = majorDelta >= 0\n  const minorOk = majorDelta > 0 || minorDelta >= 0\n  const patchOk = majorDelta > 0 || minorDelta > 0 || patchDelta >= 0\n\n  return [majorOk && minorOk && patchOk, version]\n}\n","import chalk from 'chalk'\n\nimport { withErrnoException } from './withErrnoException.ts'\nimport { withError } from './withError.ts'\n\nexport const processEx = (ex: unknown) => {\n  const error = typeof ex === 'string' ? new Error(ex) : ex\n  const exitCode\n    = withErrnoException(error, (error) => {\n      if (error.code === 'ENOENT') {\n        console.error(chalk.red(`'${error.path}' not found.`))\n      } else {\n        console.error(chalk.red(`Errno: ${error.code}`))\n      }\n      return error.errno ?? -1\n    })\n    ?? withError(error, (error) => {\n      console.error(chalk.red(`${error.name}: ${error.message}`))\n      return -1\n    })\n    ?? (() => {\n      console.error(chalk.red(`Unexpected Error: ${JSON.stringify(ex, null, 2)}`))\n      return -1\n    })()\n  // This allows us to use a previously set exit code\n  process.exit(process.exitCode ?? exitCode)\n}\n","export const withError = <T extends Error = Error>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ex: any,\n  closure: (error: T) => number,\n  predicate = (ex: T) => (!!ex.name && !!ex.message),\n) => {\n  return predicate(ex as T) ? closure(ex as T) : undefined\n}\n","import { withError } from './withError.ts'\n\nexport const withErrnoException = <T extends NodeJS.ErrnoException = NodeJS.ErrnoException>(\n  ex: unknown, closure: (error: T) => number,\n) => {\n  return withError<T>(ex, closure, (ex: unknown) => (ex as NodeJS.ErrnoException).errno !== undefined)\n}\n","import { isYarnVersionOrGreater, processEx } from '../lib/index.ts'\n\nexport const yarn3Only = () => {\n  const [valid, version] = isYarnVersionOrGreater(3)\n  if (!valid) {\n    processEx(`Invalid Yarn version [${version}]`)\n  }\n  return 0\n}\n","import type { CommandModule } from 'yargs'\n\nimport { yarn3Only } from '../../actions/index.ts'\n\nexport const yarn3OnlyCommand: CommandModule = {\n  command: 'yarn3only',\n  describe: 'Yarn3Only - Check if using Yarn v3',\n  handler: (argv) => {\n    if (argv.verbose) console.log('Yarn 3 Check')\n    process.exitCode = yarn3Only()\n  },\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAEnB,IAAM,yBAAyB,CAAC,OAAe,OAAgB,UAAsC;AAC1G,QAAM,SAAS,UAAU,QAAQ,CAAC,IAAI,GAAG,EAAE,UAAU,QAAQ,OAAO,KAAK,CAAC;AAC1E,QAAM,UAAU,OAAO,OAAO,SAAS,EAAE,WAAW,MAAM,EAAE;AAC5D,QAAM,iBAAiB,QAAQ,MAAM,GAAG,EAAE,IAAI,SAAO,OAAO,SAAS,GAAG,CAAC;AACzE,QAAM,aAAa,eAAe,CAAC,IAAI;AACvC,QAAM,aAAa,eAAe,CAAC,KAAK,SAAS,eAAe,CAAC;AACjE,QAAM,aAAa,eAAe,CAAC,KAAK,SAAS,eAAe,CAAC;AAEjE,QAAM,UAAU,cAAc;AAC9B,QAAM,UAAU,aAAa,KAAK,cAAc;AAChD,QAAM,UAAU,aAAa,KAAK,aAAa,KAAK,cAAc;AAElE,SAAO,CAAC,WAAW,WAAW,SAAS,OAAO;AAChD;;;ACfA,OAAO,WAAW;;;ACAX,IAAM,YAAY,CAEvB,IACA,SACA,YAAY,CAACA,QAAW,CAAC,CAACA,IAAG,QAAQ,CAAC,CAACA,IAAG,YACvC;AACH,SAAO,UAAU,EAAO,IAAI,QAAQ,EAAO,IAAI;AACjD;;;ACLO,IAAM,qBAAqB,CAChC,IAAa,YACV;AACH,SAAO,UAAa,IAAI,SAAS,CAACC,QAAiBA,IAA6B,UAAU,MAAS;AACrG;;;AFDO,IAAM,YAAY,CAAC,OAAgB;AACxC,QAAM,QAAQ,OAAO,OAAO,WAAW,IAAI,MAAM,EAAE,IAAI;AACvD,QAAM,WACF,mBAAmB,OAAO,CAACC,WAAU;AACrC,QAAIA,OAAM,SAAS,UAAU;AAC3B,cAAQ,MAAM,MAAM,IAAI,IAAIA,OAAM,IAAI,cAAc,CAAC;AAAA,IACvD,OAAO;AACL,cAAQ,MAAM,MAAM,IAAI,UAAUA,OAAM,IAAI,EAAE,CAAC;AAAA,IACjD;AACA,WAAOA,OAAM,SAAS;AAAA,EACxB,CAAC,KACE,UAAU,OAAO,CAACA,WAAU;AAC7B,YAAQ,MAAM,MAAM,IAAI,GAAGA,OAAM,IAAI,KAAKA,OAAM,OAAO,EAAE,CAAC;AAC1D,WAAO;AAAA,EACT,CAAC,MACG,MAAM;AACR,YAAQ,MAAM,MAAM,IAAI,qBAAqB,KAAK,UAAU,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC;AAC3E,WAAO;AAAA,EACT,GAAG;AAEL,UAAQ,KAAK,QAAQ,YAAY,QAAQ;AAC3C;;;AGxBO,IAAM,YAAY,MAAM;AAC7B,QAAM,CAAC,OAAO,OAAO,IAAI,uBAAuB,CAAC;AACjD,MAAI,CAAC,OAAO;AACV,cAAU,yBAAyB,OAAO,GAAG;AAAA,EAC/C;AACA,SAAO;AACT;;;ACJO,IAAM,mBAAkC;AAAA,EAC7C,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,CAAC,SAAS;AACjB,QAAI,KAAK,QAAS,SAAQ,IAAI,cAAc;AAC5C,YAAQ,WAAW,UAAU;AAAA,EAC/B;AACF;","names":["ex","ex","error"]}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@xylabs/toolchain",
+  "version": "7.10.0",
+  "description": "Unified TypeScript toolchain for XY Labs — build, lint, test, deploy with auto-detected package manager and React support",
+  "keywords": [
+    "xylabs",
+    "utility",
+    "typescript",
+    "toolchain"
+  ],
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "git+https://github.com/xylabs/config/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xylabs/config.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "package-build": "dist/bin/package/build.mjs",
+    "package-build-only": "dist/bin/package/build-only.mjs",
+    "package-clean": "dist/bin/package/clean.mjs",
+    "package-compile": "dist/bin/package/compile.mjs",
+    "package-compile-only": "dist/bin/package/compile-only.mjs",
+    "package-copy-assets-cjs": "dist/bin/package/copy-assets-cjs.mjs",
+    "package-copy-assets-esm": "dist/bin/package/copy-assets-esm.mjs",
+    "package-cycle": "dist/bin/package/cycle.mjs",
+    "package-fix": "dist/bin/package/fix.mjs",
+    "package-gen-docs": "dist/bin/package/gen-docs.mjs",
+    "package-lint": "dist/bin/package/lint.mjs",
+    "package-lint-verbose": "dist/bin/package/lint-verbose.mjs",
+    "package-publint": "dist/bin/package/publint.mjs",
+    "package-recompile": "dist/bin/package/recompile.mjs",
+    "package-relint": "dist/bin/package/relint.mjs",
+    "run-or-exec": "dist/bin/run-or-exec.mjs",
+    "xy": "dist/bin/xy.mjs"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "package-clean": "echo Not cleaning...",
+    "package-compile": "tsc -p tsconfig.build.json --noEmit && tsup && publint",
+    "package-recompile": "tsc -p tsconfig.build.json --noEmit && tsup && publint"
+  },
+  "dependencies": {
+    "@inquirer/core": "~10.3.0",
+    "async-mutex": "~0.5.0",
+    "chalk": "~5.6.2",
+    "cosmiconfig": "~9.0.1",
+    "cosmiconfig-typescript-loader": "~6.3.0",
+    "cpy": "~13.2.1",
+    "deepmerge": "~4.3.1",
+    "dependency-cruiser": "~17.3.10",
+    "eslint": "^10.2.0",
+    "find-up": "~8.0.0",
+    "get-tsconfig": "~4.13.7",
+    "glob": "~13.0.6",
+    "license-checker": "~25.0.1",
+    "parse-git-config": "~3.0.0",
+    "picomatch": "~4.0.4",
+    "publint": "~0.3.18",
+    "rollup": "~4.60.1",
+    "rollup-plugin-dts": "~6.4.1",
+    "rollup-plugin-node-externals": "~8.1.2",
+    "semver": "~7.7.4",
+    "sort-package-json": "~3.6.1",
+    "tsc-prog": "~2.3.0",
+    "tsup": "~8.5.1",
+    "typedoc": "~0.28.18",
+    "types-package-json": "~2.0.39",
+    "yargs": "~18.0.0"
+  },
+  "devDependencies": {
+    "@types/eslint": "~9.6.1",
+    "@types/license-checker": "~25.0.6",
+    "@types/node": "~25.6.0",
+    "@types/parse-git-config": "~3.0.4",
+    "@types/picomatch": "~4.0.3",
+    "@types/semver": "^7.7.1",
+    "@types/yargs": "~17.0.35",
+    "@typescript-eslint/parser": "^8.58.1",
+    "@xylabs/eslint-config-flat": "~7.10.0",
+    "@xylabs/tsconfig": "~7.10.0",
+    "acorn": "^8.16.0",
+    "esbuild": "0.28.0",
+    "knip": "*",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.8",
+    "vitest": "~4.1.4"
+  },
+  "peerDependencies": {
+    "typescript": "~5"
+  },
+  "engines": {
+    "node": ">=18.17.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/claude/CLAUDE-local.md

@@ -0,0 +1,4 @@
+# CLAUDE.local.md
+
+<!-- Local overrides for AI-assisted development (gitignored, not shared with team). -->
+<!-- Use this file for personal preferences, local paths, or environment-specific instructions. -->

package/templates/claude/CLAUDE-project.md

@@ -0,0 +1,4 @@
+# CLAUDE.md
+
+<!-- Project-specific instructions for AI-assisted development. -->
+<!-- Company-wide standards are in .claude/rules/xylabs-*.md (managed by yarn xy claude-rules). -->

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

@@ -0,0 +1,7 @@
+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
+xy build
+```

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

@@ -0,0 +1,7 @@
+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
+xy clean
+```

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

@@ -0,0 +1,7 @@
+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
+xy compile
+```

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

@@ -0,0 +1,7 @@
+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
+xy cycle
+```

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

@@ -0,0 +1,7 @@
+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
+xy dead
+```

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

@@ -0,0 +1,7 @@
+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
+xy deplint
+```

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

@@ -0,0 +1,24 @@
+Reference for preferred dependencies in XY Labs projects. Consult this when adding a new dependency.
+
+| Purpose | Package |
+|---|---|
+| HTTP client | `axios` |
+| Schema validation | `zod` |
+| Logging | `@xylabs/logger` |
+| Assert/invariants | `@xylabs/assert` |
+| Async utilities | `@xylabs/promise` |
+| Lodash replacements | `@xylabs/lodash` |
+| React state | React hooks + context (avoid Redux) |
+| React UI components | `@mui/material` (Material UI) |
+| Styling | MUI `sx` prop and `styled()` — no CSS-in-JS libraries or raw CSS |
+| Testing | `vitest` |
+| Bundling | `tsup` (libraries), `webpack` (apps) |
+| Linting | `eslint` with `@xylabs/eslint-config-flat` |
+| Shared XY Labs utilities | `@xylabs/sdk-js` |
+| XYO application code | `@xyo-network/sdk-js` |
+| XYO Layer 1 Protocol | `@xyo-network/xl1-sdk` |
+| XYO Layer 1 Chain | `@xyo-network/chain-sdk` |
+
+**Notes:**
+- `zod` must be a `peerDependency`, never a direct `dependency`
+- `sideEffects: false` required on every published package

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

@@ -0,0 +1,7 @@
+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
+xy dupdeps
+```

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

@@ -0,0 +1,7 @@
+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
+xy fix
+```

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

@@ -0,0 +1,7 @@
+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
+xy gen-docs
+```

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

@@ -0,0 +1,7 @@
+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
+xy gitignore
+```

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

@@ -0,0 +1,7 @@
+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
+xy gitlint
+```

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

@@ -0,0 +1,7 @@
+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
+xy knip
+```

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

@@ -0,0 +1,7 @@
+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
+xy license
+```

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

@@ -0,0 +1,44 @@
+Reference for non-obvious ESLint rules enforced by `@xylabs/eslint-config-flat`. Consult this before writing code to avoid common violations.
+
+## Complexity limits
+- `max-statements: 32` — break large functions into smaller helpers
+- `complexity: 18` — max cyclomatic complexity per function
+- `max-lines: 512` — per file (blank lines excluded)
+- `max-depth: 6` — max nesting depth
+
+## Import style
+- `unicorn/import-style` — default imports for Node built-ins: `import PATH from 'node:path'`
+- `no-restricted-imports` — never import from barrel `index.ts` files
+
+## Object formatting
+- Objects/imports/destructuring with 3+ properties must use multi-line:
+  ```typescript
+  // wrong
+  const { created, templateNames, updated } = syncRuleFiles(rulesDir)
+
+  // correct
+  const {
+    created, templateNames, updated,
+  } = syncRuleFiles(rulesDir)
+  ```
+- Always use spaces inside braces: `{ foo }` not `{foo}`
+
+## Expressions
+- No standalone ternaries as statements — use `if/else`
+- Prefix unused variables with `_`
+
+## Enums are disallowed
+- Use string literal unions or `const` objects:
+  ```typescript
+  // wrong
+  enum Status { Active, Inactive }
+
+  // correct
+  type Status = 'active' | 'inactive'
+  ```
+
+## Class member ordering
+- Order: fields, constructor, accessors, methods (alphabetical within groups)
+
+## JSX
+- No unnecessary braces in props: `prop="value"` not `prop={"value"}`

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

@@ -0,0 +1,7 @@
+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
+xy lint
+```

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

@@ -0,0 +1,7 @@
+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
+xy publint
+```

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

@@ -0,0 +1,7 @@
+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
+xy rebuild
+```

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

@@ -0,0 +1,7 @@
+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
+xy recompile
+```

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

@@ -0,0 +1,7 @@
+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
+xy reinstall
+```

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

@@ -0,0 +1,7 @@
+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
+xy relint
+```

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

@@ -0,0 +1,7 @@
+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
+xy retest
+```

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

@@ -0,0 +1,7 @@
+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
+xy sonar
+```

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

@@ -0,0 +1,7 @@
+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
+xy test
+```

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

@@ -0,0 +1,9 @@
+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 lock files.
+
+Detect the package manager from the repo root (`yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm) and prefix accordingly.
+
+```bash
+xy up
+```

package/templates/claude/rules/xylabs-architecture.md

@@ -0,0 +1,8 @@
+# XY Labs - Architecture
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Yarn workspaces monorepo; all packages share a single version
+- Each package compiles to ESM via `tsup` (output to `dist/`)
+- Prefer composition over inheritance; depend on abstractions
+- Vitest for testing; React + MUI for frontend; Express for backend

package/templates/claude/rules/xylabs-git-workflow.md

@@ -0,0 +1,7 @@
+# XY Labs - Git
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Conventional commits: `feat:`, `fix:`, `chore:`, `refactor:`
+- Atomic commits — one logical change per commit
+- Never force-push to shared branches

package/templates/claude/rules/xylabs-naming.md

@@ -0,0 +1,7 @@
+# XY Labs - Naming
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Files: camelCase for modules, PascalCase for components/classes
+- Variables/functions: camelCase; Classes/interfaces/types: PascalCase
+- Constants: UPPER_SNAKE_CASE; Booleans: `is`/`has`/`should`/`can` prefix

package/templates/claude/rules/xylabs-style.md

@@ -0,0 +1,17 @@
+# XY Labs - Code Style
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- ESM only — no CommonJS (`require`/`module.exports`)
+- No semicolons, single quotes, trailing commas, 2-space indent
+- `const` over `let`; never `var`
+- `function` declarations for top-level; arrows only for callbacks/closures
+- Explicit return types on exported functions
+- `interface` over `type` for object shapes; named exports over default exports
+- Default imports for Node built-ins: `import PATH from 'node:path'` (not named imports)
+- No `enum` — use string literal unions or `const` objects
+- No `any` — use `unknown`; avoid `as`, prefer type guards
+- No `import * as X`; no importing from barrel `index.ts` files
+- Prefix unused variables with `_`
+- Objects/imports/destructuring with 3+ properties must use multi-line formatting
+- When a function uses `await`, return `Promise<T>` — never `Promise<Promisable<T>>`