@paw-workflow/cli 0.0.1

package/lib/commands/upgrade.js

@@ -0,0 +1,119 @@
+import { spawn, execSync } from 'child_process';
+import { readManifest } from '../manifest.js';
+import { getLatestVersion } from '../registry.js';
+
+function isGlobalInstall() {
+  try {
+    // Check if this script is running from global node_modules
+    const globalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim();
+    return process.argv[1].startsWith(globalRoot);
+  } catch {
+    return false;
+  }
+}
+
+function runCommand(command, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: 'inherit',
+      shell: true,
+    });
+    
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Command failed with exit code ${code}`));
+      }
+    });
+    
+    child.on('error', (err) => {
+      reject(new Error(`Failed to run command: ${err.message}`));
+    });
+  });
+}
+
+export async function upgradeCommand(_flags = {}) {
+  const manifest = readManifest();
+  
+  if (!manifest) {
+    console.log('PAW is not installed. Run "paw install copilot" first.');
+    return;
+  }
+  
+  const currentVersion = manifest.version;
+  const target = manifest.target;
+  
+  console.log(`Installed version: ${currentVersion}`);
+  console.log(`Target: ${target}`);
+  console.log('Checking npm registry for updates...\n');
+  
+  let latestVersion;
+  try {
+    latestVersion = await getLatestVersion();
+  } catch (error) {
+    console.error(`Failed to check for updates: ${error.message}`);
+    console.log('Please check your network connection and try again.');
+    return;
+  }
+  
+  if (!latestVersion) {
+    console.log('Could not determine latest version from npm registry.');
+    return;
+  }
+  
+  console.log(`Latest version: ${latestVersion}`);
+  
+  if (latestVersion === currentVersion) {
+    console.log('\n✓ You are already on the latest version.');
+    return;
+  }
+  
+  // Compare versions (simple comparison, assumes semver-like format)
+  const current = currentVersion.split('.').map(Number);
+  const latest = latestVersion.split('.').map(Number);
+  
+  let isNewer = false;
+  for (let i = 0; i < 3; i++) {
+    if (latest[i] > current[i]) {
+      isNewer = true;
+      break;
+    }
+    if (latest[i] < current[i]) {
+      break;
+    }
+  }
+  
+  if (!isNewer) {
+    console.log('\n✓ You are already on the latest version.');
+    return;
+  }
+  
+  console.log(`\n→ Upgrading: ${currentVersion} → ${latestVersion}\n`);
+  
+  const isGlobal = isGlobalInstall();
+  
+  if (isGlobal) {
+    // Upgrade global CLI installation first
+    console.log('Step 1/2: Upgrading @paw-workflow/cli globally...\n');
+    await runCommand('npm', ['install', '-g', `@paw-workflow/cli@${latestVersion}`]);
+    
+    // Then reinstall agents/skills using the new CLI
+    console.log('\nStep 2/2: Installing PAW agents and skills to', target, '...\n');
+    await runCommand('paw', ['install', target, '--force']);
+  } else {
+    // Running via npx or local - just use npx to get latest
+    console.log('Downloading @paw-workflow/cli@' + latestVersion + ' and installing to', target, '...\n');
+    await runCommand('npx', [
+      `@paw-workflow/cli@${latestVersion}`,
+      'install',
+      target,
+      '--force',
+    ]);
+  }
+  
+  console.log('\n' + '─'.repeat(50));
+  console.log('✓ Upgrade complete!');
+  console.log(`  CLI version: ${latestVersion}`);
+  console.log(`  Agents and skills installed to: ${target}`);
+}

package/lib/manifest.js

@@ -0,0 +1,42 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from 'fs';
+import { getManifestPath, getManifestDir } from './paths.js';
+
+export function readManifest() {
+  const manifestPath = getManifestPath();
+  if (!existsSync(manifestPath)) {
+    return null;
+  }
+  try {
+    const content = readFileSync(manifestPath, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+export function writeManifest(manifest) {
+  const manifestDir = getManifestDir();
+  const manifestPath = getManifestPath();
+  
+  if (!existsSync(manifestDir)) {
+    mkdirSync(manifestDir, { recursive: true });
+  }
+  
+  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+}
+
+export function createManifest(version, target, files) {
+  return {
+    version,
+    installedAt: new Date().toISOString(),
+    target,
+    files,
+  };
+}
+
+export function deleteManifest() {
+  const manifestPath = getManifestPath();
+  if (existsSync(manifestPath)) {
+    unlinkSync(manifestPath);
+  }
+}

package/lib/paths.js

@@ -0,0 +1,42 @@
+import { homedir } from 'os';
+import { join } from 'path';
+
+export function getHomeDir() {
+  return homedir();
+}
+
+export function getCopilotDir() {
+  return join(getHomeDir(), '.copilot');
+}
+
+export function getCopilotAgentsDir() {
+  return join(getCopilotDir(), 'agents');
+}
+
+export function getCopilotSkillsDir() {
+  return join(getCopilotDir(), 'skills');
+}
+
+export function getPawDir() {
+  return join(getHomeDir(), '.paw');
+}
+
+export function getManifestDir() {
+  return join(getPawDir(), 'copilot-cli');
+}
+
+export function getManifestPath() {
+  return join(getManifestDir(), 'manifest.json');
+}
+
+export function getDistDir() {
+  return join(import.meta.dirname, '..', 'dist');
+}
+
+export function getDistAgentsDir() {
+  return join(getDistDir(), 'agents');
+}
+
+export function getDistSkillsDir() {
+  return join(getDistDir(), 'skills');
+}

package/lib/registry.js

@@ -0,0 +1,41 @@
+import { get } from 'https';
+
+const REGISTRY_URL = 'https://registry.npmjs.org/@paw-workflow/cli';
+const TIMEOUT_MS = 10000;
+
+export async function getLatestVersion() {
+  return new Promise((resolve, reject) => {
+    const req = get(REGISTRY_URL, { timeout: TIMEOUT_MS }, (res) => {
+      if (res.statusCode === 404) {
+        // Package not published yet
+        resolve(null);
+        return;
+      }
+      
+      if (res.statusCode !== 200) {
+        reject(new Error(`HTTP ${res.statusCode}`));
+        return;
+      }
+      
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        try {
+          const pkg = JSON.parse(data);
+          resolve(pkg['dist-tags']?.latest || null);
+        } catch {
+          reject(new Error('Invalid response from registry'));
+        }
+      });
+    });
+    
+    req.on('error', (err) => {
+      reject(new Error(`Network error: ${err.message}`));
+    });
+    
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error('Request timed out'));
+    });
+  });
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@paw-workflow/cli",
+  "version": "0.0.1",
+  "description": "CLI installer for Phased Agent Workflow (PAW) agents and skills",
+  "type": "module",
+  "bin": {
+    "paw": "bin/paw.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "node scripts/build-dist.js",
+    "test": "node --test test/*.test.js",
+    "lint": "eslint .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "paw",
+    "copilot",
+    "agent",
+    "workflow",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lossyrob/phased-agent-workflow.git",
+    "directory": "cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.0.0"
+  }
+}