@houserules/create 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Devin T. Currie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @houserules/create
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The initializer for [`@houserules/cli`](https://www.npmjs.com/package/@houserules/cli). It adds
+the cli to the repo's devDependencies with the package manager that invoked it and runs
+`houserules init`. It holds no logic of its own beyond that.
+
+`@houserules/cli` is the real package. Read its README for what houserules does and how to
+configure it.
+
+## Usage
+
+In the repo to set up:
+
+```sh
+npm create @houserules
+pnpm create @houserules
+yarn create @houserules
+```
+
+Everything after the name goes to `init`, so `pnpm create @houserules --yes` skips the prompts
+and `--dry-run` previews the writes. The install happens either way. After that, the binary is
+local, and every later command is `pnpm houserules <cmd>` or `npx houserules <cmd>`.
+
+## License
+
+MIT

package/bin/create-houserules.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * The initializer behind `npm create @houserules`, `pnpm create @houserules`, and
+ * `yarn create @houserules`, run inside the repo to set up. It adds `@houserules/cli` to the
+ * repo's devDependencies with the package manager that invoked it, at the cli version this
+ * package was published with, then runs `houserules init` from the repo's own copy. Every
+ * argument is handed to `init`, so `--yes` and `--dry-run` work, and the install happens
+ * either way. The exit code is the package manager's when the install fails, and init's
+ * otherwise.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+import pinnedCli from '@houserules/cli/package.json' with { type: 'json' };
+
+const CLI = '@houserules/cli';
+
+const INSTALL_ARGS = {
+  pnpm: ['add', '-D'],
+  yarn: ['add', '-D'],
+  bun: ['add', '-d'],
+  npm: ['install', '--save-dev'],
+};
+
+/** The package manager that ran `create`, else the one whose lockfile the repo has, else npm. */
+function packageManager(root) {
+  const agent = process.env.npm_config_user_agent ?? '';
+  const invoker = Object.keys(INSTALL_ARGS).find((name) =>
+    agent.startsWith(`${name}/`),
+  );
+  if (invoker) return invoker;
+  if (existsSync(join(root, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(join(root, 'yarn.lock'))) return 'yarn';
+  if (existsSync(join(root, 'bun.lock')) || existsSync(join(root, 'bun.lockb')))
+    return 'bun';
+  return 'npm';
+}
+
+function run(command, args, cwd) {
+  return spawnSync(command, args, {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+}
+
+const root = process.cwd();
+if (!existsSync(join(root, 'package.json'))) {
+  console.error(
+    `@houserules/create: no package.json in ${root}. Run \`npm init -y\` first, then run this again.`,
+  );
+  process.exit(1);
+}
+
+const manager = packageManager(root);
+const install = run(
+  manager,
+  [...INSTALL_ARGS[manager], `${CLI}@^${pinnedCli.version}`],
+  root,
+);
+if (install.status !== 0) process.exit(install.status ?? 1);
+
+const repoRequire = createRequire(join(root, 'package.json'));
+const installedManifest = repoRequire.resolve(`${CLI}/package.json`);
+const cliBin = join(
+  dirname(installedManifest),
+  repoRequire(installedManifest).bin.houserules,
+);
+const init = run(
+  process.execPath,
+  [cliBin, 'init', ...process.argv.slice(2)],
+  root,
+);
+process.exit(init.status ?? 1);

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@houserules/create",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Initializer for @houserules/cli: `npm create @houserules` adds the cli to the repo and runs init.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "create-houserules": "bin/create-houserules.mjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "wireit": {
+    "build": {
+      "command": "publint",
+      "files": [
+        "package.json",
+        "bin/**"
+      ],
+      "output": []
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DTCurrie/houserules.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://github.com/DTCurrie/houserules/tree/main/packages/create#readme",
+  "bugs": "https://github.com/DTCurrie/houserules/issues",
+  "dependencies": {
+    "@houserules/cli": "^0.9.1"
+  },
+  "devDependencies": {
+    "publint": "^0.3.25",
+    "wireit": "^0.14.13"
+  },
+  "license": "MIT",
+  "author": "Devin T. Currie (https://github.com/DTCurrie)",
+  "keywords": [
+    "houserules",
+    "claude-code",
+    "create"
+  ],
+  "scripts": {
+    "build": "wireit"
+  }
 }