pressship 0.1.2 → 0.1.3

package/.claude/skills/wordpress-plugin-publish/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: wordpress-plugin-publish
+description: Use this skill when publishing, submitting, reuploading, packaging, checking, or releasing WordPress.org plugins with Pressship. It covers safe Pressship workflows for local plugin directories, pending WordPress.org submissions, approved plugin releases, Plugin Check review, package exclusions, WordPress Playground demos, and authentication.
+---
+
+# WordPress Plugin Publish
+
+Use Pressship for WordPress.org plugin submission and release work. Prefer `npx pressship` unless the user explicitly wants the local checkout version.
+
+## Safety Rules
+
+- Never publish, submit, reupload, or release without first running a dry run, unless the user explicitly says to skip it.
+- Do not push git commits or tags unless the user explicitly asks.
+- Report Plugin Check findings clearly. Do not hide them just because Pressship can continue.
+- Use repeatable excludes for large or source-only files. Prefer `.pressshipignore` when the project already has one.
+- If Pressship prompts interactively, answer only with user-approved or obvious plugin metadata.
+- If authentication fails, run `npx pressship login` and let the user complete WordPress.org login.
+
+## Orientation
+
+From the plugin directory:
+
+```bash
+npx pressship whoami
+npx pressship status .
+npx pressship info .
+```
+
+Use `status` to determine whether `publish` will target a pending submission reupload or an approved SVN release.
+
+## Local Playground Test
+
+Start a local WordPress Playground with the plugin mounted:
+
+```bash
+npx pressship demo .
+```
+
+Useful options:
+
+```bash
+npx pressship demo . --port 9401
+npx pressship demo . --wp 6.8 --php 8.3
+npx pressship demo . --reset
+npx pressship demo . --skip-browser
+```
+
+## Package Check
+
+Create and validate a WordPress-installable zip without uploading:
+
+```bash
+npx pressship pack .
+```
+
+For projects with bulky assets or source-only files, pass explicit ignores:
+
+```bash
+npx pressship pack . --ignore "assets/**" --ignore "src/**" --ignore "node_modules/**"
+```
+
+Inspect package file count and included paths. Make sure the ZIP contains runtime PHP, built assets, `readme.txt`, and any required examples or static assets.
+
+## Submit Or Reupload Pending Review
+
+Use this for new plugins or WordPress.org submissions still awaiting review.
+
+Dry run first:
+
+```bash
+npx pressship publish . --dry-run -y
+```
+
+Then upload:
+
+```bash
+npx pressship publish . -y
+```
+
+When the project contains large non-distribution directories, repeat the same ignore flags in both commands:
+
+```bash
+npx pressship publish . --dry-run -y \
+  --ignore "assets/**" \
+  --ignore "src/**" \
+  --ignore "scripts/**" \
+  --ignore "package.json" \
+  --ignore "package-lock.json" \
+  --ignore ".github/**" \
+  --ignore "node_modules/**" \
+  --ignore "dist/**"
+
+npx pressship publish . -y \
+  --ignore "assets/**" \
+  --ignore "src/**" \
+  --ignore "scripts/**" \
+  --ignore "package.json" \
+  --ignore "package-lock.json" \
+  --ignore ".github/**" \
+  --ignore "node_modules/**" \
+  --ignore "dist/**"
+```
+
+After upload, confirm:
+
+```bash
+npx pressship status .
+```
+
+## Release Approved Plugin
+
+Use this only when the plugin is already approved and the user wants a WordPress.org release.
+
+Dry run first:
+
+```bash
+npx pressship publish . --release --dry-run -y
+```
+
+Then release:
+
+```bash
+npx pressship publish . --release -y
+```
+
+If Pressship cannot infer the slug or username:
+
+```bash
+npx pressship release . --slug my-plugin --username WpOrgUser --dry-run
+npx pressship release . --slug my-plugin --username WpOrgUser -y
+```
+
+## Version Bumps
+
+Only run version bumps when the user asks:
+
+```bash
+npx pressship version patch .
+npx pressship version minor .
+npx pressship version major .
+```
+
+After a version bump, review changed plugin headers, `readme.txt` stable tag, and changelog.
+
+## Final Report
+
+Always include:
+
+- Whether a dry run was run.
+- Package size and notable included/excluded files.
+- Plugin Check result summary.
+- Upload/release status and slug.
+- Whether git was left untouched or changed.

package/README.md

@@ -13,10 +13,10 @@
 </p>
 
 <p align="center">
-  <strong>WordPress.org plugin publishing, but closer to <code>npm publish</code>.</strong>
+  <strong>A modernized publishing workflow for WordPress.org plugins.</strong>
 </p>
 
