@hypercli/kit 0.1.1

package/dist/source-resolver.js

@@ -0,0 +1,187 @@
+/**
+ * Kit Source Resolution
+ *
+ * Resolves kit sources from various formats (npm, GitHub, local paths, etc.)
+ * into a standardized format that package managers can understand.
+ */
+/**
+ * Resolve a kit source string into a typed, normalized format.
+ *
+ * Resolution order:
+ * 1. Explicit prefixes (file:, github:, jsr:, npm:, git+, etc.)
+ * 2. JSR-specific patterns (@jsr/)
+ * 3. Git URLs (by protocol or .git extension)
+ * 4. HTTP(S) URLs
+ * 5. Windows paths (drive letters, UNC paths, backslashes)
+ * 6. Unix paths (/, ./, ../, ~/)
+ * 7. GitHub/GitLab/Bitbucket shorthand (user/repo)
+ * 8. NPM packages (default)
+ *
+ * @param input - The kit source string from user input
+ * @returns Resolved kit source with type and normalized source
+ *
+ * @example
+ * ```typescript
+ * resolveKitSource('@kit/nextjs')
+ * // → { type: 'npm', source: '@kit/nextjs', registry: 'npm' }
+ *
+ * resolveKitSource('svallory/hypergen-kit-nextjs')
+ * // → { type: 'github', source: 'github:svallory/hypergen-kit-nextjs' }
+ *
+ * resolveKitSource('./my-local-kit')
+ * // → { type: 'local', source: './my-local-kit' }
+ *
+ * resolveKitSource('C:\\Projects\\my-kit')
+ * // → { type: 'local', source: 'C:\\Projects\\my-kit' }
+ * ```
+ */
+export function resolveKitSource(input) {
+    const trimmed = input.trim();
+    // 1. Explicit prefix (highest priority)
+    if (trimmed.startsWith("file:")) {
+        return { type: "local", source: trimmed, original: input };
+    }
+    if (trimmed.startsWith("github:")) {
+        return { type: "github", source: trimmed, original: input };
+    }
+    if (trimmed.startsWith("gitlab:")) {
+        return { type: "gitlab", source: trimmed, original: input };
+    }
+    if (trimmed.startsWith("bitbucket:")) {
+        return { type: "bitbucket", source: trimmed, original: input };
+    }
+    if (trimmed.startsWith("git+")) {
+        return { type: "git", source: trimmed, original: input };
+    }
+    if (trimmed.startsWith("jsr:")) {
+        return { type: "jsr", source: trimmed, original: input, registry: "jsr" };
+    }
+    if (trimmed.startsWith("npm:")) {
+        return {
+            type: "npm",
+            source: trimmed.slice(4),
+            original: input,
+            registry: "npm",
+        };
+    }
+    // 2. JSR-specific patterns
+    if (trimmed.startsWith("@jsr/")) {
+        return { type: "jsr", source: trimmed, original: input, registry: "jsr" };
+    }
+    // 3. Git URLs (by protocol or .git extension)
+    if (trimmed.startsWith("git://") || trimmed.startsWith("ssh://git@")) {
+        return { type: "git", source: trimmed, original: input };
+    }
+    // 4. HTTP(S) URLs
+    if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+        // Check if it's a .git URL
+        if (trimmed.endsWith(".git")) {
+            return { type: "git", source: trimmed, original: input };
+        }
+        // Otherwise treat as tarball URL
+        return { type: "url", source: trimmed, original: input };
+    }
+    // 5. Windows paths (must check before Unix paths to avoid C: being treated as package)
+    // Windows drive letter: C:\ or C:/
+    if (/^[a-zA-Z]:[/\\]/.test(trimmed)) {
+        return { type: "local", source: trimmed, original: input };
+    }
+    // Windows UNC path: \\server\share
+    if (trimmed.startsWith("\\\\")) {
+        return { type: "local", source: trimmed, original: input };
+    }
+    // Windows relative paths: .\ or ..\
+    if (trimmed.startsWith(".\\") || trimmed.startsWith("..\\")) {
+        return { type: "local", source: trimmed, original: input };
+    }
+    // 6. Unix paths
+    if (trimmed.startsWith("/") || // Absolute
+        trimmed.startsWith("./") || // Relative
+        trimmed.startsWith("../") || // Parent
+        trimmed.startsWith("~/")) {
+        // Home
+        return { type: "local", source: trimmed, original: input };
+    }
+    // 7. GitHub/GitLab/Bitbucket shorthand: user/repo
+    // Must not start with @ (that's npm scoped packages)
+    // Must have exactly one / (to avoid paths like ./foo/bar)
+    const shorthandPattern = /^([a-zA-Z0-9][-a-zA-Z0-9_.]*)\/([a-zA-Z0-9][-a-zA-Z0-9_.]*)(@|#)?/;
+    if (!trimmed.startsWith("@") && shorthandPattern.test(trimmed)) {
+        // Default to GitHub for shorthand
+        return { type: "github", source: `github:${trimmed}`, original: input };
+    }
+    // 8. Default to npm package
+    return { type: "npm", source: trimmed, original: input, registry: "npm" };
+}
+/**
+ * Build package manager install command for a resolved kit source.
+ *
+ * @param resolved - The resolved kit source
+ * @param pm - Package manager to use
+ * @param flags - Installation flags (dev, global)
+ * @returns Command string to execute
+ */
+export function buildInstallCommand(resolved, pm, flags) {
+    // Special handling for JSR packages
+    if (resolved.type === "jsr") {
+        if (pm === "bun") {
+            // Bun supports JSR natively
+            return buildStandardCommand(pm, resolved.source, flags);
+        }
+        // For npm/pnpm/yarn, use npx jsr add
+        const jsrPackage = resolved.source.replace("jsr:", "").replace("@jsr/", "@");
+        return `npx jsr add ${jsrPackage}`;
+    }
+    // All other types work with standard package manager commands
+    return buildStandardCommand(pm, resolved.source, flags);
+}
+/**
+ * Build standard package manager command
+ */
+function buildStandardCommand(pm, source, flags) {
+    const escapedSource = shellEscape(source);
+    if (pm === "bun") {
+        return flags.global
+            ? `bun add -g ${escapedSource}`
+            : flags.dev
+                ? `bun add -d ${escapedSource}`
+                : `bun add ${escapedSource}`;
+    }
+    if (pm === "pnpm") {
+        return flags.global
+            ? `pnpm add -g ${escapedSource}`
+            : flags.dev
+                ? `pnpm add -D ${escapedSource}`
+                : `pnpm add ${escapedSource}`;
+    }
+    if (pm === "yarn") {
+        return flags.global
+            ? `yarn global add ${escapedSource}`
+            : flags.dev
+                ? `yarn add -D ${escapedSource}`
+                : `yarn add ${escapedSource}`;
+    }
+    // npm
+    return flags.global
+        ? `npm install -g ${escapedSource}`
+        : flags.dev
+            ? `npm install -D ${escapedSource}`
+            : `npm install ${escapedSource}`;
+}
+/**
+ * Shell-escape a kit source string to prevent command injection.
+ *
+ * @param source - The kit source string
+ * @returns Shell-escaped string safe for command execution
+ * @throws Error if source contains dangerous shell metacharacters
+ */
+function shellEscape(source) {
+    // Reject obvious shell injection characters
+    const dangerousChars = /[;&|`$(){}!><\n\r]/;
+    if (dangerousChars.test(source)) {
+        throw new Error(`Invalid kit specifier: "${source}"\nKit sources must not contain shell metacharacters.`);
+    }
+    // Wrap in single quotes for shell safety, escaping internal single quotes
+    return `'${source.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=source-resolver.js.map

package/dist/source-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-resolver.js","sourceRoot":"","sources":["../src/source-resolver.ts"],"names":[],"mappings":"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"}

package/dist/utils/find-project-root.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Find the project root directory by looking for package.json
+ * with monorepo detection support
+ */
+export interface ProjectRootInfo {
+    /** The project root directory */
+    root: string;
+    /** Whether this is a monorepo workspace */
+    isMonorepo: boolean;
+    /** If in a monorepo, the workspace root (otherwise same as root) */
+    workspaceRoot: string;
+    /** The package.json that was found */
+    packageJsonPath: string;
+}
+/**
+ * Find the project root, with monorepo detection
+ *
+ * This function:
+ * 1. Finds the nearest package.json from startDir
+ * 2. If it's a workspace package, walks up to find the monorepo root
+ * 3. Returns both the immediate project root and workspace root (if in monorepo)
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns Project root information
+ */
+export declare function findProjectRoot(startDir?: string): ProjectRootInfo;
+/**
+ * Get the directory where .hyper/kits should be located
+ * Always uses the workspace root if in a monorepo
+ */
+export declare function getKitsDirectory(startDir?: string): string;
+//# sourceMappingURL=find-project-root.d.ts.map

package/dist/utils/find-project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-project-root.d.ts","sourceRoot":"","sources":["../../src/utils/find-project-root.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,eAAe;IAC/B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;CACxB;AA0ED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,eAAe,CAwDjF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAGzE"}

package/dist/utils/find-project-root.js

@@ -0,0 +1,135 @@
+/**
+ * Find the project root directory by looking for package.json
+ * with monorepo detection support
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import createDebug from "debug";
+const debug = createDebug("hypergen:utils:project-root");
+/**
+ * Find the nearest package.json walking up from startDir
+ */
+function findNearestPackageJson(startDir) {
+    let dir = startDir;
+    while (dir !== "/" && dir !== ".") {
+        const packageJsonPath = join(dir, "package.json");
+        if (existsSync(packageJsonPath)) {
+            return packageJsonPath;
+        }
+        const parent = join(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Check if a package.json indicates a monorepo root
+ */
+function isMonorepoRoot(packageJsonPath) {
+    try {
+        const content = readFileSync(packageJsonPath, "utf-8");
+        const packageJson = JSON.parse(content);
+        // Check for common monorepo indicators
+        return !!((packageJson.workspaces || // npm/yarn/pnpm workspaces
+            packageJson.bolt?.workspaces || // bolt
+            existsSync(join(dirname(packageJsonPath), "pnpm-workspace.yaml")) || // pnpm
+            existsSync(join(dirname(packageJsonPath), "lerna.json"))) // lerna
+        );
+    }
+    catch (error) {
+        debug("Error reading package.json: %s", error);
+        return false;
+    }
+}
+/**
+ * Check if we're inside a monorepo workspace package
+ */
+function isWorkspacePackage(packageJsonPath) {
+    try {
+        const content = readFileSync(packageJsonPath, "utf-8");
+        JSON.parse(content); // Validate JSON format
+        // Workspace packages typically don't have a "private: true" at root
+        // but we need to check if there's a parent with workspaces
+        const dir = dirname(packageJsonPath);
+        const parentPackageJson = findNearestPackageJson(join(dir, ".."));
+        if (parentPackageJson && isMonorepoRoot(parentPackageJson)) {
+            debug("Found workspace package at %s with monorepo root at %s", packageJsonPath, parentPackageJson);
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        debug("Error checking if workspace package: %s", error);
+        return false;
+    }
+}
+/**
+ * Find the project root, with monorepo detection
+ *
+ * This function:
+ * 1. Finds the nearest package.json from startDir
+ * 2. If it's a workspace package, walks up to find the monorepo root
+ * 3. Returns both the immediate project root and workspace root (if in monorepo)
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns Project root information
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    debug("Finding project root from: %s", startDir);
+    // Find nearest package.json
+    const nearestPackageJson = findNearestPackageJson(startDir);
+    if (!nearestPackageJson) {
+        debug("No package.json found, using startDir as root");
+        return {
+            root: startDir,
+            isMonorepo: false,
+            workspaceRoot: startDir,
+            packageJsonPath: startDir,
+        };
+    }
+    const immediateRoot = dirname(nearestPackageJson);
+    debug("Found package.json at: %s", nearestPackageJson);
+    // Check if this is a monorepo root
+    if (isMonorepoRoot(nearestPackageJson)) {
+        debug("This is a monorepo root");
+        return {
+            root: immediateRoot,
+            isMonorepo: true,
+            workspaceRoot: immediateRoot,
+            packageJsonPath: nearestPackageJson,
+        };
+    }
+    // Check if we're in a workspace package
+    if (isWorkspacePackage(nearestPackageJson)) {
+        // Walk up to find the monorepo root
+        const workspaceRootPackageJson = findNearestPackageJson(join(immediateRoot, ".."));
+        if (workspaceRootPackageJson) {
+            const workspaceRoot = dirname(workspaceRootPackageJson);
+            debug("Found monorepo workspace root at: %s", workspaceRoot);
+            return {
+                root: immediateRoot,
+                isMonorepo: true,
+                workspaceRoot,
+                packageJsonPath: nearestPackageJson,
+            };
+        }
+    }
+    // Not a monorepo or couldn't find workspace root
+    debug("Not in a monorepo");
+    return {
+        root: immediateRoot,
+        isMonorepo: false,
+        workspaceRoot: immediateRoot,
+        packageJsonPath: nearestPackageJson,
+    };
+}
+/**
+ * Get the directory where .hyper/kits should be located
+ * Always uses the workspace root if in a monorepo
+ */
+export function getKitsDirectory(startDir = process.cwd()) {
+    const projectInfo = findProjectRoot(startDir);
+    return join(projectInfo.workspaceRoot, ".hyper", "kits");
+}
+//# sourceMappingURL=find-project-root.js.map

package/dist/utils/find-project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-project-root.js","sourceRoot":"","sources":["../../src/utils/find-project-root.ts"],"names":[],"mappings":"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"}

package/help/kit/info.md

@@ -0,0 +1,41 @@
+# hyper kit info
+
+Show detailed information about an installed kit, including its cookbooks, recipes, and optionally its variables and source provenance.
+
+## Usage
+
+`hyper kit info <kit> [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `kit` | Name of the installed kit |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--variables` | Show variable details defined by the kit |
+| `--source` | Show provenance info (path, URL, commit, branch, tag) |
+| `--recipes` | Expand recipes with descriptions |
+| `--steps` | Show step list with tool types (recipe info only) |
+| `--json` | Output as JSON |
+| `--cwd <dir>` | Working directory |
+| `-d, --debug` | Enable debug output |
+
+## Examples
+
+```sh
+# Show kit overview with cookbooks and recipes
+hyper kit info starlight
+
+# Include variable definitions
+hyper kit info starlight --variables
+
+# Include source and install metadata
+hyper kit info starlight --source
+
+# Output as JSON
+hyper kit info starlight --json
+```

package/help/kit/install.md

@@ -0,0 +1,52 @@
+# hyper kit install
+
+Install a kit from npm, JSR, GitHub, or local path.
+
+## Usage
+
+`hyper kit install <kit> [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `kit` | Kit to install — accepts an npm package name, JSR package, GitHub shorthand (`user/repo`), full Git URL, or local path |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--dev` | Install as a dev dependency (npm/JSR only) |
+| `-n, --name <name>` | Name to use for the kit directory (default: auto-detected from source) |
+| `-f, --force` | Replace an existing kit even if already installed |
+| `--cwd <dir>` | Working directory |
+| `-d, --debug` | Enable debug output |
+
+## Examples
+
+```sh
+# Install from npm
+hyper kit install @kit/nextjs
+
+# Install from GitHub shorthand
+hyper kit install svallory/hypergen-kit-nextjs
+
+# Install from JSR
+hyper kit install jsr:@std/path
+
+# Install from a local directory
+hyper kit install ./local-kit
+
+# Install from a full Git URL
+hyper kit install https://github.com/user/repo.git
+
+# Install with a custom name
+hyper kit install svallory/hypergen-kit-nextjs --name nextjs
+
+# Force reinstall (change source or refresh)
+hyper kit install ./local-kit --force
+```
+
+## Notes
+
+npm and JSR kits are installed into `node_modules` via your project's package manager. GitHub, Git URL, and local path kits are copied to `.hyper/kits/<name>/` and tracked in the kit manifest.

package/help/kit/list.md

@@ -0,0 +1,25 @@
+# hyper kit list
+
+List all kits installed in the current project, including their cookbooks and available recipes.
+
+## Usage
+
+`hyper kit list [flags]`
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output as JSON |
+| `--cwd <dir>` | Working directory |
+| `-d, --debug` | Enable debug output |
+
+## Examples
+
+```sh
+# List installed kits with cookbooks and recipes
+hyper kit list
+
+# Output as JSON for scripting
+hyper kit list --json
+```

package/help/kit/uninstall.md

@@ -0,0 +1,38 @@
+# hyper kit uninstall
+
+Remove an installed kit from your project. Also available as `hyper kit remove`.
+
+## Usage
+
+`hyper kit uninstall <kit> [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `kit` | Name of the kit to uninstall |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `-f, --force` | Skip the confirmation prompt |
+| `--cwd <dir>` | Working directory |
+| `-d, --debug` | Enable debug output |
+
+## Examples
+
+```sh
+# Remove a kit (prompts for confirmation)
+hyper kit uninstall starlight
+
+# Remove without confirmation
+hyper kit uninstall starlight --force
+
+# Alias
+hyper kit remove starlight
+```
+
+## Notes
+
+For npm/JSR kits, the package is removed via your project's package manager. For GitHub, Git URL, and local path kits, the directory under `.hyper/kits/` is deleted and the kit is removed from the manifest.

package/help/kit/update.md

@@ -0,0 +1,35 @@
+# hyper kit update
+
+Update installed kits by re-fetching from their original source. Either update a single kit by name or all kits at once with `--all`.
+
+## Usage
+
+`hyper kit update [kit] [flags]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `kit` | Name of the kit to update (omit when using `--all`) |
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--all` | Update all installed kits |
+| `--cwd <dir>` | Working directory |
+| `-d, --debug` | Enable debug output |
+
+## Examples
+
+```sh
+# Update a single kit
+hyper kit update nextjs
+
+# Update all installed kits
+hyper kit update --all
+```
+
+## Notes
+
+npm and JSR kits are updated through your package manager — this command will print the appropriate command to run (e.g. `bun update <package>`). For GitHub, Git URL, and local path kits, the existing `.hyper/kits/<name>/` directory is replaced by re-fetching from the recorded source.

package/help/kit.md

@@ -0,0 +1,36 @@
+# hyper kit
+
+Manage the kits installed in your project. Kits are generator packages that provide recipes and cookbooks for code generation.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `hyper kit install <source>` | Install a kit from npm, JSR, GitHub, or local path |
+| `hyper kit list` | List all installed kits |
+| `hyper kit info <kit>` | Show detailed information about a kit |
+| `hyper kit uninstall <kit>` | Remove an installed kit |
+| `hyper kit update [kit]` | Update installed kits from their original source |
+
+## Examples
+
+```sh
+# Install a kit from GitHub
+hyper kit install svallory/hypergen-kit-nextjs
+
+# List all installed kits
+hyper kit list
+
+# Show details for a specific kit
+hyper kit info nextjs
+
+# Update all kits at once
+hyper kit update --all
+
+# Remove a kit
+hyper kit uninstall nextjs
+```
+
+## How kits are stored
+
+Kits installed from GitHub, Git URLs, or local paths are stored in `.hyper/kits/` inside your project. Kits installed from npm or JSR are installed as regular node_modules using your project's package manager.