@xylabs/ts-scripts-common 7.5.0

package/dist/xy/xyParseOptions.mjs

@@ -0,0 +1,91 @@
+// src/xy/xyParseOptions.ts
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+
+// src/pm/detectPackageManager.ts
+import { existsSync } from "fs";
+function detectPackageManager() {
+  if (existsSync("pnpm-lock.yaml") || existsSync("pnpm-workspace.yaml")) return "pnpm";
+  return "yarn";
+}
+
+// src/pm/registry.ts
+var implementations = /* @__PURE__ */ new Map();
+function getPackageManager(name) {
+  const pmName = name ?? detectPackageManager();
+  const pm = implementations.get(pmName);
+  if (!pm) {
+    throw new Error(
+      `No package manager implementation registered for "${pmName}". Install @xylabs/ts-scripts-${pmName === "yarn" ? "yarn3" : pmName} and ensure it is imported.`
+    );
+  }
+  return pm;
+}
+
+// src/lib/tryRunLocalScript.ts
+import { spawnSync } from "child_process";
+import { readFileSync } from "fs";
+import PATH from "path";
+import chalk from "chalk";
+function tryRunLocalScript(commandName) {
+  if (process.env.XY_LOCAL_SCRIPT === "1") return void 0;
+  const rootPkgPath = PATH.resolve(process.cwd(), "package.json");
+  let rootPkg;
+  try {
+    rootPkg = JSON.parse(readFileSync(rootPkgPath, "utf8"));
+  } catch {
+    return void 0;
+  }
+  if (!rootPkg.scripts?.[commandName]) return void 0;
+  console.log(chalk.blue(`Delegating "${commandName}" to local script`));
+  const pm = getPackageManager();
+  const result = spawnSync(pm.command, ["run", commandName], {
+    cwd: process.cwd(),
+    encoding: "utf8",
+    env: {
+      FORCE_COLOR: "3",
+      ...process.env,
+      XY_LOCAL_SCRIPT: "1"
+    },
+    shell: true,
+    stdio: "inherit"
+  });
+  return result.status ?? 1;
+}
+
+// src/xy/xyParseOptions.ts
+var xyParseOptions = () => {
+  return yargs(hideBin(process.argv)).scriptName("yarn xy").middleware((argv) => {
+    const commandName = argv._[0];
+    if (commandName && argv._.length <= 1) {
+      const result = tryRunLocalScript(commandName);
+      if (result !== void 0) {
+        process.exit(result);
+      }
+    }
+  }, true).option("jobs", {
+    alias: "j",
+    default: void 0,
+    description: "Max parallel jobs",
+    type: "number"
+  }).option("verbose", {
+    alias: "v",
+    default: false,
+    description: "Run with verbose logging",
+    type: "boolean"
+  }).option("incremental", {
+    alias: "i",
+    default: false,
+    description: "Attempt to perform the action only on changed packages",
+    type: "boolean"
+  }).option("profile", {
+    alias: "p",
+    default: false,
+    description: "Profile action",
+    type: "boolean"
+  });
+};
+export {
+  xyParseOptions
+};
+//# sourceMappingURL=xyParseOptions.mjs.map