-It is designed to make WordPress plugin publishing feel closer to npm package publishing:
+It is designed to modernize WordPress plugin publishing while keeping WordPress.org review and SVN release behavior explicit:
 
 ```bash
 npx pressship login
@@ -24,6 +24,18 @@ npx pressship publish ./my-plugin --dry-run
 npx pressship publish ./my-plugin
 ```
 
+If you use agent skills, install Pressship's publishing workflow skill:
+
+```bash
+npx skills add f/pressship --skill wordpress-plugin-publish -a codex
+```
+
+For other agents, replace `codex` with the target agent name, such as `claude-code`. To inspect available skills first, run:
+
+```bash
+npx skills add f/pressship --list
+```
+
 ## Why Pressship?
 
 Publishing a WordPress plugin to WordPress.org involves a lot of small steps: creating the right zip, validating `readme.txt`, running Plugin Check, logging into WordPress.org, uploading through the developer page, and later publishing releases through SVN.
@@ -38,12 +50,17 @@ Pressship automates that workflow while still using WordPress.org's existing rev
 - `readme.txt` parsing and local validation.
 - WordPress.org readme validator automation.
 - WordPress-installable zip generation.
-- npm-style `publish` and `pack` commands.
+- Modernized `publish` and `pack` commands.
 - Managed WordPress.org Plugin Check setup and execution.
 - Current WordPress.org submission state inspection.
+- Local and hosted plugin info lookup.
+- Local WordPress Playground demos for plugin paths or hosted slugs.
+- Playground runtime selection from plugin WordPress/PHP requirements.
+- Quieter Playground demos with deprecation noise suppressed.
 - Pending-plugin reupload support via the WordPress.org developer page.
 - SVN release workflow for approved plugins.
 - Repeatable ignore globs and `.pressshipignore` support.
+- Documentation site for GitHub Pages.
 - Colorful CLI output with progress indicators.
 
 ## Quick Start
@@ -58,6 +75,14 @@ npx pressship whoami
 # Inspect current submitted plugin state.
 npx pressship status ./my-plugin
 
+# Inspect local plugin metadata or hosted WordPress.org plugin info.
+npx pressship info ./my-plugin
+npx pressship info 16deza-table-cell-extras
+
+# Open a local WordPress Playground demo.
+npx pressship demo ./my-plugin
+npx pressship demo 16deza-table-cell-extras
+
 # Validate and package without uploading or committing.
 npx pressship publish ./my-plugin --dry-run
 
@@ -88,6 +113,8 @@ Pressship installs Playwright Chromium automatically when browser automation fir
 pressship login
 pressship whoami [--json]
 pressship logout
+pressship info [slug-or-path] [--json]
+pressship demo [slug-or-path] [options]
 pressship status [plugin-path-or-slug] [--json]
 pressship version <patch|minor|major> [plugin-path]
 pressship pack [plugin-path] [options]
@@ -114,6 +141,46 @@ pressship whoami --json
 pressship logout
 ```
 
+## Info Flow
+
+```bash
+pressship info
+pressship info ./my-plugin
+pressship info 16deza-table-cell-extras
+pressship info https://wordpress.org/plugins/16deza-table-cell-extras/
+pressship info 16deza-table-cell-extras --json
+```
+
+`info` shows detailed metadata for a local plugin path or hosted WordPress.org plugin. With no argument, it inspects the current directory.
+
+For local plugins it reports headers and readme metadata, including version, main file, readme path, text domain, requirements, stable tag, tags, contributors, and description.
+
+For hosted plugins it uses the public WordPress.org plugin info API and reports version, author, requirements, active installs, last updated date, rating, support status, tags, description, and download URL.
+
+## Demo Flow
+
+```bash
+pressship demo
+pressship demo ./my-plugin
+pressship demo 16deza-table-cell-extras
+pressship demo https://wordpress.org/plugins/16deza-table-cell-extras/
+```
+
+`demo` starts a local WordPress Playground server with the plugin loaded and activated. For local paths, Pressship mounts the plugin directory into Playground so local code changes are available. For hosted slugs or WordPress.org plugin URLs, Pressship creates a Blueprint that installs and activates the plugin from the WordPress.org directory.
+
+Pressship uses the plugin's required WordPress and PHP versions when they are declared; pass `--wp` or `--php` to override them. It also adds a small Playground compatibility mu-plugin before activation so plugins that expect WordPress admin plugin helpers can boot cleanly. PHP deprecation notices are suppressed in demo pages, while real warnings, errors, and fatal errors remain visible.
+
+Useful options:
+
+```bash
+pressship demo ./my-plugin --port 9401
+pressship demo ./my-plugin --wp 6.8 --php 8.3
+pressship demo ./my-plugin --reset
+pressship demo ./my-plugin --skip-browser
+```
+
+Under the hood, `demo` uses the official `@wp-playground/cli` package. The Playground server keeps running until you stop it with `Ctrl+C`.
+
 ## Status Flow
 
 ```bash
