@hypercli/cli 0.1.1

package/help/recipe.md

@@ -0,0 +1,32 @@
+# hyper recipe
+
+Recipes are the core unit of code generation in Hyper. A recipe is a YAML workflow that describes what files to create, what templates to render, and what prompts to ask the user. Recipes live inside kits and can be run directly or composed into cookbooks.
+
+## Usage
+
+`hyper recipe <command>`
+
+## Quick Start
+
+```sh
+# List all recipes available from installed kits
+hyper recipe list
+
+# Run a recipe by path
+hyper recipe run my-recipe.yml --name=Button
+
+# Validate a recipe without running it
+hyper recipe validate my-recipe.yml
+```
+
+## Shorthand Syntax
+
+When a kit is installed, you can run its recipes without the `recipe run` prefix:
+
+```sh
+# These are equivalent
+hyper recipe run nextjs/crud --entity=Post
+hyper nextjs crud --entity=Post
+```
+
+Run `hyper recipe <command> --help` for details on any subcommand.

package/help/root.md

@@ -0,0 +1,49 @@
+# hyper
+
+Modern, scalable code generator with AI integration.
+
+## Usage
+
+`hyper <command> [options]`
+
+## Getting Started
+
+```sh
+# Initialize Hyper in your project
+hyper init
+
+# Install a generator kit
+hyper kit install nextjs
+
+# Generate code from a recipe
+hyper gen nextjs crud create
+```
+
+## Generation
+
+| Command | Description |
+|---------|-------------|
+| `hyper gen <recipe>` | Execute a recipe to generate code |
+| `hyper recipe list` | Browse available recipes |
+| `hyper recipe run <file>` | Run a recipe by file path |
+| `hyper cookbook list` | Explore multi-step cookbooks |
+
+**Shorthand:** `hyper nextjs crud` is equivalent to `hyper gen nextjs crud`.
+
+## Session Management
+
+| Command | Description |
+|---------|-------------|
+| `hyper hq start` | Start the always-on HQ control center |
+| `hyper hq spawn <project>` | Spawn a Claude session for a project |
+| `hyper hq status` | Check running sessions |
+
+## Kit Management
+
+| Command | Description |
+|---------|-------------|
+| `hyper kit install <source>` | Install a kit from npm, GitHub, or local path |
+| `hyper kit list` | List installed kits |
+| `hyper kit update` | Update kits to latest versions |
+
+Run `hyper help <topic>` to learn more about any topic, or `hyper <command> --help` for command details.

package/oclif.manifest.json

@@ -0,0 +1,214 @@
+{
+  "commands": {
+    "init": {
+      "aliases": [],
+      "args": {},
+      "description": "Initialize Hyper in the current project",
+      "examples": [
+        "<%= config.bin %> init",
+        "<%= config.bin %> init --force",
+        "<%= config.bin %> init --cwd ./my-project"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing configuration",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "init",
+      "pluginAlias": "@hypercli/cli",
+      "pluginName": "@hypercli/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "init.js"
+      ]
+    },
+    "autocomplete:create": {
+      "aliases": [],
+      "args": {},
+      "description": "create autocomplete setup scripts and completion functions",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "autocomplete:create",
+      "pluginAlias": "@hypercli/cli",
+      "pluginName": "@hypercli/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "autocomplete",
+        "create.js"
+      ]
+    },
+    "autocomplete:generate": {
+      "aliases": [],
+      "args": {},
+      "description": "Generate dynamic completions (called by shell scripts)",
+      "flags": {
+        "enum-values": {
+          "description": "Get enum values for a specific flag (kit:cookbook:recipe:flag)",
+          "name": "enum-values",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "autocomplete:generate",
+      "pluginAlias": "@hypercli/cli",
+      "pluginName": "@hypercli/cli",
+      "pluginType": "core",
+      "strict": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "autocomplete",
+        "generate.js"
+      ]
+    },
+    "autocomplete": {
+      "aliases": [],
+      "args": {
+        "shell": {
+          "description": "Shell type",
+          "name": "shell",
+          "options": [
+            "zsh",
+            "bash",
+            "powershell"
+          ],
+          "required": false
+        }
+      },
+      "description": "Display autocomplete installation instructions.",
+      "examples": [
+        "$ <%= config.bin %> autocomplete",
+        "$ <%= config.bin %> autocomplete bash",
+        "$ <%= config.bin %> autocomplete zsh",
+        "$ <%= config.bin %> autocomplete powershell",
+        "$ <%= config.bin %> autocomplete --refresh-cache"
+      ],
+      "flags": {
+        "refresh-cache": {
+          "char": "r",
+          "description": "Refresh cache (ignores displaying instructions)",
+          "name": "refresh-cache",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "autocomplete",
+      "pluginAlias": "@hypercli/cli",
+      "pluginName": "@hypercli/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "autocomplete",
+        "index.js"
+      ]
+    },
+    "autocomplete:script": {
+      "aliases": [],
+      "args": {
+        "shell": {
+          "description": "Shell type",
+          "name": "shell",
+          "options": [
+            "zsh",
+            "bash",
+            "powershell"
+          ],
+          "required": false
+        }
+      },
+      "description": "outputs autocomplete config script for shells",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "autocomplete:script",
+      "pluginAlias": "@hypercli/cli",
+      "pluginName": "@hypercli/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "autocomplete",
+        "script.js"
+      ]
+    },
+    "config:show": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the resolved Hypergen configuration",
+      "examples": [
+        "<%= config.bin %> config show",
+        "<%= config.bin %> config show --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output raw JSON (no interactive viewer)",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:show",
+      "pluginAlias": "@hypercli/cli",
+      "pluginName": "@hypercli/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "show.js"
+      ]
+    }
+  },
+  "version": "0.1.1"
+}

