@hypercli/gen 0.1.1

package/oclif.manifest.json

@@ -0,0 +1,580 @@
+{
+  "commands": {
+    "gen": {
+      "aliases": [],
+      "args": {
+        "recipe": {
+          "description": "Recipe to execute (path, package, or cookbook/recipe)",
+          "name": "recipe",
+          "required": true
+        }
+      },
+      "description": "Execute a recipe to generate code",
+      "examples": [
+        "<%= config.bin %> gen ./my-recipe",
+        "<%= config.bin %> gen @kit/starlight/create",
+        "<%= config.bin %> gen create-component --name=Button",
+        "<%= config.bin %> gen ./my-recipe --answers ./ai-answers.json",
+        "<%= config.bin %> gen crud edit-page --model=Organization",
+        "<%= config.bin %> nextjs crud update Organization"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry": {
+          "description": "Show what would be generated without writing files",
+          "name": "dry",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing files",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "answers": {
+          "description": "Path to AI answers JSON file (2-pass generation)",
+          "name": "answers",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "prompt-template": {
+          "description": "Path to a custom Jig template for the AI prompt document",
+          "name": "prompt-template",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ask": {
+          "description": "Who resolves missing variables: me (interactive), ai (use configured transport), stdout (print prompt doc to stdout), nobody (error)",
+          "name": "ask",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "me",
+            "ai",
+            "stdout",
+            "nobody"
+          ],
+          "type": "option"
+        },
+        "no-defaults": {
+          "description": "Don't use default values — ask about every variable",
+          "name": "no-defaults",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gen",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "gen.js"
+      ]
+    },
+    "cookbook:info": {
+      "aliases": [],
+      "args": {
+        "cookbook": {
+          "description": "Cookbook name or path",
+          "name": "cookbook",
+          "required": true
+        }
+      },
+      "description": "Show detailed information about a cookbook",
+      "examples": [
+        "<%= config.bin %> cookbook info starlight",
+        "<%= config.bin %> cookbook info @kit/starlight/docs --json"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cookbook:info",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cookbook",
+        "info.js"
+      ]
+    },
+    "cookbook:list": {
+      "aliases": [],
+      "args": {
+        "kit": {
+          "description": "Kit to list cookbooks from (optional, lists all if omitted)",
+          "name": "kit",
+          "required": false
+        }
+      },
+      "description": "List cookbooks in a kit or all installed cookbooks",
+      "examples": [
+        "<%= config.bin %> cookbook list",
+        "<%= config.bin %> cookbook list @kit/starlight",
+        "<%= config.bin %> cookbook list --json"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "kit": {
+          "char": "k",
+          "description": "Filter by kit name",
+          "name": "kit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cookbook:list",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cookbook",
+        "list.js"
+      ]
+    },
+    "recipe:info": {
+      "aliases": [],
+      "args": {
+        "recipe": {
+          "description": "Path to recipe file (.yml or .yaml)",
+          "name": "recipe",
+          "required": true
+        }
+      },
+      "description": "Show detailed recipe information",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my-recipe.yml",
+        "<%= config.bin %> <%= command.id %> .hyper/kits/component.yml --json"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Quiet output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "recipe:info",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "recipe",
+        "info.js"
+      ]
+    },
+    "recipe:list": {
+      "aliases": [],
+      "args": {
+        "kit": {
+          "description": "Kit to list recipes from (optional, lists all if omitted)",
+          "name": "kit",
+          "required": false
+        }
+      },
+      "description": "List available recipes from all discovered kits",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> nextjs",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Quiet output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "kit": {
+          "char": "k",
+          "description": "Filter by kit name",
+          "name": "kit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cookbook": {
+          "char": "c",
+          "description": "Filter by cookbook name",
+          "name": "cookbook",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "recipe:list",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "recipe",
+        "list.js"
+      ]
+    },
+    "recipe:run": {
+      "aliases": [],
+      "args": {
+        "recipe": {
+          "description": "Path to recipe file (.yml or .yaml)",
+          "name": "recipe",
+          "required": true
+        }
+      },
+      "description": "Execute a recipe to generate code",
+      "examples": [
+        "<%= config.bin %> recipe run my-recipe.yml",
+        "<%= config.bin %> recipe run .hyper/kits/my-kit/cookbooks/component/recipe.yml --name=Button",
+        "<%= config.bin %> recipe run recipe.yml --dry",
+        "<%= config.bin %> recipe run recipe.yml --answers ./ai-answers.json",
+        "<%= config.bin %> recipe run recipe.yml --ai-mode stdout"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Quiet output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry": {
+          "description": "Dry run mode",
+          "name": "dry",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "Force overwrite",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "answers": {
+          "description": "Path to AI answers JSON file",
+          "name": "answers",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dryRun": {
+          "description": "Dry run mode (alias for --dry)",
+          "name": "dryRun",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skipPrompts": {
+          "description": "Skip all prompts",
+          "name": "skipPrompts",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "defaults": {
+          "description": "Use default values",
+          "name": "defaults",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "continueOnError": {
+          "description": "Continue on errors",
+          "name": "continueOnError",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ai-mode": {
+          "description": "AI mode",
+          "name": "ai-mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "me",
+            "ai",
+            "nobody"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "recipe:run",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "recipe",
+        "run.js"
+      ]
+    },
+    "recipe:validate": {
+      "aliases": [],
+      "args": {
+        "recipe": {
+          "description": "Path to recipe file (.yml or .yaml)",
+          "name": "recipe",
+          "required": true
+        }
+      },
+      "description": "Validate a recipe file",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my-recipe.yml",
+        "<%= config.bin %> <%= command.id %> .hyper/kits/component.yml --strict"
+      ],
+      "flags": {
+        "cwd": {
+          "description": "Working directory",
+          "name": "cwd",
+          "default": "/work/hyper/packages/gen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Enable debug output",
+          "env": "DEBUG",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Quiet output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "strict": {
+          "description": "Strict validation mode",
+          "name": "strict",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "recipe:validate",
+      "pluginAlias": "@hypercli/gen",
+      "pluginName": "@hypercli/gen",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "recipe",
+        "validate.js"
+      ]
+    }
+  },
+  "version": "0.1.1"
+}

package/package.json

@@ -0,0 +1,120 @@
+{
+	"name": "@hypercli/gen",
+	"version": "0.1.1",
+	"type": "module",
+	"description": "Code generation engine for HyperDev",
+	"keywords": [
+		"hyperdev",
+		"hypergen",
+		"code-generator"
+	],
+	"author": "Saulo Vallory <saulo@toki.life>",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/svallory/hyper-coding.git",
+		"directory": "packages/gen"
+	},
+	"homepage": "https://hyperdev.saulo.engineer",
+	"bugs": {
+		"url": "https://github.com/svallory/hyper-coding/issues"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"help",
+		"oclif.manifest.json",
+		"README.md",
+		"LICENSE"
+	],
+	"oclif": {
+		"commands": "./dist/commands",
+		"hooks": {
+			"command_not_found": "./dist/hooks/command-not-found.js"
+		},
+		"topics": {
+			"recipe": {
+				"description": "Browse and run code generation recipes"
+			},
+			"cookbook": {
+				"description": "Explore multi-step generation cookbooks"
+			}
+		},
+		"topicSeparator": " "
+	},
+	"imports": {
+		"#discovery": "./dist/discovery/index.js",
+		"#discovery/*": "./dist/discovery/*.js",
+		"#utils/*": "./dist/utils/*.js",
+		"#ai": "./dist/ai/index.js",
+		"#ai/*": "./dist/ai/*.js",
+		"#hooks/*": "./dist/hooks/*.js",
+		"#actions": "./dist/actions/index.js",
+		"#actions/*": "./dist/actions/*.js",
+		"#lib/*": "./dist/lib/*.js",
+		"#prompts/*": "./dist/prompts/*.js",
+		"#ops/*": "./dist/ops/*.js",
+		"#commands/*": "./dist/commands/*.js",
+		"#recipe-engine": "./dist/recipe-engine/index.js",
+		"#recipe-engine/*": "./dist/recipe-engine/*.js",
+		"#template-engines": "./dist/template-engines/index.js",
+		"#template-engines/*": "./dist/template-engines/*.js",
+		"#tests/*": "./tests/*.ts",
+		"#fixtures/*": "./tests/fixtures/*.ts",
+		"#*": "./dist/*.js"
+	},
+	"scripts": {
+		"build": "tsc && bun run copy-assets",
+		"postbuild": "bunx oclif manifest",
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"copy-assets": "mkdir -p dist/ai && cp src/ai/prompt-template.jig dist/ai/",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"format": "biome format . --write",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"dependencies": {
+		"@clack/prompts": "^0.11.0",
+		"@hypercli/core": "^0.1.1",
+		"@hypercli/kit": "^0.1.1",
+		"@hypercli/ui": "^0.1.1",
+		"@jig-lang/jig": "^1.0.1",
+		"@oclif/core": "^4",
+		"ai": "^4.0.0",
+		"chalk": "^4.1.2",
+		"debug": "^4.4.3",
+		"disparity": "^3.2.0",
+		"execa": "^5.1.1",
+		"fastest-levenshtein": "^1.0.16",
+		"front-matter": "^4.0.2",
+		"fs-extra": "^10.1.0",
+		"glob": "^11.0.3",
+		"js-yaml": "^4.1.0",
+		"typescript": "^5.4.0",
+		"zod": "^3.22.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@types/fs-extra": "^11.0.0",
+		"@types/js-yaml": "^4.0.9",
+		"@types/node": "^20.0.0",
+		"typescript": "^5.4.0",
+		"vitest": "4.0.18"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	}
+}