@@ -161,7 +228,7 @@ pressship version minor ./my-plugin
 pressship version major ./my-plugin
 ```
 
-`version` bumps local plugin metadata, similar to `npm version`.
+`version` bumps local plugin metadata from the command line.
 
 It updates:
 
@@ -187,7 +254,7 @@ pressship version major ./my-plugin
 pressship publish ./my-plugin
 ```
 
-`publish` is the npm-style happy path. It discovers the plugin and then chooses the best WordPress.org publishing flow:
+`publish` is the modernized happy path. It discovers the plugin and then chooses the best WordPress.org publishing flow:
 
 - Use `submit` when a matching WordPress.org review submission is pending or reuploadable.
 - Use `release` when the plugin has an approved WordPress.org SVN repository and no pending review submission is found.
@@ -214,7 +281,7 @@ Use `--submit` for the review-upload flow and `--release` for the approved-plugi
 pressship pack ./my-plugin
 ```
 
-`pack` validates the plugin, runs Plugin Check, and creates the WordPress-installable `{slug}.zip` without uploading or committing. By default, it writes the zip to the current directory, similar to `npm pack`.
+`pack` validates the plugin, runs Plugin Check, and creates the WordPress-installable `{slug}.zip` without uploading or committing. By default, it writes the zip to the current directory.
 
 Useful options:
 
@@ -375,6 +442,7 @@ This includes:
 - Debug screenshots for failed browser automation.
 - Managed Plugin Check cache.
 - Managed WordPress core and SQLite setup.
+- Generated Playground demo blueprints.
 
 You can override the config directory:
 
@@ -397,7 +465,7 @@ npx playwright install chromium
 For local development:
 
 ```bash
-npm run browsers:install
+Run the `browsers:install` package script.
 ```
 
 ### Not Logged In
@@ -436,32 +504,60 @@ pressship submit ./my-plugin --wp-path /path/to/wordpress
 
 The WordPress.org submission and reupload flows are browser automation over the logged-in developer page, not a documented public API. If WordPress.org changes the form, Pressship fails loudly and saves a debug screenshot under the config directory.
 
+## Documentation Site
+
+The documentation site lives in `website/`.
+
+Run it locally:
+
+```bash
+Run the `docs:dev` package script.
+```
+
+Build the static site:
+
+```bash
+Run the `docs:build` package script.
+```
+
+Preview the production build:
+
+```bash
+Run the `docs:serve` package script.
+```
+
+GitHub Pages deployment is configured in `.github/workflows/docs.yml`. In the repository settings, set Pages to use GitHub Actions as the source.
+
 ## Development
 
 ```bash
-npm install
-npm run dev -- --help
-npm run typecheck
-npm test
-npm run build
+Install dependencies with your preferred Node package manager, then run:
+
+- `dev -- --help`
+- `typecheck`
+- `test`
+- `build`
+- `docs:build`
 ```
 
 Run local commands without publishing:
 
 ```bash
-npm run dev -- login
-npm run dev -- whoami
-npm run dev -- status
-npm run dev -- pack ./my-plugin
-npm run dev -- publish ./my-plugin --dry-run
-npm run dev -- submit ./my-plugin --dry-run
-npm run dev -- release ./my-plugin --dry-run
+Run these through the `dev` package script:
+
+- `login`
+- `whoami`
+- `status`
+- `pack ./my-plugin`
+- `publish ./my-plugin --dry-run`
+- `submit ./my-plugin --dry-run`
+- `release ./my-plugin --dry-run`
 ```
 
 Package smoke test:
 
 ```bash
