@loopress/cli 0.3.0 → 0.5.0

package/dist/commands/init.js

@@ -0,0 +1,73 @@
+import { confirm, input, select } from '@inquirer/prompts';
+import { Command } from '@oclif/core';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { configManager } from '../config/project-config.manager.js';
+import { writeLocalConfig } from '../utils/loopress-config.js';
+export default class Init extends Command {
+    static description = 'Initialize a loopress.json config file in the current directory';
+    static examples = ['$ lps init'];
+    async run() {
+        await this.parse(Init);
+        const configPath = join(process.cwd(), 'loopress.json');
+        if (existsSync(configPath)) {
+            const overwrite = await confirm({
+                default: false,
+                message: 'loopress.json already exists. Overwrite?',
+            });
+            if (!overwrite) {
+                this.log('Aborted.');
+                return;
+            }
+        }
+        const projects = configManager.listProjects();
+        let projectId;
+        if (projects.length > 0) {
+            const choices = [
+                ...projects.map((p) => ({ name: p.name, value: p.name })),
+                { name: 'Enter a project ID manually', value: '__manual__' },
+            ];
+            const choice = await select({
+                choices,
+                message: 'WordPress project',
+            });
+            projectId = choice === '__manual__' ? (await input({
+                message: 'Project ID',
+                validate: (value) => (value.trim().length > 0 ? true : 'Project ID cannot be empty'),
+            })) : choice;
+        }
+        else {
+            this.log('No projects configured yet. Run `lps project config` to add one first.');
+            projectId = await input({
+                message: 'Project ID',
+                validate: (value) => (value.trim().length > 0 ? true : 'Project ID cannot be empty'),
+            });
+        }
+        const snippetPlugin = await select({
+            choices: [
+                { name: 'WPCode', value: 'wpcode' },
+                { name: 'Code Snippets', value: 'code-snippets' },
+            ],
+            message: 'Snippet plugin',
+        });
+        const rootDir = await input({
+            default: '.',
+            message: 'Root directory',
+        });
+        const snippetsDir = await input({
+            default: 'snippets',
+            message: 'Snippets directory (relative to root)',
+        });
+        const config = {
+            projectId,
+            rootDir,
+            snippetPlugin: snippetPlugin,
+            snippetsDir,
+        };
+        await writeLocalConfig(config);
+        this.log(`\n✓ loopress.json created`);
+        this.log(`  Project:  ${projectId}`);
+        this.log(`  Plugin:   ${snippetPlugin}`);
+        this.log(`  Snippets: ${join(rootDir, snippetsDir)}`);
+    }
+}

package/dist/commands/{styles → plugin}/pull.d.ts

@@ -3,7 +3,7 @@ export default class Pull extends LoopressCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        dryRun: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/plugin/pull.js

@@ -0,0 +1,48 @@
+import { Flags } from '@oclif/core';
+import got from 'got';
+import { LoopressCommand } from '../../lib/base.js';
+import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.js';
+import { mergePluginManifest } from '../../utils/plugins.js';
+export default class Pull extends LoopressCommand {
+    static description = 'Pull installed plugins from WordPress into loopress.json';
+    static examples = ['$ lps plugins pull', '$ lps plugins pull --dry-run'];
+    static flags = {
+        ...LoopressCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would be written without making changes' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Pull);
+        const dryRun = flags['dry-run'];
+        const { url } = this.siteConfig;
+        this.log(`Pulling plugins from ${url}`);
+        const headers = await this.buildAuthHeaders();
+        const installed = await got.get(`${url}/wp-json/loopress/v1/plugins`, { headers }).json();
+        const incoming = Object.fromEntries(installed.map((p) => [p.slug, p.version]));
+        const localConfig = await readLocalConfig();
+        const { added, merged, updated } = mergePluginManifest(localConfig.plugins ?? {}, incoming);
+        if (dryRun) {
+            this.log(`[dry-run] Would write ${Object.keys(merged).length} plugins to loopress.json`);
+            if (added.length > 0)
+                this.log(`  + ${added.join(', ')}`);
+            if (updated.length > 0) {
+                for (const u of updated)
+                    this.log(`  ~ ${u.slug} (${u.from} → ${u.to})`);
+            }
+            return;
+        }
+        await writeLocalConfig({ ...localConfig, plugins: merged });
+        this.log(`Wrote ${Object.keys(merged).length} plugins to loopress.json`);
+        if (added.length > 0)
+            this.log(`  + Added: ${added.join(', ')}`);
+        for (const u of updated)
+            this.log(`  ~ Updated: ${u.slug} ${u.from} → ${u.to}`);
+        if (Object.keys(merged).length > 0) {
+            await got
+                .post(`${url}/wp-json/loopress/v1/plugins/auto-updates/disable`, {
+                headers,
+                json: { slugs: Object.keys(merged) },
+            })
+                .json();
+        }
+    }
+}

