@garyr/pt-cli 0.25.2 → 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
     
@@ -55,12 +55,12 @@ graph LR
 ### Installation
 
 ```bash
-# Clone this repository
+npm i @garyr/pt-cli
+
+# ...or clone this repository, then:
 cd pt-cli
 npm install
 npm run build
-
-# Link for global use
 npm link
 ```
 

package/dist/commands/defaultPostConfigCommand.js

@@ -0,0 +1,26 @@
+import fs from 'fs';
+import { loadConfig, saveConfig } from '../config.js';
+export function defaultPostConfigCommand(options = {}) {
+    const config = loadConfig();
+    if (options.set) {
+        if (options.json) {
+            try {
+                const data = options.json.startsWith('{') || options.json.startsWith('[')
+                    ? JSON.parse(options.json)
+                    : JSON.parse(fs.readFileSync(options.json, 'utf-8'));
+                config.default_post_config = Array.isArray(data) ? data : [];
+                saveConfig(config);
+                console.log('Default post-config updated via JSON.');
+            }
+            catch (e) {
+                const error = e;
+                console.error('Failed to parse JSON for default post-config:', error.message);
+            }
+            return;
+        }
+        console.error('You must provide --json <data> to set the default post-config array.');
+    }
+    else {
+        console.log('Current default post-config tasks:', config.default_post_config || []);
+    }
+}

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/index.js

@@ -8,6 +8,7 @@ import { ignoreCommand } from './commands/ignoreCommand.js';
 import { variablesCommand } from './commands/variablesCommand.js';
 import { addCommand } from './commands/addCommand.js';
 import { removeCommand } from './commands/removeCommand.js';
+import { defaultPostConfigCommand } from './commands/defaultPostConfigCommand.js';
 import pkg from '../package.json' with { type: 'json' };
 const program = new Command();
 program
@@ -61,6 +62,12 @@ program
     .option('--json <data>', 'Set variables via JSON string or file')
     .option('--delete <key>', 'Delete a specific global variable')
     .action(variablesCommand);
+program
+    .command('default-post-config')
+    .description('View or set default post-config tasks')
+    .option('--set', 'Set the default post-config tasks via JSON')
+    .option('--json <data>', 'JSON string or file containing tasks array')
+    .action(defaultPostConfigCommand);
 program
     .command('add <name> [json]')
     .description('Import/add a template from a JSON string or file')

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/doc/configuration.md

@@ -146,9 +146,14 @@ Each default task supports the same fields as template post-config:
 - **`pt learn --yes`**: all applicable default tasks are added automatically to the new template's `post_config`.
 - **Interactive mode (`pt learn`)**: applicable default tasks are shown in a checkbox group. Default tasks default to checked; `checked: false` overrides this.
 
-### Viewing
+### Management
 
-Default tasks cannot be added via `pt add` or `pt learn` — they must be edited directly in `~/.pt/config.yaml` or viewed with `pt config`.
+You can view current default tasks using `pt config` or `pt default-post-config`.
+To update default tasks programmatically or via CLI, use the `pt default-post-config` command:
+- `pt default-post-config`: List current default post-config tasks.
+- `pt default-post-config --set --json '...'`: Replace the default post-config tasks list via a JSON string or file.
+
+Alternatively, you can edit `~/.pt/config.yaml` directly.
 
 ## Global Variables
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garyr/pt-cli",
-  "version": "0.25.2",
+  "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/skills/agency-pt-operator/SKILL.md

@@ -42,7 +42,7 @@ Default post-config tasks are stored in `~/.pt/config.yaml` under `default_post_
 
 Tasks with `checked: false` stay unchecked by default in interactive mode. In `pt learn --yes` mode, **all applicable** default tasks are included.
 
-Use `pt config` to view currently configured default tasks. To add default tasks, edit `~/.pt/config.yaml` directly or use `pt add` for template management (config is YAML-only at this time).
+Use `pt config` to view currently configured default tasks. To update default tasks, you can use `pt default-post-config --set --json '...'` to apply a new JSON array of tasks. Alternatively, you can edit `~/.pt/config.yaml` directly.
 
 ## Global Variables
 

package/src/commands/defaultPostConfigCommand.ts

@@ -0,0 +1,32 @@
+import fs from 'fs';
+import { loadConfig, saveConfig, PostConfigTask } from '../config.js';
+
+export interface DefaultPostConfigOptions {
+  set?: boolean;
+  json?: string;
+}
+
+export function defaultPostConfigCommand(options: DefaultPostConfigOptions = {}) {
+  const config = loadConfig();
+  
+  if (options.set) {
+    if (options.json) {
+      try {
+        const data = options.json.startsWith('{') || options.json.startsWith('[') 
+          ? JSON.parse(options.json) 
+          : JSON.parse(fs.readFileSync(options.json, 'utf-8'));
+        config.default_post_config = Array.isArray(data) ? data : [];
+        saveConfig(config);
+        console.log('Default post-config updated via JSON.');
+      } catch (e) {
+        const error = e as Error;
+        console.error('Failed to parse JSON for default post-config:', error.message);
+      }
+      return;
+    }
+
+    console.error('You must provide --json <data> to set the default post-config array.');
+  } else {
+    console.log('Current default post-config tasks:', config.default_post_config || []);
+  }
+}

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/index.ts

@@ -13,6 +13,7 @@ import { ignoreCommand } from './commands/ignoreCommand.js';
 import { variablesCommand } from './commands/variablesCommand.js';
 import { addCommand } from './commands/addCommand.js';
 import { removeCommand } from './commands/removeCommand.js';
+import { defaultPostConfigCommand } from './commands/defaultPostConfigCommand.js';
 
 import pkg from '../package.json' with { type: 'json' };
 
@@ -76,6 +77,13 @@ program
   .option('--delete <key>', 'Delete a specific global variable')
   .action(variablesCommand);
 
+program
+  .command('default-post-config')
+  .description('View or set default post-config tasks')
+  .option('--set', 'Set the default post-config tasks via JSON')
+  .option('--json <data>', 'JSON string or file containing tasks array')
+  .action(defaultPostConfigCommand);
+
 program
   .command('add <name> [json]')
   .description('Import/add a template from a JSON string or file')

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]); 
+}