-npm pack --dry-run
+Use your package manager's dry-run pack command.
 ```
 
 ## Security Notes

package/dist/cli.js

@@ -8,6 +8,8 @@ import { publish } from "./wordpress-org/publish.js";
 import { submit } from "./wordpress-org/submit.js";
 import { status } from "./wordpress-org/state.js";
 import { release } from "./svn/release.js";
+import { demo } from "./plugin/demo.js";
+import { info } from "./plugin/info.js";
 import { version } from "./plugin/version.js";
 const program = new Command();
 program
@@ -27,6 +29,22 @@ program
     .description("Print the WordPress.org username for the saved login session.")
     .option("--json", "Print account details as JSON")
     .action((options) => run(() => whoami(options))());
+program
+    .command("demo")
+    .description("Start a local WordPress Playground demo for a plugin path or WordPress.org slug.")
+    .argument("[slug-or-path]", "Local plugin path, WordPress.org plugin slug, or plugin URL")
+    .option("--port <port>", "Port for the local Playground server")
+    .option("--wp <version>", "WordPress version to use")
+    .option("--php <version>", "PHP version to use")
+    .option("--reset", "Reset the persisted Playground site before starting")
+    .option("--skip-browser", "Start the local server without opening a browser")
+    .action((target, options) => run(() => demo(target, options))());
+program
+    .command("info")
+    .description("Show detailed info for a local plugin path or WordPress.org plugin slug.")
+    .argument("[slug-or-path]", "Local plugin path, WordPress.org plugin slug, or plugin URL")
+    .option("--json", "Print plugin info as JSON")
+    .action((target, options) => run(() => info(target, options))());
 program
     .command("publish")
     .description("Submit for review or release an approved plugin, similar to npm publish.")

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/plugin/demo.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { PluginProject } from "../types.js";
+declare const demoOptionsSchema: z.ZodObject<{
+    port: z.ZodOptional<z.ZodString>;
+    wp: z.ZodOptional<z.ZodString>;
+    php: z.ZodOptional<z.ZodString>;
+    reset: z.ZodDefault<z.ZodBoolean>;
+    skipBrowser: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DemoOptions = z.input<typeof demoOptionsSchema>;
+export type PlaygroundBlueprint = {
+    landingPage: string;
+    steps: Array<Record<string, unknown>>;
+};
+export type DemoLaunchPlan = {
+    source: "local" | "wordpress.org";
+    name: string;
+    slug: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    blueprintPath: string;
+    siteDir: string;
+    wpVersion?: string;
+    phpVersion?: string;
+    url?: string;
+};
+export declare function demo(target: string | undefined, rawOptions?: DemoOptions): Promise<void>;
+export declare function createDemoLaunchPlan(target: string | undefined, options: z.infer<typeof demoOptionsSchema>): Promise<DemoLaunchPlan>;
+export declare function createLocalDemoBlueprint(project: PluginProject): PlaygroundBlueprint;
+export declare function createHostedDemoBlueprint(slug: string): PlaygroundBlueprint;
+export declare function createPlaygroundCompatibilitySteps(): Array<Record<string, unknown>>;
+export declare function createPlaygroundStartArgs(input: {
+    path: string;
+    blueprintPath: string;
+    mount?: string;
+    options: z.infer<typeof demoOptionsSchema>;
+}): string[];
+export declare function resolveDemoPlaygroundOptions(options: z.infer<typeof demoOptionsSchema>, requiredVersions: {
+    wp?: unknown;
+    php?: unknown;
+}): z.infer<typeof demoOptionsSchema>;
+export declare function getPlaygroundSiteDir(projectPath: string): string;
+export {};

package/dist/plugin/demo.js

@@ -0,0 +1,207 @@
+import { createHash } from "node:crypto";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { execa } from "execa";
+import { z } from "zod";
+import { discoverPluginProject } from "./discover.js";
+import { fetchHostedPluginInfo, slugFromHostedTarget } from "./info.js";
+import { ui } from "../ui.js";
+import { ensureCacheDir, pathExists } from "../utils/paths.js";
+const playgroundCliPackage = "@wp-playground/cli@latest";
+const compatibilityMuPluginPath = "/wordpress/wp-content/mu-plugins/pressship-playground-compat.php";
+const compatibilityMuPlugin = `<?php
+error_reporting(error_reporting() & ~E_DEPRECATED & ~E_USER_DEPRECATED);
+set_error_handler(static function (int $severity): bool {
+    return $severity === E_DEPRECATED || $severity === E_USER_DEPRECATED;
+});
+
+if (! function_exists('is_plugin_active')) {
+    require_once ABSPATH . 'wp-admin/includes/plugin.php';
+}
+`;
+const demoOptionsSchema = z.object({
+    port: z.string().optional(),
+    wp: z.string().optional(),
+    php: z.string().optional(),
+    reset: z.boolean().default(false),
+    skipBrowser: z.boolean().default(false)
+});
+export async function demo(target, rawOptions = {}) {
+    const options = demoOptionsSchema.parse(rawOptions);
+    ui.intro("Start plugin demo");
+    const plan = await ui.task("Preparing Playground demo", () => createDemoLaunchPlan(target, options), (value) => `Prepared ${value.name}`);
+    ui.section("Playground");
+    ui.keyValue("Plugin", plan.name);
+    ui.keyValue("Source", plan.source);
+    ui.keyValue("Slug", plan.slug);
+    ui.keyValue("WordPress", plan.wpVersion ?? "default");
+    ui.keyValue("PHP", plan.phpVersion ?? "default");
+    ui.keyValue("Site", ui.path(plan.siteDir));
+    if (plan.url) {
+        ui.keyValue("URL", ui.path(plan.url));
+    }
+    ui.keyValue("Blueprint", ui.path(plan.blueprintPath));
+    if (options.reset) {
+        await ui.task("Resetting persisted Playground site", () => resetPlaygroundSite(plan.siteDir), () => "Reset complete");
+    }
+    ui.info("Starting WordPress Playground. Press Ctrl+C to stop the local server.");
+    await execa(plan.command, plan.args, {
+        cwd: plan.cwd,
+        stdio: "inherit"
+    });
+}
+export async function createDemoLaunchPlan(target, options) {
+    const resolvedTarget = target ?? process.cwd();
+    if (isLocalPluginTarget(resolvedTarget)) {
+        const project = await discoverPluginProject(resolvedTarget);
+        const blueprintPath = await writeDemoBlueprint(project.slug, createLocalDemoBlueprint(project));
+        const playgroundOptions = resolveDemoPlaygroundOptions(options, {
+            wp: project.headers.requiresAtLeast ?? project.readme?.requiresAtLeast,
+            php: project.headers.requiresPhp ?? project.readme?.requiresPhp
+        });
+        const url = options.port ? `http://127.0.0.1:${options.port}` : undefined;
+        return {
+            source: "local",
+            name: project.headers.pluginName,
+            slug: project.slug,
+            command: "npx",
+            args: createPlaygroundStartArgs({
+                path: project.rootDir,
+                blueprintPath,
+                mount: `${project.rootDir}:/wordpress/wp-content/plugins/${project.slug}`,
+                options: playgroundOptions
+            }),
+            cwd: project.rootDir,
+            blueprintPath,
+            siteDir: getPlaygroundSiteDir(project.rootDir),
+            wpVersion: playgroundOptions.wp,
+            phpVersion: playgroundOptions.php,
+            url
+        };
+    }
+    const slug = slugFromHostedTarget(resolvedTarget);
+    const plugin = await fetchHostedPluginInfo(slug);
+    const blueprintPath = await writeDemoBlueprint(slug, createHostedDemoBlueprint(slug));
+    const demoDir = path.dirname(blueprintPath);
+    const playgroundOptions = resolveDemoPlaygroundOptions(options, {
+        wp: plugin.requires,
+        php: plugin.requiresPhp
+    });
+    const url = options.port ? `http://127.0.0.1:${options.port}` : undefined;
+    return {
+        source: "wordpress.org",
+        name: plugin.name,
+        slug,
+        command: "npx",
+        args: createPlaygroundStartArgs({
+            path: demoDir,
+            blueprintPath,
+            options: playgroundOptions
+        }),
+        cwd: demoDir,
+        blueprintPath,
+        siteDir: getPlaygroundSiteDir(demoDir),
+        wpVersion: playgroundOptions.wp,
+        phpVersion: playgroundOptions.php,
+        url
+    };
+}
+export function createLocalDemoBlueprint(project) {
+    const relativeMainFile = path.relative(project.rootDir, project.mainFile).split(path.sep).join("/");
+    return {
+        landingPage: "/wp-admin/plugins.php",
+        steps: [
+            ...createPlaygroundCompatibilitySteps(),
+            {
+                step: "activatePlugin",
+                pluginName: project.headers.pluginName,
+                pluginPath: `/wordpress/wp-content/plugins/${project.slug}/${relativeMainFile}`
+            }
+        ]
+    };
+}
+export function createHostedDemoBlueprint(slug) {
+    return {
+        landingPage: "/wp-admin/plugins.php",
+        steps: [
+            ...createPlaygroundCompatibilitySteps(),
+            {
+                step: "installPlugin",
+                pluginData: {
+                    resource: "wordpress.org/plugins",
+                    slug
+                },
+                options: {
+                    activate: true
+                }
+            }
+        ]
+    };
+}
+export function createPlaygroundCompatibilitySteps() {
+    return [
+        {
+            step: "mkdir",
+            path: "/wordpress/wp-content/mu-plugins"
+        },
+        {
+            step: "writeFile",
+            path: compatibilityMuPluginPath,
+            data: compatibilityMuPlugin
+        }
+    ];
+}
+export function createPlaygroundStartArgs(input) {
+    return [
+        "--yes",
+        playgroundCliPackage,
+        "start",
+        `--path=${input.path}`,
+        `--blueprint=${input.blueprintPath}`,
+        "--define-bool",
+        "WP_DEBUG",
+        "false",
+        "--define-bool",
+        "WP_DEBUG_DISPLAY",
+        "false",
+        ...(input.mount ? ["--no-auto-mount", `--mount=${input.mount}`] : []),
+        ...(input.options.port ? [`--port=${input.options.port}`] : []),
+        ...(input.options.wp ? [`--wp=${input.options.wp}`] : []),
+        ...(input.options.php ? [`--php=${input.options.php}`] : []),
+        ...(input.options.skipBrowser ? ["--skip-browser"] : [])
+    ];
+}
+export function resolveDemoPlaygroundOptions(options, requiredVersions) {
+    return {
+        ...options,
+        wp: options.wp ?? normalizePlaygroundVersion(requiredVersions.wp),
+        php: options.php ?? normalizePlaygroundVersion(requiredVersions.php)
+    };
+}
+export function getPlaygroundSiteDir(projectPath) {
+    const siteId = createHash("sha256").update(projectPath).digest("hex");
+    return path.join(homedir(), ".wordpress-playground", "sites", siteId);
+}
+async function resetPlaygroundSite(siteDir) {
+    await rm(siteDir, { recursive: true, force: true });
+}
+async function writeDemoBlueprint(slug, blueprint) {
+    const cacheDir = await ensureCacheDir();
+    const demoDir = path.join(cacheDir, "demo", slug);
+    const blueprintPath = path.join(demoDir, "blueprint.json");
+    await mkdir(demoDir, { recursive: true, mode: 0o700 });
+    await writeFile(blueprintPath, `${JSON.stringify(blueprint, null, 2)}\n`);
+    return blueprintPath;
+}
+function isLocalPluginTarget(target) {
+    return target === "." || target.startsWith("..") || target.startsWith(`.${path.sep}`) || path.isAbsolute(target) || pathExists(target);
+}
+function normalizePlaygroundVersion(version) {
+    if (typeof version !== "string") {
+        return undefined;
+    }
+    const trimmed = version.trim();
+    return trimmed && trimmed !== "0" ? trimmed : undefined;
+}
+//# sourceMappingURL=demo.js.map