package/dist/commands/{styles → plugin}/push.d.ts

@@ -1,13 +1,13 @@
-import { LoopressCommand } from '../../lib/base.js';
-export default class Push extends LoopressCommand {
+import { PushCommand } from '../../lib/push-command.js';
+export default class Push extends PushCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        dryRun: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
-    private readOrFetchGlobalStyles;
+    private activatePlugin;
 }

package/dist/commands/plugin/push.js

@@ -0,0 +1,113 @@
+import { confirm } from '@inquirer/prompts';
+import { Flags } from '@oclif/core';
+import got from 'got';
+import { PushCommand } from '../../lib/push-command.js';
+import { readLocalConfig } from '../../utils/loopress-config.js';
+import { diffPlugins } from '../../utils/plugins.js';
+export default class Push extends PushCommand {
+    static description = 'Sync plugins on WordPress to match loopress.json';
+    static examples = ['$ lps plugins push', '$ lps plugins push --dry-run'];
+    static flags = {
+        ...PushCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would change without making changes' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Push);
+        const dryRun = flags['dry-run'];
+        this.dryRun = dryRun;
+        const { url } = this.siteConfig;
+        const localConfig = await readLocalConfig();
+        const manifest = localConfig.plugins;
+        if (!manifest || Object.keys(manifest).length === 0) {
+            this.error('No plugins found in loopress.json. Run `lps plugins pull` first.');
+        }
+        this.log(`Pushing plugins to ${url}`);
+        const headers = await this.buildAuthHeaders();
+        const installed = await got.get(`${url}/wp-json/loopress/v1/plugins`, { headers }).json();
+        const { drifted, toActivate, toInstall } = diffPlugins(manifest, installed);
+        if (toInstall.length === 0 && toActivate.length === 0 && drifted.length === 0) {
+            this.log('Everything is already in sync.');
+            return;
+        }
+        if (toInstall.length > 0) {
+            this.log(`\nTo install (${toInstall.length}):`);
+            for (const a of toInstall)
+                this.log(`  + ${a.slug} @ ${a.targetVersion}`);
+        }
+        if (toActivate.length > 0) {
+            this.log(`\nTo activate (${toActivate.length}):`);
+            for (const a of toActivate)
+                this.log(`  ↑ ${a.slug}`);
+        }
+        if (drifted.length > 0) {
+            this.log(`\nVersion mismatch (${drifted.length}):`);
+            for (const a of drifted) {
+                this.log(`  ~ ${a.slug}: site has ${a.currentVersion}, manifest wants ${a.targetVersion}`);
+            }
+        }
+        if (dryRun)
+            return;
+        // Install missing plugins and activate them.
+        for (const action of toInstall) {
+            this.log(`\nInstalling ${action.slug} @ ${action.targetVersion}...`);
+            try {
+                const result = await got
+                    .post(`${url}/wp-json/loopress/v1/plugins/install`, {
+                    headers,
+                    json: { slug: action.slug, version: action.targetVersion },
+                })
+                    .json();
+                this.log(`  ✓ ${result.message}`);
+            }
+            catch (error) {
+                this.warn(`  Failed to install ${action.slug}: ${error.message}`);
+                continue;
+            }
+            await this.activatePlugin(url, headers, action.slug);
+        }
+        // Activate installed-but-inactive plugins without prompting.
+        for (const action of toActivate) {
+            this.log(`\nActivating ${action.slug}...`);
+            await this.activatePlugin(url, headers, action.slug);
+        }
+        // Prompt per drifted plugin before syncing.
+        for (const action of drifted) {
+            this.log('');
+            const proceed = await confirm({
+                default: false,
+                message: `${action.slug} is at ${action.currentVersion} on the site but manifest wants ${action.targetVersion}. Sync to ${action.targetVersion}?`,
+            });
+            if (!proceed) {
+                this.log(`  Skipped ${action.slug}`);
+                continue;
+            }
+            this.log(`  Syncing ${action.slug} to ${action.targetVersion}...`);
+            try {
+                const result = await got
+                    .post(`${url}/wp-json/loopress/v1/plugins/install`, {
+                    headers,
+                    json: { slug: action.slug, version: action.targetVersion },
+                })
+                    .json();
+                this.log(`  ✓ ${result.message}`);
+            }
+            catch (error) {
+                this.warn(`  Failed to sync ${action.slug}: ${error.message}`);
+                continue;
+            }
+            await this.activatePlugin(url, headers, action.slug);
+        }
+        await this.recordSuccess();
+    }
+    async activatePlugin(url, headers, slug) {
+        try {
+            const result = await got
+                .post(`${url}/wp-json/loopress/v1/plugins/activate`, { headers, json: { slug } })
+                .json();
+            this.log(`  ✓ ${result.message}`);
+        }
+        catch (error) {
+            this.warn(`  Failed to activate ${slug}: ${error.message}`);
+        }
+    }
+}