package/dist/xy/xyParseOptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/xy/xyParseOptions.ts","../../src/pm/detectPackageManager.ts","../../src/pm/registry.ts","../../src/lib/tryRunLocalScript.ts"],"sourcesContent":["import type { Argv } from 'yargs'\nimport yargs from 'yargs'\nimport { hideBin } from 'yargs/helpers'\n\nimport { tryRunLocalScript } from '../lib/index.ts'\n\nexport const xyParseOptions = (): Argv => {\n  return yargs(hideBin(process.argv))\n    .scriptName('yarn xy')\n    .middleware((argv) => {\n      const commandName = argv._[0] as string\n      if (commandName && argv._.length <= 1) {\n        const result = tryRunLocalScript(commandName)\n        if (result !== undefined) {\n          process.exit(result)\n        }\n      }\n    }, true)\n    .option('jobs', {\n      alias: 'j',\n      default: undefined,\n      description: 'Max parallel jobs',\n      type: 'number',\n    })\n    .option('verbose', {\n      alias: 'v',\n      default: false,\n      description: 'Run with verbose logging',\n      type: 'boolean',\n    })\n    .option('incremental', {\n      alias: 'i',\n      default: false,\n      description: 'Attempt to perform the action only on changed packages',\n      type: 'boolean',\n    })\n    .option('profile', {\n      alias: 'p',\n      default: false,\n      description: 'Profile action',\n      type: 'boolean',\n    })\n}\n","import { existsSync } from 'node:fs'\n\nexport type PackageManagerName = 'pnpm' | 'yarn'\n\nexport function detectPackageManager(): PackageManagerName {\n  if (existsSync('pnpm-lock.yaml') || existsSync('pnpm-workspace.yaml')) return 'pnpm'\n  return 'yarn'\n}\n","import type { PackageManagerName } from './detectPackageManager.ts'\nimport { detectPackageManager } from './detectPackageManager.ts'\nimport type { PackageManager } from './PackageManager.ts'\n\nconst implementations = new Map<PackageManagerName, PackageManager>()\n\nexport function registerPackageManager(pm: PackageManager): void {\n  implementations.set(pm.name, pm)\n}\n\nexport function getPackageManager(name?: PackageManagerName): PackageManager {\n  const pmName = name ?? detectPackageManager()\n  const pm = implementations.get(pmName)\n  if (!pm) {\n    throw new Error(\n      `No package manager implementation registered for \"${pmName}\". `\n      + `Install @xylabs/ts-scripts-${pmName === 'yarn' ? 'yarn3' : pmName} and ensure it is imported.`,\n    )\n  }\n  return pm\n}\n","import { spawnSync } from 'node:child_process'\nimport { readFileSync } from 'node:fs'\nimport PATH from 'node:path'\n\nimport chalk from 'chalk'\n\nimport { getPackageManager } from '../pm/index.ts'\n\n/**\n * Attempts to run a local root package.json script instead of the built-in\n * xy command. Returns the exit code if the override ran, or undefined if\n * no override applies (no matching script or recursion guard).\n */\nexport function tryRunLocalScript(commandName: string): number | undefined {\n  // Prevent infinite recursion if the local script calls yarn xy\n  if (process.env.XY_LOCAL_SCRIPT === '1') return undefined\n\n  // Check if root package.json has a matching script\n  const rootPkgPath = PATH.resolve(process.cwd(), 'package.json')\n  let rootPkg: { scripts?: Record<string, string> }\n  try {\n    rootPkg = JSON.parse(readFileSync(rootPkgPath, 'utf8'))\n  } catch {\n    return undefined\n  }\n\n  if (!rootPkg.scripts?.[commandName]) return undefined\n\n  console.log(chalk.blue(`Delegating \"${commandName}\" to local script`))\n  const pm = getPackageManager()\n  const result = spawnSync(pm.command, ['run', commandName], {\n    cwd: process.cwd(),\n    encoding: 'utf8',\n    env: {\n      FORCE_COLOR: '3', ...process.env, XY_LOCAL_SCRIPT: '1',\n    },\n    shell: true,\n    stdio: 'inherit',\n  })\n  return result.status ?? 1\n}\n"],"mappings":";AACA,OAAO,WAAW;AAClB,SAAS,eAAe;;;ACFxB,SAAS,kBAAkB;AAIpB,SAAS,uBAA2C;AACzD,MAAI,WAAW,gBAAgB,KAAK,WAAW,qBAAqB,EAAG,QAAO;AAC9E,SAAO;AACT;;;ACHA,IAAM,kBAAkB,oBAAI,IAAwC;AAM7D,SAAS,kBAAkB,MAA2C;AAC3E,QAAM,SAAS,QAAQ,qBAAqB;AAC5C,QAAM,KAAK,gBAAgB,IAAI,MAAM;AACrC,MAAI,CAAC,IAAI;AACP,UAAM,IAAI;AAAA,MACR,qDAAqD,MAAM,iCAC3B,WAAW,SAAS,UAAU,MAAM;AAAA,IACtE;AAAA,EACF;AACA,SAAO;AACT;;;ACpBA,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;AAC7B,OAAO,UAAU;AAEjB,OAAO,WAAW;AASX,SAAS,kBAAkB,aAAyC;AAEzE,MAAI,QAAQ,IAAI,oBAAoB,IAAK,QAAO;AAGhD,QAAM,cAAc,KAAK,QAAQ,QAAQ,IAAI,GAAG,cAAc;AAC9D,MAAI;AACJ,MAAI;AACF,cAAU,KAAK,MAAM,aAAa,aAAa,MAAM,CAAC;AAAA,EACxD,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,QAAQ,UAAU,WAAW,EAAG,QAAO;AAE5C,UAAQ,IAAI,MAAM,KAAK,eAAe,WAAW,mBAAmB,CAAC;AACrE,QAAM,KAAK,kBAAkB;AAC7B,QAAM,SAAS,UAAU,GAAG,SAAS,CAAC,OAAO,WAAW,GAAG;AAAA,IACzD,KAAK,QAAQ,IAAI;AAAA,IACjB,UAAU;AAAA,IACV,KAAK;AAAA,MACH,aAAa;AAAA,MAAK,GAAG,QAAQ;AAAA,MAAK,iBAAiB;AAAA,IACrD;AAAA,IACA,OAAO;AAAA,IACP,OAAO;AAAA,EACT,CAAC;AACD,SAAO,OAAO,UAAU;AAC1B;;;AHlCO,IAAM,iBAAiB,MAAY;AACxC,SAAO,MAAM,QAAQ,QAAQ,IAAI,CAAC,EAC/B,WAAW,SAAS,EACpB,WAAW,CAAC,SAAS;AACpB,UAAM,cAAc,KAAK,EAAE,CAAC;AAC5B,QAAI,eAAe,KAAK,EAAE,UAAU,GAAG;AACrC,YAAM,SAAS,kBAAkB,WAAW;AAC5C,UAAI,WAAW,QAAW;AACxB,gBAAQ,KAAK,MAAM;AAAA,MACrB;AAAA,IACF;AAAA,EACF,GAAG,IAAI,EACN,OAAO,QAAQ;AAAA,IACd,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC,EACA,OAAO,WAAW;AAAA,IACjB,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC,EACA,OAAO,eAAe;AAAA,IACrB,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC,EACA,OAAO,WAAW;AAAA,IACjB,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AACL;","names":[]}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@xylabs/ts-scripts-common",
+  "version": "7.5.0",
+  "description": "Shared PM-agnostic TypeScript project scripts for XY Labs",
+  "keywords": [
+    "xylabs",
+    "utility",
+    "typescript"
+  ],
+  "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"
+  },
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "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"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "package-clean": "echo Not cleaning...",
+    "package-compile": "tsup && publint",
+    "package-recompile": "tsup && publint"
+  },
+  "dependencies": {
+    "async-mutex": "~0.5.0",
+    "chalk": "~5.6.2",
+    "cosmiconfig": "~9.0.1",
+    "cosmiconfig-typescript-loader": "~6.2.0",
+    "cpy": "~13.2.1",
+    "deepmerge": "~4.3.1",
+    "dependency-cruiser": "~17.3.9",
+    "eslint": "^10.1.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.3",
+    "publint": "~0.3.18",
+    "rollup": "~4.60.0",
+    "rollup-plugin-dts": "~6.4.1",
+    "rollup-plugin-node-externals": "~8.1.2",
+    "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.5.0",
+    "@types/parse-git-config": "~3.0.4",
+    "@types/picomatch": "~4.0.2",
+    "@types/yargs": "~17.0.35",
+    "@xylabs/tsconfig": "~7.5.0",
+    "esbuild": "0.27.4",
+    "typescript": "^5.9.3"
+  },
+  "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,5 @@
+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.
+
+```bash
+yarn xy build
+```

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

