wordpress-agent-kit 0.2.1 → 0.2.2

package/dist/commands/sync-skills.js

@@ -1,70 +1,43 @@
 import { Command } from 'commander';
-import fs from 'node:fs';
-import path from 'node:path';
-import { run } from '../utils/run.js';
-const OFFICIAL_SKILLS_REPO_URL = 'https://github.com/WordPress/agent-skills.git';
-const DEFAULT_SKILLS_REF = 'trunk';
+import { syncSkillsApi } from '../lib/api.js';
+import { OutputFormatter } from '../utils/output.js';
+function isDryRunResult(result) {
+    return result.success && 'wouldExecute' in (result.data || {});
+}
+function isRegularResult(result) {
+    return result.success && !('wouldExecute' in (result.data || {}));
+}
 /**
  * Command to sync skills from the official WordPress agent-skills repository.
- * Can checkout a specific branch or tag.
+ * Supports --json, --ndjson, --dry-run flags.
  */
 export const syncSkillsCommand = new Command('sync-skills')
-    .description('Sync skills from the official WordPress agent-skills repository')
-    .argument('[ref]', 'Branch or tag to checkout', DEFAULT_SKILLS_REF)
-    .action((refPassed) => {
-    // Check for custom URL args - simplistic check
-    if (/^(https?:\/\/|git@)/i.test(refPassed)) {
-        console.error('Custom skills repository URLs are not supported. This script syncs from the official WordPress/agent-skills repo only.');
-        process.exit(2);
+    .description('Sync skills from the official WordPress/agent-skills repository')
+    .argument('[ref]', 'Branch or tag to checkout', 'trunk')
+    .option('--ref <ref>', 'Branch or tag to checkout (alias for argument)')
+    .action(async (refArg, options, command) => {
+    const globalOpts = command.parent?.opts() || {};
+    const ref = options.ref || refArg;
+    const result = await syncSkillsApi({
+        targetDir: process.cwd(),
+        ref,
+        dryRun: globalOpts.dryRun,
+    });
+    if (globalOpts.json || globalOpts.ndjson || globalOpts.quiet) {
+        process.exit(OutputFormatter.getExitCode(result));
     }
-    // Check if refPassed might contain URL (same check as above) or empty string
-    const ref = refPassed || DEFAULT_SKILLS_REF;
-    const repoRoot = process.cwd();
-    const submodulePath = path.join('vendor', 'wp-agent-skills');
-    const vendorSkillsDir = path.join(repoRoot, submodulePath);
-    const submoduleGitDir = path.join(vendorSkillsDir, '.git');
-    // Clone or update the skills repo (not as a submodule since it's gitignored)
-    if (!fs.existsSync(submoduleGitDir)) {
-        fs.mkdirSync(path.join(repoRoot, 'vendor'), { recursive: true });
-        console.log(`Cloning ${OFFICIAL_SKILLS_REPO_URL} into ${submodulePath}...`);
-        run('git', ['clone', OFFICIAL_SKILLS_REPO_URL, submodulePath], repoRoot);
+    if (isRegularResult(result)) {
+        const data = result.data;
+        console.log(`✓ Synced ${data.skillsSynced} skills from WordPress/agent-skills@${ref}`);
+        console.log(`  Method: ${data.method}`);
+        console.log(`  Duration: ${data.durationMs}ms`);
     }
-    else {
-        console.log(`Updating existing skills repo at ${submodulePath}...`);
-        run('git', ['fetch', '--all', '--tags'], vendorSkillsDir);
-    }
-    // Checkout the specified ref
-    if (ref) {
-        run('git', ['checkout', ref], vendorSkillsDir);
-        run('git', ['pull', 'origin', ref], vendorSkillsDir);
-    }
-    const targetSkills = path.join(repoRoot, '.github', 'skills');
-    const upstreamBuildScript = path.join(vendorSkillsDir, 'shared', 'scripts', 'skillpack-build.mjs');
-    const upstreamInstallScript = path.join(vendorSkillsDir, 'shared', 'scripts', 'skillpack-install.mjs');
-    if (fs.existsSync(upstreamBuildScript) && fs.existsSync(upstreamInstallScript)) {
-        if (fs.existsSync(targetSkills)) {
-            fs.rmSync(targetSkills, { recursive: true, force: true });
-        }
-        fs.mkdirSync(path.join(repoRoot, '.github'), { recursive: true });
-        run('node', ['shared/scripts/skillpack-build.mjs', '--clean', '--targets=vscode'], vendorSkillsDir);
-        run('node', ['shared/scripts/skillpack-install.mjs', `--dest=${repoRoot}`, '--targets=vscode', '--from=dist', '--mode=replace'], vendorSkillsDir);
-        console.log(`Synced skills into: ${targetSkills}`);
-        console.log(`Skills source: ${OFFICIAL_SKILLS_REPO_URL}${ref ? ` @ ${ref}` : ''}`);
-        console.log('Sync method: upstream skillpack-build.mjs + skillpack-install.mjs');
-        // No process.exit here, let commander handle exit or fallthrough unless explicit stop
-        return;
+    else if (isDryRunResult(result)) {
+        // Dry-run result
+        console.log(`✓ Dry-run: ${result.data.summary.skillsSynced} skills would be synced`);
     }
-    const sourceSkills = path.join(vendorSkillsDir, '.github', 'skills');
-    if (!fs.existsSync(sourceSkills)) {
-        console.error(`Could not find upstream skills directory at: ${sourceSkills}`);
-        process.exit(1);
-    }
-    if (fs.existsSync(targetSkills)) {
-        fs.rmSync(targetSkills, { recursive: true, force: true });
+    else {
+        console.error(`✗ Sync failed: ${result.error?.message}`);
     }
-    fs.mkdirSync(path.join(repoRoot, '.github'), { recursive: true });
-    fs.cpSync(sourceSkills, targetSkills, { recursive: true });
-    console.log(`Synced skills into: ${targetSkills}`);
-    console.log(`Skills source: ${OFFICIAL_SKILLS_REPO_URL}${ref ? ` @ ${ref}` : ''}`);
-    console.log('Sync method: fallback direct copy from .github/skills');
+    process.exit(result.success ? 0 : 1);
 });

package/dist/commands/upgrade.js

@@ -0,0 +1,182 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { installKitApi } from '../lib/api.js';
+import { PLATFORM_FOLDERS } from '../lib/installer.js';
+import { ExitCode } from '../utils/exit-codes.js';
+import { OutputFormatter, createFormatter } from '../utils/output.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
+function isDryRunResult(result) {
+    return result.success && 'wouldExecute' in (result.data || {});
+}
+function isRegularResult(result) {
+    return result.success && !('wouldExecute' in (result.data || {}));
+}
+/** Current package version */
+const CURRENT_VERSION = (() => {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
+/** Version detection from installed kit */
+function detectInstalledVersion(targetDir) {
+    // Check AGENTS.md for version marker
+    const agentsPath = path.join(targetDir, 'AGENTS.md');
+    if (fs.existsSync(agentsPath)) {
+        const content = fs.readFileSync(agentsPath, 'utf-8');
+        const match = content.match(/wp-agent-kit[:\s]+v?(\d+\.\d+\.\d+)/i);
+        if (match)
+            return match[1];
+    }
+    // Check package.json if exists in target
+    const pkgPath = path.join(targetDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            if (pkg.devDependencies?.['wordpress-agent-kit']) {
+                return pkg.devDependencies['wordpress-agent-kit'].replace(/^[\^~]/, '');
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+/** Detect which platforms are installed */
+function detectInstalledPlatforms(targetDir) {
+    const platforms = ['github', 'cursor', 'claude', 'agent', 'pi'];
+    return platforms.filter((p) => fs.existsSync(path.join(targetDir, PLATFORM_FOLDERS[p])));
+}
+/** Compare semantic versions */
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] !== pb[i])
+            return pa[i] - pb[i];
+    }
+    return 0;
+}
+/** Upgrade command */
+export const upgradeCommand = new Command('upgrade')
+    .description('Upgrade existing WordPress Agent Kit installation to latest version')
+    .argument('[dir]', 'Target directory', process.cwd())
+    .option('--platform <platform>', 'Specific platform to upgrade (github, cursor, claude, agent, pi, all)', 'all')
+    .option('--force', 'Overwrite local modifications', false)
+    .option('--check-only', 'Only check for updates, do not apply', false)
+    .option('--from-version <version>', 'Override detected current version')
+    .action(async (dir, options, command) => {
+    const globalOpts = command.parent?.opts() || {};
+    const targetDir = path.resolve(dir);
+    const formatter = createFormatter(globalOpts, 'upgrade', CURRENT_VERSION);
+    if (!fs.existsSync(targetDir)) {
+        const result = formatter.fail({
+            code: 'NOT_FOUND',
+            message: `Target directory does not exist: ${targetDir}`,
+            exitCode: ExitCode.NOT_FOUND,
+        });
+        process.exit(OutputFormatter.getExitCode(result));
+    }
+    // Detect installed platforms
+    const platformsToCheck = options.platform === 'all'
+        ? detectInstalledPlatforms(targetDir)
+        : [options.platform];
+    if (platformsToCheck.length === 0) {
+        const result = formatter.fail({
+            code: 'NOT_INSTALLED',
+            message: `No WordPress Agent Kit installation found in ${targetDir}`,
+            exitCode: ExitCode.NOT_FOUND,
+        });
+        process.exit(OutputFormatter.getExitCode(result));
+    }
+    // Detect or override version
+    let currentVersion = options.fromVersion;
+    if (!currentVersion) {
+        currentVersion = detectInstalledVersion(targetDir);
+    }
+    currentVersion = currentVersion || 'unknown';
+    const hasUpdate = currentVersion !== 'unknown' && compareVersions(CURRENT_VERSION, currentVersion) > 0;
+    const upgradeInfo = {
+        targetDir,
+        currentVersion,
+        latestVersion: CURRENT_VERSION,
+        hasUpdate,
+        platforms: platformsToCheck,
+        checkOnly: options.checkOnly,
+    };
+    if (globalOpts.json || globalOpts.quiet) {
+        const result = formatter.success(upgradeInfo);
+        process.exit(OutputFormatter.getExitCode(result));
+    }
+    // Human output
+    console.log('WordPress Agent Kit Upgrade Check');
+    console.log(`  Target: ${targetDir}`);
+    console.log(`  Current: ${currentVersion}`);
+    console.log(`  Latest:  ${CURRENT_VERSION}`);
+    console.log(`  Platforms: ${platformsToCheck.join(', ')}`);
+    if (!hasUpdate && currentVersion !== 'unknown') {
+        console.log('\n✓ Already up to date');
+        process.exit(0);
+    }
+    if (currentVersion === 'unknown') {
+        console.log('\n⚠ Could not detect current version');
+    }
+    else {
+        console.log('\n✓ Update available');
+    }
+    if (options.checkOnly) {
+        console.log('\nDry run (--check-only): no changes made');
+        process.exit(0);
+    }
+    // Confirm upgrade in interactive mode
+    if (!globalOpts.json && !globalOpts.quiet) {
+        if (!options.force) {
+            console.log('\nUse --force to apply upgrade, or --check-only to preview');
+            process.exit(0);
+        }
+    }
+    // Perform upgrade for each platform
+    const results = [];
+    for (const platform of platformsToCheck) {
+        const installResult = await installKitApi({
+            targetDir,
+            platform,
+            force: options.force,
+            dryRun: globalOpts.dryRun,
+        });
+        results.push({ platform, ...installResult });
+    }
+    const successCount = results.filter((r) => r.success).length;
+    const totalFiles = results.reduce((sum, r) => {
+        if (!r.success)
+            return sum;
+        if (isRegularResult(r)) {
+            return sum + (r.data.filesCreated.length || 0);
+        }
+        if (isDryRunResult(r)) {
+            // Dry-run - summary has filesCreated
+            return sum + (r.data.summary.filesCreated.length || 0);
+        }
+        return sum;
+    }, 0);
+    console.log(`\n✓ Upgraded ${successCount}/${results.length} platform(s)`);
+    console.log(`  Files updated: ${totalFiles}`);
+    console.log(`  Version: ${currentVersion} → ${CURRENT_VERSION}`);
+    const failed = results.filter((r) => !r.success);
+    if (failed.length > 0) {
+        console.error('\nFailures:');
+        for (const f of failed) {
+            console.error(`  ${f.platform}: ${f.error?.message}`);
+        }
+        process.exit(1);
+    }
+    process.exit(0);
+});