@garyr/pt-cli 0.26.0 → 0.27.0

package/README.md

@@ -18,7 +18,7 @@ graph LR
 
     %% Flow logic
     Existing -- Learn --> Engine
-    Config -- Read/Write --> Engine
+    Config <-- Read/Write --> Engine
     Engine -- Initialize --> RSA
     Engine -- Initialize --> RSB
     

package/dist/commands/learnCommand.js

@@ -3,10 +3,19 @@ import path from 'path';
 import inquirer from 'inquirer';
 import { loadConfig, saveConfig, getTemplateNames, shouldExclude, shouldIgnore, shouldExcludeFile, getDefaultPostConfig } from '../config.js';
 import chalk from 'chalk';
+import { downloadAndExtract } from '../remote.js';
 export async function learn(sourcePath, updateTemplate = null, options = {}) {
-    const resolvedPath = path.resolve(sourcePath);
+    let resolvedPath;
+    // Phase 1: Remote Check
+    if (sourcePath.startsWith('http')) {
+        console.log(chalk.cyan(`Downloading remote template from: ${sourcePath}...`));
+        resolvedPath = await downloadAndExtract(sourcePath);
+    }
+    else {
+        resolvedPath = path.resolve(sourcePath);
+    }
     if (!fs.existsSync(resolvedPath)) {
-        console.error(chalk.red(`Error: Path "${sourcePath}" does not exist.`));
+        console.error(chalk.red(`Error: Path "${resolvedPath}" does not exist.`));
         process.exit(1);
     }
     const isUpdate = !!updateTemplate;

package/dist/remote.js

@@ -0,0 +1,29 @@
+// src/remote.ts (New File)
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { Readable } from 'stream';
+import { finished } from 'stream/promises';
+import { extract } from 'tar'; // You'll need: npm install tar
+export async function downloadAndExtract(url) {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pt-template-'));
+    let downloadUrl = url;
+    // Convert GitHub/Gitea URLs to Zip/Tarball endpoints
+    if (url.includes('github.com')) {
+        downloadUrl = url.replace(/\/$/, '') + '/archive/refs/heads/main.tar.gz';
+    }
+    else if (url.includes('gitea')) {
+        downloadUrl = url.replace(/\/$/, '') + '/archive/main.tar.gz';
+    }
+    const response = await fetch(downloadUrl);
+    if (!response.ok)
+        throw new Error(`Failed to fetch ${downloadUrl}: ${response.statusText}`);
+    const dest = path.join(tempDir, 'template.tar.gz');
+    const fileStream = fs.createWriteStream(dest);
+    await finished(Readable.fromWeb(response.body).pipe(fileStream));
+    // Extract tarball
+    await extract({ file: dest, cwd: tempDir });
+    // Find the actual content folder (archives usually wrap content in a folder)
+    const dirs = fs.readdirSync(tempDir).filter(f => fs.statSync(path.join(tempDir, f)).isDirectory());
+    return path.join(tempDir, dirs[0]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garyr/pt-cli",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Project Template CLI - Learn structures and initialize projects",
   "main": "dist/index.js",
   "bin": {
@@ -27,16 +27,18 @@
     "url": "https://github.com/garyritchie/pt-cli"
   },
   "dependencies": {
+    "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "inquirer": "^12.3.0",
-    "yaml": "^2.6.1",
-    "chalk": "^5.3.0"
+    "tar": "^7.5.15",
+    "yaml": "^2.6.1"
   },
   "devDependencies": {
-    "typescript": "^5.6.0",
-    "@types/node": "^22.0.0",
     "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.0.0",
+    "@types/tar": "^6.1.13",
     "ts-node": "^10.9.2",
-    "tsx": "^4.21.0"
+    "tsx": "^4.21.0",
+    "typescript": "^5.6.0"
   }
-}
+}

package/src/commands/learnCommand.ts

@@ -3,6 +3,7 @@ import path from 'path';
 import inquirer from 'inquirer';
 import { loadConfig, saveConfig, FolderNode, TemplateConfig, getTemplateNames, shouldExclude, shouldIgnore, shouldExcludeFile, PostCopyFile, TemplateVariable, CopyFileEntry, PostConfigTask, getDefaultPostConfig } from '../config.js';
 import chalk from 'chalk';
+import { downloadAndExtract } from '../remote.js';
 
 export interface LearnOptions {
   ignore?: string;
@@ -12,11 +13,20 @@ export interface LearnOptions {
   json?: boolean;
 }
 
+
 export async function learn(sourcePath: string, updateTemplate: string | null = null, options: LearnOptions = {}): Promise<void> {
-  const resolvedPath = path.resolve(sourcePath);
+  let resolvedPath: string;
+
+  // Phase 1: Remote Check
+  if (sourcePath.startsWith('http')) {
+    console.log(chalk.cyan(`Downloading remote template from: ${sourcePath}...`));
+    resolvedPath = await downloadAndExtract(sourcePath);
+  } else {
+    resolvedPath = path.resolve(sourcePath);
+  }
   
   if (!fs.existsSync(resolvedPath)) {
-    console.error(chalk.red(`Error: Path "${sourcePath}" does not exist.`));
+    console.error(chalk.red(`Error: Path "${resolvedPath}" does not exist.`));
     process.exit(1);
   }
 

package/src/remote.ts

@@ -0,0 +1,33 @@
+// src/remote.ts (New File)
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { Readable } from 'stream';
+import { finished } from 'stream/promises';
+import { extract } from 'tar'; // You'll need: npm install tar
+
+export async function downloadAndExtract(url: string): Promise<string> {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pt-template-'));
+    let downloadUrl = url;
+
+    // Convert GitHub/Gitea URLs to Zip/Tarball endpoints
+    if (url.includes('github.com')) {
+        downloadUrl = url.replace(/\/$/, '') + '/archive/refs/heads/main.tar.gz';
+    } else if (url.includes('gitea')) {
+        downloadUrl = url.replace(/\/$/, '') + '/archive/main.tar.gz';
+    }
+
+    const response = await fetch(downloadUrl);
+    if (!response.ok) throw new Error(`Failed to fetch ${downloadUrl}: ${response.statusText}`);
+
+    const dest = path.join(tempDir, 'template.tar.gz');
+    const fileStream = fs.createWriteStream(dest);
+    await finished(Readable.fromWeb(response.body as any).pipe(fileStream));
+
+    // Extract tarball
+    await extract({ file: dest, cwd: tempDir });
+    
+    // Find the actual content folder (archives usually wrap content in a folder)
+    const dirs = fs.readdirSync(tempDir).filter(f => fs.statSync(path.join(tempDir, f)).isDirectory());
+    return path.join(tempDir, dirs[0]); 
+}