@@ -0,0 +1,5 @@
+Clean build artifacts from the current project using `yarn xy clean`. This removes dist, build, and other generated directories.
+
+```bash
+yarn xy clean
+```

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

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

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

@@ -0,0 +1,5 @@
+Check for circular dependency cycles in the current project using `yarn xy cycle`. Review the output and refactor any circular dependencies found.
+
+```bash
+yarn xy cycle
+```

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

@@ -0,0 +1,5 @@
+Check for dead (unreachable) code in the current project using `yarn xy dead`. Review the output and remove any dead code found.
+
+```bash
+yarn xy dead
+```

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

@@ -0,0 +1,5 @@
+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.
+
+```bash
+yarn 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,5 @@
+Check for duplicate dependency declarations in package.json files using `yarn xy dupdeps`. Review and resolve any duplicates found.
+
+```bash
+yarn xy dupdeps
+```

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

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

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

@@ -0,0 +1,5 @@
+Generate TypeDoc API documentation using `yarn xy gen-docs`. Output is written to the docs directory.
+
+```bash
+yarn xy gen-docs
+```

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

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

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

@@ -0,0 +1,5 @@
+Lint the git configuration using `yarn xy gitlint`. Checks settings like `core.ignorecase`, `core.autocrlf`, and `core.eol`. Use `--fix` to auto-fix issues.
+
+```bash
+yarn xy gitlint
+```

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

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

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

@@ -0,0 +1,5 @@
+Check licenses of all dependencies using `yarn xy license`. Review the output for any disallowed or problematic licenses.
+
+```bash
+yarn 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,5 @@
+Lint the current project using `yarn xy lint`. This runs ESLint across all packages. Review the output for errors and fix any issues found.
+
+```bash
+yarn xy lint
+```

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