package/dist/plugin/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/plugin/demo.ts"],"names":[],"mappings":"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"}

package/dist/plugin/info.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type { PluginProject, ReadmeMetadata } from "../types.js";
+declare const infoOptionsSchema: z.ZodObject<{
+    json: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type InfoOptions = z.input<typeof infoOptionsSchema>;
+export type LocalPluginInfo = {
+    source: "local";
+    rootDir: string;
+    mainFile: string;
+    readmePath?: string;
+    name: string;
+    slug: string;
+    version?: string;
+    description?: string;
+    author?: string;
+    pluginUri?: string;
+    authorUri?: string;
+    textDomain?: string;
+    domainPath?: string;
+    requiresAtLeast?: string;
+    requiresPhp?: string;
+    license?: string;
+    licenseUri?: string;
+    readme?: ReadmeMetadata;
+};
+export type HostedPluginInfo = {
+    source: "wordpress.org";
+    name: string;
+    slug: string;
+    version?: string;
+    author?: string;
+    authorProfile?: string;
+    homepage?: string;
+    pluginUrl: string;
+    downloadUrl?: string;
+    requires?: string;
+    tested?: string;
+    requiresPhp?: string;
+    activeInstalls?: number;
+    lastUpdated?: string;
+    added?: string;
+    rating?: number;
+    ratingPercent?: number;
+    ratingCount?: number;
+    supportThreads?: number;
+    supportThreadsResolved?: number;
+    tags: string[];
+    description?: string;
+    changelog?: string;
+};
+export type PluginInfo = LocalPluginInfo | HostedPluginInfo;
+type PluginInfoApiResponse = {
+    error?: string;
+    name?: string;
+    slug?: string;
+    version?: string;
+    author?: string;
+    author_profile?: string;
+    requires?: string | boolean | null;
+    tested?: string;
+    requires_php?: string | boolean | null;
+    rating?: number;
+    num_ratings?: number;
+    support_threads?: number;
+    support_threads_resolved?: number;
+    active_installs?: number;
+    last_updated?: string;
+    added?: string;
+    homepage?: string;
+    sections?: {
+        description?: string;
+        changelog?: string;
+    };
+    download_link?: string;
+    tags?: Record<string, string> | string[];
+};
+export declare function info(target: string | undefined, rawOptions?: InfoOptions): Promise<void>;
+export declare function getPluginInfo(target: string | undefined): Promise<PluginInfo>;
+export declare function localPluginInfo(project: PluginProject): LocalPluginInfo;
+export declare function fetchHostedPluginInfo(slug: string): Promise<HostedPluginInfo>;
+export declare function hostedPluginInfoFromApi(body: PluginInfoApiResponse, fallbackSlug: string): HostedPluginInfo;
+export declare function slugFromHostedTarget(target: string): string;
+export {};

package/dist/plugin/info.js

@@ -0,0 +1,209 @@
+import path from "node:path";
+import { z } from "zod";
+import { discoverPluginProject } from "./discover.js";
+import { ui } from "../ui.js";
+import { pathExists } from "../utils/paths.js";
+const infoOptionsSchema = z.object({
+    json: z.boolean().default(false)
+});
+export async function info(target, rawOptions = {}) {
+    const options = infoOptionsSchema.parse(rawOptions);
+    const result = options.json
+        ? await getPluginInfo(target)
+        : await ui.task("Reading plugin info", () => getPluginInfo(target), (value) => `Found ${value.name}`);
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    printPluginInfo(result);
+}
+export async function getPluginInfo(target) {
+    const resolvedTarget = target ?? process.cwd();
+    if (isLocalPluginTarget(resolvedTarget)) {
+        return localPluginInfo(await discoverPluginProject(resolvedTarget));
+    }
+    return fetchHostedPluginInfo(slugFromHostedTarget(resolvedTarget));
+}
+export function localPluginInfo(project) {
+    return {
+        source: "local",
+        rootDir: project.rootDir,
+        mainFile: project.mainFile,
+        readmePath: project.readmePath,
+        name: project.headers.pluginName,
+        slug: project.slug,
+        version: project.version,
+        description: project.headers.description,
+        author: project.headers.author,
+        pluginUri: project.headers.pluginUri,
+        authorUri: project.headers.authorUri,
+        textDomain: project.headers.textDomain,
+        domainPath: project.headers.domainPath,
+        requiresAtLeast: project.headers.requiresAtLeast ?? project.readme?.requiresAtLeast,
+        requiresPhp: project.headers.requiresPhp ?? project.readme?.requiresPhp,
+        license: project.headers.license ?? project.readme?.license,
+        licenseUri: project.headers.licenseUri ?? project.readme?.licenseUri,
+        readme: project.readme
+    };
+}
+export async function fetchHostedPluginInfo(slug) {
+    const url = new URL("https://api.wordpress.org/plugins/info/1.2/");
+    url.searchParams.set("action", "plugin_information");
+    url.searchParams.set("request[slug]", slug);
+    const response = await fetch(url);
+    const body = (await response.json());
+    if (!response.ok || body.error) {
+        throw new Error(body.error ? `WordPress.org plugin not found: ${slug}` : `Could not fetch plugin info for ${slug}.`);
+    }
+    return hostedPluginInfoFromApi(body, slug);
+}
+export function hostedPluginInfoFromApi(body, fallbackSlug) {
+    const slug = body.slug ?? fallbackSlug;
+    return {
+        source: "wordpress.org",
+        name: body.name ?? slug,
+        slug,
+        version: body.version,
+        author: cleanText(body.author),
+        authorProfile: body.author_profile,
+        homepage: body.homepage,
+        pluginUrl: `https://wordpress.org/plugins/${slug}/`,
+        downloadUrl: body.download_link,
+        requires: normalizeApiVersion(body.requires),
+        tested: body.tested,
+        requiresPhp: normalizeApiVersion(body.requires_php),
+        activeInstalls: body.active_installs,
+        lastUpdated: body.last_updated,
+        added: body.added,
+        rating: body.rating === undefined ? undefined : body.rating / 20,
+        ratingPercent: body.rating,
+        ratingCount: body.num_ratings,
+        supportThreads: body.support_threads,
+        supportThreadsResolved: body.support_threads_resolved,
+        tags: normalizeTags(body.tags),
+        description: cleanText(body.sections?.description),
+        changelog: cleanText(body.sections?.changelog)
+    };
+}
+export function slugFromHostedTarget(target) {
+    try {
+        const url = new URL(target);
+        const parts = url.pathname.split("/").filter(Boolean);
+        const pluginIndex = parts.indexOf("plugins");
+        const slug = pluginIndex >= 0 ? parts[pluginIndex + 1] : parts.at(-1);
+        if (slug) {
+            return slug;
+        }
+    }
+    catch {
+        // Not a URL; treat it as a slug below.
+    }
+    return target.replace(/^\/+|\/+$/g, "");
+}
+function isLocalPluginTarget(target) {
+    return target === "." || target.startsWith("..") || target.startsWith(`.${path.sep}`) || path.isAbsolute(target) || pathExists(target);
+}
+function printPluginInfo(result) {
+    ui.section(result.name);
+    ui.keyValue("Source", result.source);
+    ui.keyValue("Slug", result.slug);
+    ui.keyValue("Version", result.version ?? "unknown");
+    if (result.source === "local") {
+        ui.keyValue("Path", ui.path(result.rootDir));
+        ui.keyValue("Main file", ui.path(path.relative(result.rootDir, result.mainFile)));
+        ui.keyValue("Readme", result.readmePath ? ui.path(path.relative(result.rootDir, result.readmePath)) : "missing");
+        ui.keyValue("Author", result.author ?? "unknown");
+        ui.keyValue("Text domain", result.textDomain ?? "unknown");
+        ui.keyValue("Requires WP", result.requiresAtLeast ?? "unknown");
+        ui.keyValue("Requires PHP", result.requiresPhp ?? "unknown");
+        ui.keyValue("Stable tag", result.readme?.stableTag ?? "unknown");
+        ui.keyValue("Tested up to", result.readme?.testedUpTo ?? "unknown");
+        ui.keyValue("License", result.license ?? "unknown");
+        printList("Tags", result.readme?.tags);
+        printList("Contributors", result.readme?.contributors);
+        printLongText("Description", result.description);
+        return;
+    }
+    ui.keyValue("Author", result.author ?? "unknown");
+    ui.keyValue("Active", formatActiveInstalls(result.activeInstalls));
+    ui.keyValue("Requires WP", result.requires ? `${result.requires}+` : "unknown");
+    ui.keyValue("Tested up to", result.tested ?? "unknown");
+    ui.keyValue("Requires PHP", result.requiresPhp ? `${result.requiresPhp}+` : "unknown");
+    ui.keyValue("Last updated", result.lastUpdated ?? "unknown");
+    ui.keyValue("Added", result.added ?? "unknown");
+    ui.keyValue("Rating", formatRating(result));
+    ui.keyValue("Support", formatSupport(result));
+    ui.keyValue("URL", ui.path(result.pluginUrl));
+    if (result.downloadUrl) {
+        ui.keyValue("Download", ui.path(result.downloadUrl));
+    }
+    printList("Tags", result.tags);
+    printLongText("Description", result.description);
+}
+function printList(label, values) {
+    if (!values || values.length === 0) {
+        ui.keyValue(label, "none");
+        return;
+    }
+    ui.keyValue(label, values.join(", "));
+}
+function printLongText(label, value) {
+    if (!value) {
+        return;
+    }
+    ui.section(label);
+    console.log(value);
+}
+function normalizeTags(tags) {
+    if (Array.isArray(tags)) {
+        return tags;
+    }
+    if (!tags) {
+        return [];
+    }
+    return Object.values(tags);
+}
+function cleanText(value) {
+    if (!value) {
+        return undefined;
+    }
+    const text = value
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&quot;/g, '"')
+        .replace(/&#039;|&apos;/g, "'")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&#(\d+);/g, (_match, code) => String.fromCodePoint(Number(code)))
+        .replace(/&#x([0-9a-f]+);/gi, (_match, code) => String.fromCodePoint(Number.parseInt(code, 16)))
+        .replace(/\s+/g, " ")
+        .trim();
+    return text || undefined;
+}
+function normalizeApiVersion(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed && trimmed !== "0" ? trimmed : undefined;
+}
+function formatActiveInstalls(value) {
+    if (value === undefined) {
+        return "unknown";
+    }
+    return `${new Intl.NumberFormat("en-US").format(value)}+`;
+}
+function formatRating(result) {
+    if (result.rating === undefined || result.ratingCount === undefined) {
+        return "unknown";
+    }
+    return `${result.rating.toFixed(1)}/5 (${result.ratingCount})`;
+}
+function formatSupport(result) {
+    if (result.supportThreads === undefined || result.supportThreadsResolved === undefined) {
+        return "unknown";
+    }
+    return `${result.supportThreadsResolved}/${result.supportThreads} resolved`;
+}
+//# sourceMappingURL=info.js.map

package/dist/plugin/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/plugin/info.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "pressship",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Submit and release WordPress.org plugins from the command line.",
   "bin": {
     "pressship": "dist/cli.js"
   },
   "files": [
+    ".claude",
     "assets",
     "dist",
     "README.md",
@@ -17,6 +18,9 @@
     "build": "tsc -p tsconfig.json",
     "browsers:install": "playwright install chromium",
     "dev": "tsx src/cli.ts",
+    "docs:build": "npm run build --prefix website",
+    "docs:dev": "npm run start --prefix website",
+    "docs:serve": "npm run serve --prefix website",
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },