@garyr/pt-cli 0.30.1 → 0.32.0

package/README.md

@@ -119,3 +119,12 @@ pt init ./new-project --file my-template.json --yes
 An official agent skill is included in this repository: [`skills/agency-pt-operator/SKILL.md`](skills/agency-pt-operator/SKILL.md).
 
 Equipping your agent with this skill allows it to automatically use `pt-cli` to lay down standardized boilerplate and capture new architectures you develop together.
+## Warning
+
+**⚠️ Beta Software Warning**: This project is in beta stage. While stable for most use cases, please make regular backups of your template configurations before running updates or major changes.
+
+**💾 Backup Paths**:
+- **Linux/macOS**: `~/.pt/` or `/home/username/.pt/` and `/Users/username/.pt/`
+- **Windows**: `%USERPROFILE%\.pt\` (typically `C:\Users\Username\.pt\`)
+
+Always back up these directories before installing new versions or making significant changes.

package/dist/commands/learnCommand.js

@@ -252,57 +252,72 @@ export async function learn(sourcePath, updateTemplate = null, options = {}) {
         selectedFolders = rootDirs.filter(d => ['APP', 'scripts', 'bin'].some(p => d === p)); // Only copy specific ones recursively
     }
     else {
-        const filesResponse = await inquirer.prompt({
-            type: 'checkbox',
-            name: 'selectedFiles',
-            message: 'Select root files to include as boilerplate:',
-            loop: false,
-            theme: {
-                icon: {
-                    checked: chalk.green('[x] '),
-                    unchecked: '[ ] ',
-                }
-            },
-            choices: rootFiles.map(f => ({
-                name: f,
-                checked: ['.makerc', 'readme.md', 'README.md', '.gitattributes', '.gitignore', 'Makefile', 'makefile', 'package.json'].some(p => f.toLowerCase() === p.toLowerCase())
-            }))
-        });
-        selectedFiles = filesResponse.selectedFiles;
-        const foldersResponse = await inquirer.prompt({
-            type: 'checkbox',
-            name: 'selectedStructure',
-            message: 'Select folders to include in the template structure (skeleton):',
-            loop: false,
-            theme: {
-                icon: {
-                    checked: chalk.green('[x] '),
-                    unchecked: '[ ] ',
-                }
-            },
-            choices: rootDirs.map(d => ({
-                name: d,
-                checked: true // Include all in structure by default
-            }))
-        });
-        selectedStructure = foldersResponse.selectedStructure;
-        const copyFoldersResponse = await inquirer.prompt({
-            type: 'checkbox',
-            name: 'selectedFolders',
-            message: 'Select folders to copy RECURSIVELY as boilerplate (with contents):',
-            loop: false,
-            theme: {
-                icon: {
-                    checked: chalk.green('[x] '),
-                    unchecked: '[ ] ',
-                }
-            },
-            choices: selectedStructure.map((d) => ({
-                name: d,
-                checked: ['APP', 'scripts', 'bin'].some(p => d === p)
-            }))
-        });
-        selectedFolders = copyFoldersResponse.selectedFolders;
+        if (rootFiles.length > 0) {
+            const filesResponse = await inquirer.prompt({
+                type: 'checkbox',
+                name: 'selectedFiles',
+                message: 'Select root files to include as boilerplate:',
+                loop: false,
+                theme: {
+                    icon: {
+                        checked: chalk.green('[x] '),
+                        unchecked: '[ ] ',
+                    }
+                },
+                choices: rootFiles.map(f => ({
+                    name: f,
+                    checked: ['.makerc', 'readme.md', 'README.md', '.gitattributes', '.gitignore', 'Makefile', 'makefile', 'package.json'].some(p => f.toLowerCase() === p.toLowerCase())
+                }))
+            });
+            selectedFiles = filesResponse.selectedFiles;
+        }
+        else {
+            selectedFiles = [];
+        }
+        if (rootDirs.length > 0) {
+            const foldersResponse = await inquirer.prompt({
+                type: 'checkbox',
+                name: 'selectedStructure',
+                message: 'Select folders to include in the template structure (skeleton):',
+                loop: false,
+                theme: {
+                    icon: {
+                        checked: chalk.green('[x] '),
+                        unchecked: '[ ] ',
+                    }
+                },
+                choices: rootDirs.map(d => ({
+                    name: d,
+                    checked: true // Include all in structure by default
+                }))
+            });
+            selectedStructure = foldersResponse.selectedStructure;
+        }
+        else {
+            selectedStructure = [];
+        }
+        if (selectedStructure.length > 0) {
+            const copyFoldersResponse = await inquirer.prompt({
+                type: 'checkbox',
+                name: 'selectedFolders',
+                message: 'Select folders to copy RECURSIVELY as boilerplate (with contents):',
+                loop: false,
+                theme: {
+                    icon: {
+                        checked: chalk.green('[x] '),
+                        unchecked: '[ ] ',
+                    }
+                },
+                choices: selectedStructure.map((d) => ({
+                    name: d,
+                    checked: ['APP', 'scripts', 'bin'].some(p => d === p)
+                }))
+            });
+            selectedFolders = copyFoldersResponse.selectedFolders;
+        }
+        else {
+            selectedFolders = [];
+        }
     }
     const copy_files = [];
     if (fileTemplateConfig.copy_files && Array.isArray(fileTemplateConfig.copy_files)) {

package/doc/testing.md

@@ -0,0 +1,48 @@
+# Testing pt-cli
+
+This guide explains how to run, write, and manage the test suite for `pt-cli`.
+
+## Overview
+
+The test suite uses Node.js's native test runner (`node:test`) and assertion library (`node:assert`). It is configured to run files ending with `.test.ts` in the `tests/` directory.
+
+## Running Tests
+
+### 1. Run the Entire Test Suite
+To execute all tests:
+```bash
+npm test
+```
+This runs the underlying command:
+```bash
+node --import tsx --test tests/**/*.test.ts
+```
+
+### 2. Run Individual Test Files
+To run a specific test suite, use `tsx`:
+```bash
+npx tsx --test tests/config.test.ts
+npx tsx --test tests/learn.test.ts
+npx tsx --test tests/substitute.test.ts
+```
+
+### 3. Run with Test Coverage
+To generate a test coverage report directly in the terminal:
+```bash
+node --experimental-test-coverage --import tsx --test tests/**/*.test.ts
+```
+
+---
+
+## Writing Tests
+
+When writing new tests, please adhere to these guidelines:
+
+1. **Use Native imports**: Import `test` from `node:test` and `assert` from `node:assert`. Do not use external testing frameworks (like Mocha, Jest, or Vitest).
+2. **ESM Imports**: Since this is an ESM (ECMAScript Modules) project, file imports within tests must use the `.js` extension (e.g., `import { learn } from '../src/commands/learnCommand.js';`).
+3. **Environment Isolation**: The configuration path relies on `process.env.HOME`. To prevent tests from polluting your user config directory, override the home directory before importing any CLI files:
+   ```typescript
+   const testHome = path.join(process.cwd(), '.test-home-custom');
+   process.env.HOME = testHome;
+   ```
+4. **Cleanup**: Always ensure temporary files, workspace directories, and test home directories are deleted after tests complete (e.g., in a `finally` block or `after` hook).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garyr/pt-cli",
-  "version": "0.30.1",
+  "version": "0.32.0",
   "description": "Project Template CLI - Learn structures and initialize projects",
   "main": "dist/index.js",
   "bin": {
@@ -12,6 +12,7 @@
     "start": "tsx src/index.ts",
     "dev": "tsx src/index.ts",
     "test": "node --import tsx --test tests/**/*.test.ts",
+    "test:sequential": "node --import tsx --test tests/config.test.ts && node --import tsx --test tests/init.test.ts && node --import tsx --test tests/learn.test.ts && node --import tsx --test tests/substitute.test.ts && node --import tsx --test tests/config-utils.test.ts",
     "prepublishOnly": "npm run build",
     "build:linux": "bun build ./src/index.ts --compile --target=bun-linux-x64   --outfile ../BUILD/pt-cli/pt-linux",
     "build:macos": "bun build ./src/index.ts --compile --target=bun-darwin-x64  --outfile ../BUILD/pt-cli/pt-macos",

package/src/commands/learnCommand.ts

@@ -262,59 +262,71 @@ export async function learn(sourcePath: string, updateTemplate: string | null =
     selectedStructure = rootDirs; // Include all folders in structure
     selectedFolders = rootDirs.filter(d => ['APP', 'scripts', 'bin'].some(p => d === p)); // Only copy specific ones recursively
   } else {
-    const filesResponse = await inquirer.prompt({
-      type: 'checkbox',
-      name: 'selectedFiles',
-      message: 'Select root files to include as boilerplate:',
-      loop: false,
-      theme: {
-        icon: {
-          checked: chalk.green('[x] '),
-          unchecked: '[ ] ',
-        }
-      },
-      choices: rootFiles.map(f => ({ 
-        name: f, 
-        checked: ['.makerc', 'readme.md', 'README.md', '.gitattributes', '.gitignore', 'Makefile', 'makefile', 'package.json'].some(p => f.toLowerCase() === p.toLowerCase()) 
-      }))
-    });
-    selectedFiles = filesResponse.selectedFiles;
-
-    const foldersResponse = await inquirer.prompt({
-      type: 'checkbox',
-      name: 'selectedStructure',
-      message: 'Select folders to include in the template structure (skeleton):',
-      loop: false,
-      theme: {
-        icon: {
-          checked: chalk.green('[x] '),
-          unchecked: '[ ] ',
-        }
-      },
-      choices: rootDirs.map(d => ({ 
-        name: d, 
-        checked: true // Include all in structure by default
-      }))
-    });
-    selectedStructure = foldersResponse.selectedStructure;
-
-    const copyFoldersResponse = await inquirer.prompt({
-      type: 'checkbox',
-      name: 'selectedFolders',
-      message: 'Select folders to copy RECURSIVELY as boilerplate (with contents):',
-      loop: false,
-      theme: {
-        icon: {
-          checked: chalk.green('[x] '),
-          unchecked: '[ ] ',
-        }
-      },
-      choices: selectedStructure.map((d: string) => ({ 
-        name: d, 
-        checked: ['APP', 'scripts', 'bin'].some(p => d === p) 
-      }))
-    });
-    selectedFolders = copyFoldersResponse.selectedFolders;
+    if (rootFiles.length > 0) {
+      const filesResponse = await inquirer.prompt({
+        type: 'checkbox',
+        name: 'selectedFiles',
+        message: 'Select root files to include as boilerplate:',
+        loop: false,
+        theme: {
+          icon: {
+            checked: chalk.green('[x] '),
+            unchecked: '[ ] ',
+          }
+        },
+        choices: rootFiles.map(f => ({ 
+          name: f, 
+          checked: ['.makerc', 'readme.md', 'README.md', '.gitattributes', '.gitignore', 'Makefile', 'makefile', 'package.json'].some(p => f.toLowerCase() === p.toLowerCase()) 
+        }))
+      });
+      selectedFiles = filesResponse.selectedFiles;
+    } else {
+      selectedFiles = [];
+    }
+
+    if (rootDirs.length > 0) {
+      const foldersResponse = await inquirer.prompt({
+        type: 'checkbox',
+        name: 'selectedStructure',
+        message: 'Select folders to include in the template structure (skeleton):',
+        loop: false,
+        theme: {
+          icon: {
+            checked: chalk.green('[x] '),
+            unchecked: '[ ] ',
+          }
+        },
+        choices: rootDirs.map(d => ({ 
+          name: d, 
+          checked: true // Include all in structure by default
+        }))
+      });
+      selectedStructure = foldersResponse.selectedStructure;
+    } else {
+      selectedStructure = [];
+    }
+
+    if (selectedStructure.length > 0) {
+      const copyFoldersResponse = await inquirer.prompt({
+        type: 'checkbox',
+        name: 'selectedFolders',
+        message: 'Select folders to copy RECURSIVELY as boilerplate (with contents):',
+        loop: false,
+        theme: {
+          icon: {
+            checked: chalk.green('[x] '),
+            unchecked: '[ ] ',
+          }
+        },
+        choices: selectedStructure.map((d: string) => ({ 
+          name: d, 
+          checked: ['APP', 'scripts', 'bin'].some(p => d === p) 
+        }))
+      });
+      selectedFolders = copyFoldersResponse.selectedFolders;
+    } else {
+      selectedFolders = [];
+    }
   }
 
   const copy_files: CopyFileEntry[] = [];