@@ -0,0 +1,5 @@
+Validate package.json files for npm publishing correctness using `yarn xy publint`. Review the output for issues and fix them.
+
+```bash
+yarn xy publint
+```

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

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

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

@@ -0,0 +1,5 @@
+Re-compile the current project using `yarn xy recompile`. This cleans compiled output and recompiles all packages from scratch.
+
+```bash
+yarn xy recompile
+```

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

@@ -0,0 +1,5 @@
+Clean and reinstall all dependencies using `yarn xy reinstall`. This removes node_modules and reinstalls from scratch.
+
+```bash
+yarn xy reinstall
+```

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

@@ -0,0 +1,5 @@
+Clean ESLint cache and re-lint the current project using `yarn xy relint`. Use this when lint results seem stale or inconsistent.
+
+```bash
+yarn xy relint
+```

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

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

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

@@ -0,0 +1,5 @@
+Run SonarQube analysis on the current project using `yarn xy sonar`. Review the output for code quality issues.
+
+```bash
+yarn xy sonar
+```

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

@@ -0,0 +1,5 @@
+Run tests for the current project using `yarn xy test`. Review the output for failures and fix any failing tests.
+
+```bash
+yarn xy test
+```

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

@@ -0,0 +1,7 @@
+Update all dependencies to their latest compatible versions using `yarn xy up`.
+
+**Important:** Confirm with the user before running this command, as it modifies package.json and yarn.lock files.
+
+```bash
+yarn 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-build.md

@@ -0,0 +1,9 @@
+# XY Labs - Build
+
+> Auto-managed by `yarn xy claude-rules`. Do not edit manually.
+
+- Run all `yarn xy` commands from the repo root, never from inside a package directory
+- Single-package: `yarn xy lint <package-name>` (use the name from package.json, not the path)
+- Run `yarn xy lint` after significant changes to verify compliance
+- Run `yarn xy build` before pushing
+- Never edit package version fields manually — use `yarn xy deploy`

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>>`