@patternfly/patternfly-cli 1.0.2

package/.github/workflows/build.yml

@@ -0,0 +1,21 @@
+name: Build
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - run: npm ci
+      - run: npm run build

package/.github/workflows/lint.yml

@@ -0,0 +1,24 @@
+name: Lint
+
+on:
+  workflow_run:
+    workflows: [Build]
+    types: [completed]
+    branches: [main, master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    if: github.event.workflow_run.conclusion == 'success'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_sha }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - run: npm ci
+      - run: npm run lint

package/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm run semantic-release

package/.github/workflows/test.yml

@@ -0,0 +1,24 @@
+name: Test
+
+on:
+  workflow_run:
+    workflows: [Build]
+    types: [completed]
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    if: github.event.workflow_run.conclusion == 'success'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_sha }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - run: npm ci
+      - run: npm test

package/.releaserc.json

@@ -0,0 +1,14 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    ["@semantic-release/commit-analyzer",
+    { "preset": "angular",
+    "parserOpts"  : {
+      "noteKeywords": [ "BREAKING-CHANGE" ]
+    }
+  }],
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/npm",
+    "@semantic-release/github"
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Red Hat
+
+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

@@ -0,0 +1,110 @@
+# Patternfly CLI
+
+Patternfly CLI is a command-line tool designed for scaffolding projects, performing code modifications, and running project-related tasks. It aims to streamline development workflows and improve productivity.
+
+## Features
+
+- **Project Scaffolding**: Quickly set up new projects with predefined templates.
+- **Code Modifications**: Automate repetitive code changes.
+- **Task Runner**: Execute project-related tasks efficiently.
+
+## Installation
+
+To install the CLI globally, use npm:
+
+```sh
+npm install -g patternfly-cli
+```
+
+## Prerequisites
+
+Before using the Patternfly CLI, install the following:
+
+- **Node.js and npm** (v20–24) — [npm](https://www.npmjs.com/) · [Node.js downloads](https://nodejs.org/)
+- **Corepack** — enable with `corepack enable` (included with Node.js). Run the command after installing npm.
+- **GitHub CLI** — [Install GitHub CLI](https://cli.github.com/)
+  
+## Usage
+
+After installation, you can use the CLI by running:
+
+```sh
+patternfly-cli [command]
+```
+
+### Available Commands
+
+- **`create`**: Create a new project from the available templates.
+- **`list`**: List all available templates (built-in and optional custom).
+- **`update`**: Update your project to a newer version.
+
+### Custom templates
+
+You can add your own templates in addition to the built-in ones by passing a JSON file with the `--template-file` (or `-t`) option. Custom templates are merged with the built-in list; if a custom template has the same `name` as a built-in one, the custom definition is used.
+
+**Create with custom templates:**
+
+```sh
+patternfly-cli create my-app --template-file ./my-templates.json
+```
+
+**List templates including custom file:**
+
+```sh
+patternfly-cli list --template-file ./my-templates.json
+```
+
+**JSON format** (array of template objects, same shape as the built-in templates):
+
+```json
+[
+  {
+    "name": "my-template",
+    "description": "My custom project template",
+    "repo": "https://github.com/org/repo.git",
+    "options": ["--single-branch", "--branch", "main"],
+    "packageManager": "npm"
+  }
+]
+```
+
+- **`name`** (required): Template identifier.
+- **`description`** (required): Short description shown in prompts and `list`.
+- **`repo`** (required): Git clone URL.
+- **`options`** (optional): Array of extra arguments for `git clone` (e.g. `["--single-branch", "--branch", "main"]`).
+- **`packageManager`** (optional): `npm`, `yarn`, or `pnpm`; defaults to `npm` if omitted.
+
+
+## Development / Installation
+
+### Install Dependencies
+
+```sh
+npm install
+```
+
+### Build
+
+To build the project, run:
+
+```sh
+npm run build
+```
+
+### Installing the cli
+
+After building the cli you can install the cli globally by running the following command:
+
+```sh
+npm install -g
+```
+
+After that you can now execute the cli via ```patternfly-cli``` command in the terminal.
+
+### Releasing
+
+This project uses [semantic-release](https://semantic-release.gitbook.io/) to automate versioning and releases based on [Conventional Commits](https://www.conventionalcommits.org/).
+
+- **CI**: Pushing to `main` runs the release workflow. If there are commits that warrant a release (e.g. `feat:`, `fix:`, `BREAKING CHANGE:`), it will create a GitHub release, update `CHANGELOG.md`, and bump the version in `package.json`.
+- **Local dry run**: `npx semantic-release --dry-run` (no push or publish).
+- **npm publish**: By default only GitHub releases are created. To publish to npm, set the `NPM_TOKEN` secret in the repo and set `"npmPublish": true` for the `@semantic-release/npm` plugin in `.releaserc.json`.

package/__mocks__/execa.js

@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = {
+  execa: jest.fn(),
+};

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { execa } from 'execa';
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import { defaultTemplates } from './templates.js';
+import { mergeTemplates } from './template-loader.js';
+import { offerAndCreateGitHubRepo } from './github.js';
+import { runSave } from './save.js';
+import { runLoad } from './load.js';
+/** Command to create a new project */
+program
+    .version('1.0.0')
+    .command('create')
+    .description('Create a new project from a git template')
+    .argument('[project-directory]', 'The directory to create the project in')
+    .argument('[template-name]', 'The name of the template to use')
+    .option('-t, --template-file <path>', 'Path to a JSON file with custom templates (same format as built-in)')
+    .option('--ssh', 'Use SSH URL for cloning the template repository')
+    .action(async (projectDirectory, templateName, options) => {
+    const templatesToUse = mergeTemplates(defaultTemplates, options?.templateFile);
+    // If project directory is not provided, prompt for it
+    if (!projectDirectory) {
+        const projectDirAnswer = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'projectDirectory',
+                message: 'Please provide the directory where you want to create the project?',
+                default: 'my-app',
+            },
+        ]);
+        projectDirectory = projectDirAnswer.projectDirectory;
+    }
+    // If template name is not provided, show available templates and let user select
+    if (!templateName) {
+        console.log('\n📋 Available templates:\n');
+        templatesToUse.forEach(t => {
+            console.log(`  ${t.name.padEnd(12)} - ${t.description}`);
+        });
+        console.log('');
+        const templateQuestion = [
+            {
+                type: 'list',
+                name: 'templateName',
+                message: 'Select a template:',
+                choices: templatesToUse.map(t => ({
+                    name: `${t.name} - ${t.description}`,
+                    value: t.name
+                }))
+            }
+        ];
+        const templateAnswer = await inquirer.prompt(templateQuestion);
+        templateName = templateAnswer.templateName;
+    }
+    // Look up the template by name
+    const template = templatesToUse.find(t => t.name === templateName);
+    if (!template) {
+        console.error(`❌ Template "${templateName}" not found.\n`);
+        console.log('📋 Available templates:\n');
+        templatesToUse.forEach(t => {
+            console.log(`  ${t.name.padEnd(12)} - ${t.description}`);
+        });
+        console.log('');
+        process.exit(1);
+    }
+    // If --ssh was not passed, prompt whether to use SSH
+    let useSSH = options?.ssh;
+    if (useSSH === undefined && template.repoSSH) {
+        const sshAnswer = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'useSSH',
+                message: 'Use SSH URL for cloning?',
+                default: false,
+            },
+        ]);
+        useSSH = sshAnswer.useSSH;
+    }
+    const templateRepoUrl = useSSH && template.repoSSH ? template.repoSSH : template.repo;
+    // Define the full path for the new project
+    const projectPath = path.resolve(projectDirectory);
+    console.log(`Cloning template "${templateName}" from ${templateRepoUrl} into ${projectPath}...`);
+    try {
+        // Clone the repository
+        const cloneArgs = ['clone'];
+        if (template.options && Array.isArray(template.options)) {
+            cloneArgs.push(...template.options);
+        }
+        cloneArgs.push(templateRepoUrl, projectPath);
+        await execa('git', cloneArgs, { stdio: 'inherit' });
+        console.log('✅ Template cloned successfully.');
+        // Remove the .git folder from the *new* project
+        await fs.remove(path.join(projectPath, '.git'));
+        console.log('🧹 Cleaned up template .git directory.');
+        // Ask user for customization details
+        const questions = [
+            {
+                type: 'input',
+                name: 'name',
+                message: 'What is the project name?',
+                default: path.basename(projectPath),
+            },
+            {
+                type: 'input',
+                name: 'version',
+                message: 'What version number would you like to use?',
+                default: '1.0.0',
+            },
+            {
+                type: 'input',
+                name: 'description',
+                message: 'What is the project description?',
+                default: '',
+            },
+            {
+                type: 'input',
+                name: 'author',
+                message: 'Who is the author of the project?',
+                default: '',
+            },
+        ];
+        const answers = await inquirer.prompt(questions);
+        // Update the package.json in the new project
+        const pkgJsonPath = path.join(projectPath, 'package.json');
+        if (await fs.pathExists(pkgJsonPath)) {
+            const pkgJson = await fs.readJson(pkgJsonPath);
+            // Overwrite fields with user's answers
+            pkgJson.name = answers.name;
+            pkgJson.version = answers.version;
+            pkgJson.description = answers.description;
+            pkgJson.author = answers.author;
+            // Write the updated package.json back
+            await fs.writeJson(pkgJsonPath, pkgJson, { spaces: 2 });
+            console.log('📝 Customized package.json.');
+        }
+        else {
+            console.log('ℹ️ No package.json found in template, skipping customization.');
+        }
+        const packageManager = template.packageManager || "npm";
+        // Install dependencies
+        console.log('📦 Installing dependencies... (This may take a moment)');
+        await execa(packageManager, ['install'], { cwd: projectPath, stdio: 'inherit' });
+        console.log('✅ Dependencies installed.');
+        // Optional: Create GitHub repository
+        await offerAndCreateGitHubRepo(projectPath);
+        // Let the user know the project was created successfully
+        console.log('\n✨ Project created successfully! ✨\n');
+        console.log(`To get started:`);
+        console.log(`  cd ${projectDirectory}`);
+        console.log('  Happy coding! 🚀');
+    }
+    catch (error) {
+        console.error('❌ An error occurred:');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        else if (error && typeof error === 'object' && 'stderr' in error) {
+            console.error(error.stderr || String(error));
+        }
+        else {
+            console.error(String(error));
+        }
+        // Clean up the created directory if an error occurred
+        if (await fs.pathExists(projectPath)) {
+            await fs.remove(projectPath);
+            console.log('🧹 Cleaned up failed project directory.');
+        }
+    }
+});
+/** Command to initialize a project and optionally create a GitHub repository */
+program
+    .command('init')
+    .description('Initialize the current directory (or path) as a git repo and optionally create a GitHub repository')
+    .argument('[path]', 'Path to the project directory (defaults to current directory)')
+    .action(async (dirPath) => {
+    const cwd = dirPath ? path.resolve(dirPath) : process.cwd();
+    const gitDir = path.join(cwd, '.git');
+    if (!(await fs.pathExists(gitDir))) {
+        await execa('git', ['init'], { stdio: 'inherit', cwd });
+        console.log('✅ Git repository initialized.\n');
+    }
+    await offerAndCreateGitHubRepo(cwd);
+});
+/** Command to list all available templates */
+program
+    .command('list')
+    .description('List all available templates')
+    .option('--verbose', 'List all available templates with verbose information')
+    .option('-t, --template-file <path>', 'Include templates from a JSON file (same format as built-in)')
+    .action((options) => {
+    const templatesToUse = mergeTemplates(defaultTemplates, options?.templateFile);
+    console.log('\n📋 Available templates:\n');
+    templatesToUse.forEach(template => {
+        console.log(`  ${template.name.padEnd(20)} - ${template.description}`);
+        if (options.verbose) {
+            console.log(`    Repo URL: ${template.repo}`);
+            if (template.options && Array.isArray(template.options)) {
+                console.log(`    Checkout Options: ${template.options.join(', ')}`);
+            }
+        }
+    });
+    console.log('');
+});
+/** Command to run PatternFly codemods on a directory */
+program
+    .command('update')
+    .description('Run PatternFly codemods on a directory to transform code to the latest PatternFly patterns')
+    .argument('[path]', 'The path to the source directory to run codemods on (defaults to "src")')
+    .option('--fix', 'Automatically apply fixes to files instead of just showing what would be changed')
+    .action(async (srcPath, options) => {
+    const targetPath = srcPath || 'src';
+    const resolvedPath = path.resolve(targetPath);
+    const commands = ['@patternfly/pf-codemods', '@patternfly/class-name-updater'];
+    console.log(`Running PatternFly updates on ${resolvedPath}...`);
+    for (const command of commands) {
+        try {
+            console.log(`\n📦 Running ${command}...`);
+            const args = [command];
+            if (options.fix) {
+                args.push('--fix');
+            }
+            args.push(resolvedPath);
+            await execa('npx', args, { stdio: 'inherit' });
+            console.log(`✅ ${command} completed successfully.`);
+        }
+        catch (error) {
+            console.error(`❌ An error occurred while running ${command}:`);
+            if (error instanceof Error) {
+                console.error(error.message);
+            }
+            else if (error && typeof error === 'object' && 'stderr' in error) {
+                console.error(error.stderr || String(error));
+            }
+            else {
+                console.error(String(error));
+            }
+            process.exit(1);
+        }
+    }
+    console.log('\n✨ All updates completed successfully! ✨');
+});
+/** Command to save changes: check for changes, prompt to commit, and push */
+program
+    .command('save')
+    .description('Check for changes, optionally commit them with a message, and push to the current branch')
+    .argument('[path]', 'Path to the repository (defaults to current directory)')
+    .action(async (repoPath) => {
+    const cwd = repoPath ? path.resolve(repoPath) : process.cwd();
+    try {
+        await runSave(cwd);
+    }
+    catch {
+        process.exit(1);
+    }
+});
+/** Command to load latest updates from the remote */
+program
+    .command('load')
+    .description('Pull the latest updates from GitHub')
+    .argument('[path]', 'Path to the repository (defaults to current directory)')
+    .action(async (repoPath) => {
+    const cwd = repoPath ? path.resolve(repoPath) : process.cwd();
+    try {
+        await runLoad(cwd);
+    }
+    catch {
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Sanitize a package name for use as a GitHub repository name (alphanumeric, hyphens, underscores)
+ */
+export declare function sanitizeRepoName(name: string): string;
+/**
+ * Check if GitHub CLI is installed and the user is authenticated
+ */
+export declare function checkGhAuth(): Promise<{
+    ok: true;
+    username: string;
+} | {
+    ok: false;
+    message: string;
+}>;
+/**
+ * Check if a repository already exists for the given owner and repo name
+ */
+export declare function repoExists(owner: string, repoName: string): Promise<boolean>;
+/**
+ * Create a new GitHub repository and return its URL. Does not push.
+ */
+export declare function createRepo(options: {
+    repoName: string;
+    projectPath: string;
+    username: string;
+    description?: string;
+}): Promise<string>;
+/**
+ * Interactive flow: prompt to create a GitHub repo under the current user, then create it and set origin.
+ * Returns true if a repo was created (or already had origin), false if skipped or failed.
+ */
+export declare function offerAndCreateGitHubRepo(projectPath: string): Promise<boolean>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5G;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlF;AAoBD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuFpF"}