package/package.json

@@ -0,0 +1,126 @@
+{
+	"name": "@hypercli/cli",
+	"version": "0.1.1",
+	"type": "module",
+	"description": "HyperDev CLI",
+	"keywords": [
+		"hyperdev",
+		"hypergen",
+		"cli"
+	],
+	"author": "Saulo Vallory <saulo@toki.life>",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/svallory/hyper-coding.git",
+		"directory": "packages/cli"
+	},
+	"homepage": "https://hyperdev.saulo.engineer",
+	"bugs": {
+		"url": "https://github.com/svallory/hyper-coding/issues"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"bin": {
+		"hyper": "./bin/run.js"
+	},
+	"imports": {
+		"#commands/*": "./dist/commands/*.js",
+		"#help/*": "./dist/help/*.js",
+		"#tests/*": "./tests/*.ts",
+		"#fixtures/*": "./tests/fixtures/*.ts",
+		"#*": "./dist/*.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"bin/run.js",
+		"help",
+		"oclif.manifest.json",
+		"README.md",
+		"LICENSE"
+	],
+	"oclif": {
+		"bin": "hyper",
+		"dirname": "hyper",
+		"commands": "./dist/commands",
+		"helpClass": "./dist/help/custom-help",
+		"topics": {
+			"config": {
+				"description": "View and manage Hyper configuration"
+			},
+			"autocomplete": {
+				"description": "Set up shell tab completion",
+				"hidden": true
+			}
+		},
+		"plugins": [
+			"@hypercli/gen",
+			"@hypercli/hq",
+			"@hypercli/kit",
+			"@oclif/plugin-help",
+			"@oclif/plugin-commands",
+			"@oclif/plugin-version",
+			"@oclif/plugin-warn-if-update-available"
+		],
+		"hooks": {
+			"plugins:postinstall": "./dist/hooks/refresh-cache.js",
+			"plugins:postuninstall": "./dist/hooks/refresh-cache.js"
+		},
+		"warn-if-update-available": {
+			"timeoutInDays": 7
+		},
+		"topicSeparator": " "
+	},
+	"scripts": {
+		"build": "tsc",
+		"postbuild": "bunx oclif manifest",
+		"dev": "bun run bin/dev.js",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"format": "biome format . --write",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"dependencies": {
+		"@hypercli/core": "^0.1.1",
+		"@hypercli/gen": "^0.1.1",
+		"@hypercli/hq": "^0.1.1",
+		"@hypercli/kit": "^0.1.1",
+		"@hypercli/ui": "^0.1.1",
+		"@oclif/core": "^4.8.0",
+		"@oclif/plugin-commands": "^4.1.40",
+		"debug": "^4.4.1",
+		"js-yaml": "^4.1.0",
+		"@oclif/plugin-help": "^6.2.37",
+		"@oclif/plugin-version": "^2.2.36",
+		"@oclif/plugin-warn-if-update-available": "^3.1.55",
+		"chalk": "^4.1.2",
+		"fx": "^39.2.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@types/debug": "^4.1.12",
+		"@types/fs-extra": "^11.0.4",
+		"@types/js-yaml": "^4.0.9",
+		"@types/node": "^20.0.0",
+		"@vitest/coverage-v8": "^4.0.0",
+		"execa": "^9.6.1",
+		"fs-extra": "^11.3.3",
+		"typescript": "^5.4.0",
+		"vitest": "4.0.18"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	}
+}