package/dist/commands/plugin/require.d.ts

@@ -0,0 +1,17 @@
+import { LoopressCommand } from '../../lib/base.js';
+export declare function resolvePluginVersion(slug: string, version: string): Promise<string>;
+export default class Require extends LoopressCommand {
+    static args: {
+        slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        version: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/plugin/require.js

@@ -0,0 +1,74 @@
+import { Args, Flags } from '@oclif/core';
+import got from 'got';
+import { LoopressCommand } from '../../lib/base.js';
+import { readLocalConfig, writeLocalConfig } from '../../utils/loopress-config.js';
+const WP_ORG_API = 'https://api.wordpress.org/plugins/info/1.2/';
+export async function resolvePluginVersion(slug, version) {
+    if (version !== 'latest')
+        return version;
+    let info;
+    try {
+        info = await got
+            .get(WP_ORG_API, {
+            searchParams: {
+                action: 'plugin_information',
+                'request[slug]': slug,
+            },
+        })
+            .json();
+    }
+    catch {
+        throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
+    }
+    if (info.error)
+        throw new Error(`Plugin "${slug}" not found on WordPress.org.`);
+    return info.version;
+}
+export default class Require extends LoopressCommand {
+    static args = {
+        slug: Args.string({ description: 'Plugin slug (WordPress.org)', required: true }),
+        version: Args.string({ description: 'Version to pin (default: latest)' }),
+    };
+    static description = 'Add a plugin to loopress.json, resolving its latest version from WordPress.org';
+    static examples = [
+        '$ lps plugins require woocommerce',
+        '$ lps plugins require woocommerce 8.9.1',
+        '$ lps plugins require contact-form-7 --dry-run',
+    ];
+    static flags = {
+        ...LoopressCommand.baseFlags,
+        'dry-run': Flags.boolean({ char: 'd', description: 'Show what would be written without making changes' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Require);
+        const dryRun = flags['dry-run'];
+        const { slug } = args;
+        const requestedVersion = args.version ?? 'latest';
+        this.log(`Resolving ${slug}@${requestedVersion}...`);
+        let resolvedVersion;
+        try {
+            resolvedVersion = await resolvePluginVersion(slug, requestedVersion);
+        }
+        catch (error) {
+            this.error(error.message);
+        }
+        this.log(`Resolved: ${slug}@${resolvedVersion}`);
+        const localConfig = await readLocalConfig();
+        const existing = localConfig.plugins ?? {};
+        if (existing[slug] === resolvedVersion) {
+            this.log(`${slug}@${resolvedVersion} is already in loopress.json — nothing to do.`);
+            return;
+        }
+        const updated = existing[slug] !== undefined;
+        const label = updated ? `${existing[slug]} → ${resolvedVersion}` : resolvedVersion;
+        if (dryRun) {
+            this.log(`[dry-run] Would ${updated ? 'update' : 'add'} ${slug}: ${label}`);
+            return;
+        }
+        await writeLocalConfig({
+            ...localConfig,
+            plugins: { ...existing, [slug]: resolvedVersion },
+        });
+        this.log(`${updated ? 'Updated' : 'Added'} ${slug}: ${label}`);
+    }
+}

package/dist/commands/project/config.js

@@ -17,9 +17,9 @@ export default class Config extends Command {
         });
         const envChoice = await select({
             choices: [
-                { name: 'production', value: 'production' },
+                { name: 'local', value: 'local' },
                 { name: 'staging', value: 'staging' },
-                { name: 'development', value: 'development' },
+                { name: 'production', value: 'production' },
                 { name: 'Custom…', value: '__custom__' },
             ],
             message: 'Environment',

package/dist/commands/{snippets → snippet}/list.d.ts

@@ -4,7 +4,7 @@ export default class List extends LoopressCommand {
     static examples: string[];
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        plugin: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/{snippets → snippet}/list.js

@@ -14,8 +14,7 @@ export default class List extends LoopressCommand {
         json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
         plugin: Flags.string({
             char: 'p',
-            default: 'code-snippets',
-            description: 'WordPress snippet plugin to target',
+            description: 'WordPress snippet plugin to target (overrides loopress.json)',
             options: ['code-snippets', 'wpcode'],
         }),
     };
@@ -23,8 +22,9 @@ export default class List extends LoopressCommand {
         const { flags } = await this.parse(List);
         const { json, plugin } = flags;
         const { url } = this.siteConfig;
+        const resolvedPlugin = await this.resolveSnippetPlugin(plugin);
         try {
-            const adapter = getSnippetPlugin(plugin);
+            const adapter = getSnippetPlugin(resolvedPlugin);
             const endpoint = adapter.endpoint(url);
             const headers = await this.buildAuthHeaders();
             const remoteList = await got.get(endpoint, { headers }).json();

package/dist/commands/{snippets → snippet}/pull.d.ts

@@ -1,4 +1,7 @@
 import { LoopressCommand } from '../../lib/base.js';
+import { NormalizedSnippet } from '../../utils/snippet-plugin.js';
+export declare function buildSnippetFile(snippet: NormalizedSnippet): string;
+export declare function buildMetaFile(snippet: NormalizedSnippet): string;
 export default class Pull extends LoopressCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
@@ -7,7 +10,7 @@ export default class Pull extends LoopressCommand {
     static examples: string[];
     static flags: {
         dryRun: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        plugin: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/{snippets → snippet}/pull.js

@@ -10,39 +10,24 @@ const EXTENSIONS = {
     php: 'php',
     text: 'txt',
 };
-const sanitize = (value) => value.replaceAll(/\s*\n\s*/g, ' ').trim();
-function buildMetaLines(snippet) {
-    return [
-        `id: ${snippet.id}`,
-        `name: ${sanitize(snippet.name)}`,
-        ...(snippet.description ? [`description: ${sanitize(snippet.description)}`] : []),
-        `type: ${snippet.type}`,
-        ...(snippet.tags.length > 0 ? [`tags: ${snippet.tags.map((t) => sanitize(t)).join(', ')}`] : []),
-        `active: ${snippet.active}`,
-    ];
-}
-function buildSnippetFile(snippet) {
-    const meta = buildMetaLines(snippet);
-    switch (snippet.type) {
-        case 'css':
-        case 'js': {
-            const header = ['/**', ...meta.map((l) => ` * ${l}`), ' */'].join('\n');
-            return `${header}\n\n${snippet.code}`;
-        }
-        case 'html': {
-            const header = ['<!--', ...meta.map((l) => `  ${l}`), '-->'].join('\n');
-            return `${header}\n\n${snippet.code}`;
-        }
-        case 'text': {
-            return snippet.code;
-        }
-        case 'php':
-        default: {
-            const header = ['<?php', '/**', ...meta.map((l) => ` * ${l}`), ' */'].join('\n');
-            const body = snippet.code.replace(/^<\?php\s*/i, '');
-            return `${header}\n\n${body}`;
-        }
+export function buildSnippetFile(snippet) {
+    if (snippet.type === 'php' && !snippet.code.trimStart().startsWith('<?')) {
+        return `<?php\n\n${snippet.code}`;
     }
+    return snippet.code;
+}
+export function buildMetaFile(snippet) {
+    const meta = {
+        id: snippet.id,
+        name: snippet.name,
+        type: snippet.type,
+        active: snippet.active,
+    };
+    if (snippet.description)
+        meta.description = snippet.description;
+    if (snippet.tags.length > 0)
+        meta.tags = snippet.tags;
+    return JSON.stringify(meta, null, 2) + '\n';
 }
 export default class Pull extends LoopressCommand {
     static args = {
@@ -60,8 +45,7 @@ export default class Pull extends LoopressCommand {
         dryRun: Flags.boolean({ char: 'd', description: 'Dry run - show what would happen without making changes' }),
         plugin: Flags.string({
             char: 'p',
-            default: 'code-snippets',
-            description: 'WordPress snippet plugin to target',
+            description: 'WordPress snippet plugin to target (overrides loopress.json)',
             options: ['code-snippets', 'wpcode'],
         }),
     };
@@ -70,11 +54,12 @@ export default class Pull extends LoopressCommand {
         const { dryRun, plugin } = flags;
         const { url } = this.siteConfig;
         const path = await this.resolveSnippetsPath(args.path);
-        this.log(`📥 Pulling snippets from ${url} via ${plugin}`);
+        const resolvedPlugin = await this.resolveSnippetPlugin(plugin);
+        this.log(`📥 Pulling snippets from ${url} via ${resolvedPlugin}`);
         this.log(`📂 From snippet path: ${path}`);
         this.log(`🔄 Dry run: ${dryRun ? 'yes' : 'no'}`);
         try {
-            const adapter = getSnippetPlugin(plugin);
+            const adapter = getSnippetPlugin(resolvedPlugin);
             const endpoint = adapter.endpoint(url);
             const headers = await this.buildAuthHeaders();
             const remoteList = await got.get(endpoint, { headers }).json();
@@ -94,8 +79,12 @@ export default class Pull extends LoopressCommand {
                     continue;
                 }
                 const ext = EXTENSIONS[snippet.type];
-                const filePath = `${path}/${slugify(snippet.name, { lower: true, strict: true })}.${ext}`;
+                const slug = slugify(snippet.name, { lower: true, strict: true });
+                const base = `${snippet.id}-${slug}`;
+                const filePath = `${path}/${base}.${ext}`;
+                const metaPath = `${path}/${base}.json`;
                 await fs.writeFile(filePath, buildSnippetFile(snippet));
+                await fs.writeFile(metaPath, buildMetaFile(snippet));
                 count++;
                 this.log(`✅ Pulled: ${snippet.name}`);
             }

package/dist/commands/{snippets → snippet}/push.d.ts

@@ -1,5 +1,5 @@
-import { LoopressCommand } from '../../lib/base.js';
-export default class Push extends LoopressCommand {
+import { PushCommand } from '../../lib/push-command.js';
+export default class Push extends PushCommand {
     static args: {
         path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
@@ -7,14 +7,13 @@ export default class Push extends LoopressCommand {
     static examples: string[];
     static flags: {
         dryRun: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        plugin: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         user: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
-    private injectIdIntoFile;
+    private injectIdIntoMeta;
     private loadSnippets;
-    private parseMetaFromContent;
     private pushSnippet;
 }