@postplus/cli 0.1.23 → 0.1.25

package/README.md

@@ -31,7 +31,7 @@ PostPlus has three public surfaces that work together:
 Requires Node.js and npm.
 
 ```bash
-npm install -g @postplus/cli
+npm install -g @postplus/cli@latest
 postplus auth login
 npx -y skills add PostPlusAI/postplus-skills --global --full-depth --skill '*' --agent claude-code codex cursor github-copilot windsurf trae trae-cn --yes
 ```

package/build/auth-lifecycle.js

@@ -3,6 +3,7 @@ import { clearAuthState, generateAuthStatusReport } from './auth.js';
 import { buildPostPlusClientCompatibilityHeaders, formatPostPlusCompatibilityError, } from './client-compatibility.js';
 import { requireHostedBaseUrl } from './hosted-release.js';
 import { resolveCliSessionTokenState } from './local-state.js';
+import { readSubscriptionStatusField } from './subscription-status.js';
 export async function refreshRemoteAuth() {
     const refreshed = await refreshRemoteAuthSession();
     return {
@@ -22,7 +23,7 @@ export function formatAuthRefreshReport(report) {
         `PostPlus Cloud: ${report.apiBaseUrl}`,
         `Account: ${report.accountId}`,
         `User: ${report.userEmail ?? report.userId}`,
-        `Subscription: ${report.subscriptionStatus ?? 'unknown'}`,
+        `Subscription: ${readSubscriptionStatusField(report).label}`,
     ].join('\n');
 }
 export async function revokeRemoteAuth() {

package/build/auth-validate.js

@@ -1,5 +1,6 @@
 import { resolveFreshRemoteAuth } from './auth-session.js';
 import { buildPostPlusClientCompatibilityHeaders, formatPostPlusCompatibilityError, } from './client-compatibility.js';
+import { readSubscriptionStatusField } from './subscription-status.js';
 export async function validateRemoteAuth() {
     let auth = await resolveFreshRemoteAuth();
     let response = await fetchWhoami(auth);
@@ -19,15 +20,20 @@ export async function validateRemoteAuth() {
             ? payload.error
             : 'Failed to validate remote PostPlus auth.');
     }
-    const successPayload = payload;
+    const hasSubscriptionStatus = Object.prototype.hasOwnProperty.call(payload, 'subscriptionStatus');
+    const accountId = readRequiredString(payload, 'accountId');
+    const userId = readRequiredString(payload, 'userId');
+    const userEmail = readNullableString(payload, 'userEmail');
     return {
-        accountId: successPayload.accountId,
+        accountId,
         apiBaseUrl: auth.apiBaseUrl,
         ok: true,
         source: auth.source,
-        subscriptionStatus: successPayload.subscriptionStatus,
-        userEmail: successPayload.userEmail,
-        userId: successPayload.userId,
+        ...(hasSubscriptionStatus
+            ? { subscriptionStatus: payload.subscriptionStatus }
+            : {}),
+        userEmail,
+        userId,
     };
 }
 export function formatAuthValidateReport(report) {
@@ -38,7 +44,7 @@ export function formatAuthValidateReport(report) {
         `PostPlus Cloud: ${report.apiBaseUrl}`,
         `Account: ${report.accountId}`,
         `User: ${report.userEmail ?? report.userId}`,
-        `Subscription: ${report.subscriptionStatus ?? 'unknown'}`,
+        `Subscription: ${readSubscriptionStatusField(report).label}`,
     ].join('\n');
 }
 async function fetchWhoami(input) {
@@ -53,3 +59,20 @@ async function fetchWhoami(input) {
         signal: AbortSignal.timeout(15000),
     });
 }
+function readRequiredString(payload, fieldName) {
+    const value = payload[fieldName];
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`Invalid PostPlus auth response: ${fieldName} must be a non-empty string.`);
+    }
+    return value.trim();
+}
+function readNullableString(payload, fieldName) {
+    const value = payload[fieldName];
+    if (value === null) {
+        return null;
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid PostPlus auth response: ${fieldName} must be a string or null.`);
+    }
+    return value;
+}

package/build/client-compatibility.js

@@ -51,7 +51,7 @@ export function formatPostPlusClientUpgradeError(payload) {
         ? payload
         : {};
     const cliCommand = record.compatibility?.upgrade?.cli?.command ??
-        'npm install -g @postplus/cli';
+        'npm install -g @postplus/cli@latest';
     const skillsCommand = record.compatibility?.upgrade?.skills?.command ?? 'postplus update';
     const restart = record.compatibility?.upgrade?.restartAgentSession
         ? ' Then restart your agent session.'

package/build/doctor.js

@@ -2,6 +2,7 @@ import { resolveFreshRemoteAuth, } from './auth-session.js';
 import { buildPostPlusClientCompatibilityHeaders, formatPostPlusCompatibilityError, } from './client-compatibility.js';
 import { resolveHostedBaseUrl } from './hosted-release.js';
 import { formatLocalDependencyReport, generateLocalDependencyReport, } from './local-dependencies.js';
+import { readSubscriptionStatusField } from './subscription-status.js';
 function createPass(id, label, detail, severity = 'required') {
     return {
         id,
@@ -104,9 +105,7 @@ async function checkRemoteAuth(input) {
             : typeof payload.userId === 'string'
                 ? payload.userId
                 : 'unknown';
-        const subscription = typeof payload.subscriptionStatus === 'string'
-            ? payload.subscriptionStatus
-            : 'unknown';
+        const subscription = readSubscriptionStatusField(payload).label;
         return createPass('remote_auth', 'Remote auth', `Account ${accountId}; user ${user}; subscription ${subscription}`);
     }
     catch (error) {
@@ -137,9 +136,7 @@ async function checkHostedCapabilities(input) {
         if (payload.ok !== true || failedLabels.length > 0) {
             return createFail('hosted_capabilities', 'Hosted capabilities', `Not ready: ${failedLabels.join(', ') || 'unknown capability failure'}`, 'Check PostPlus Cloud provider configuration and subscription state.');
         }
-        const subscription = typeof payload.subscriptionStatus === 'string'
-            ? payload.subscriptionStatus
-            : 'unknown';
+        const subscription = readSubscriptionStatusField(payload).label;
         return createPass('hosted_capabilities', 'Hosted capabilities', `Ready (${capabilities.length} capability checks passed; subscription ${subscription})`);
     }
     catch (error) {

package/build/index.js

@@ -9,7 +9,7 @@ import { assertConfigFilePermissions } from './local-state.js';
 import { POSTPLUS_SKILLS_INSTALL_COMMAND, loadPublicSkillCatalog, } from './skill-catalog.js';
 import { runPostPlusSkillUninstall, runPostPlusSkillUpdate, } from './skill-management.js';
 import { formatStatusReport, generateStatusReport } from './status.js';
-import { refreshUpdateCheckCache } from './update-check.js';
+import { refreshUpdateCheckCache, runCliSelfUpdateIfOutdated, } from './update-check.js';
 function printAuthHelp() {
     process.stdout.write(`PostPlus CLI — auth commands
 
@@ -103,6 +103,10 @@ async function runVersion() {
     return 0;
 }
 async function runSkillUpdateCommand() {
+    const cliSelfUpdate = await runCliSelfUpdateIfOutdated();
+    if (cliSelfUpdate.updateAvailable) {
+        return cliSelfUpdate.exitCode ?? 1;
+    }
     const exitCode = await runPostPlusSkillUpdate();
     if (exitCode === 0) {
         await refreshUpdateCheckCache().catch(() => { });

package/build/local-dependencies.js

@@ -69,9 +69,12 @@ async function checkLocalDependency(dependency, skillIds, runDependencyCheck) {
 function buildLocalDependencyCommand(dependency) {
     const parts = dependency.split(':');
     if (parts.length === 1) {
+        const args = dependency === 'ffmpeg' || dependency === 'ffprobe'
+            ? ['-version']
+            : ['--version'];
         return {
             command: dependency,
-            args: ['--version'],
+            args,
         };
     }
     const [runtime, moduleName] = parts;

package/build/subscription-status.js

@@ -0,0 +1,27 @@
+export function readSubscriptionStatusField(payload, fieldName = 'subscriptionStatus') {
+    if (!Object.prototype.hasOwnProperty.call(payload, fieldName)) {
+        return {
+            label: 'unknown',
+            state: 'missing',
+        };
+    }
+    const value = payload[fieldName];
+    if (value === null) {
+        return {
+            label: 'none',
+            state: 'none',
+            value: null,
+        };
+    }
+    if (typeof value === 'string') {
+        return {
+            label: value,
+            state: 'string',
+            value,
+        };
+    }
+    return {
+        label: 'invalid',
+        state: 'invalid',
+    };
+}

package/build/update-check.js

@@ -1,12 +1,15 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { readCurrentCliVersion } from './client-compatibility.js';
+import { runInteractiveCommand as runDefaultInteractiveCommand, } from './command-runner.js';
 import { getPostPlusConfigDir, readManagedSkillBaseline, } from './local-state.js';
 import { POSTPLUS_SKILLS_REPO, loadPublicSkillCatalog, } from './skill-catalog.js';
 const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
 const UPDATE_CHECK_CACHE_FILE = 'update-check.json';
 const NPM_PACKAGE_NAME = '@postplus/cli';
 const NPM_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(NPM_PACKAGE_NAME)}/latest`;
+export const POSTPLUS_CLI_UPDATE_COMMAND = 'npm install -g @postplus/cli@latest';
+const POSTPLUS_CLI_UPDATE_ARGS = ['install', '-g', '@postplus/cli@latest'];
 export async function generateUpdateStatusReport(input = {}, dependencies = {
     fetchFn: fetch,
 }) {
@@ -68,7 +71,7 @@ export async function generateUpdateStatusReport(input = {}, dependencies = {
                 currentVersion,
                 latestVersion: null,
                 updateAvailable: false,
-                updateCommand: 'npm install -g @postplus/cli',
+                updateCommand: POSTPLUS_CLI_UPDATE_COMMAND,
             },
             skills: {
                 currentReleaseId: managedSkillBaseline.releaseId,
@@ -85,6 +88,49 @@ export async function refreshUpdateCheckCache() {
         force: true,
     });
 }
+export async function runCliSelfUpdateIfOutdated(dependencies = {}) {
+    const fetchFn = dependencies.fetchFn ?? fetch;
+    const runInteractiveCommand = dependencies.runInteractiveCommand ?? runDefaultInteractiveCommand;
+    const writeOutput = dependencies.writeOutput ?? ((message) => process.stdout.write(message));
+    const currentVersion = await readCurrentCliVersion();
+    const latestVersion = await fetchLatestCliVersion(fetchFn);
+    if (compareVersions(latestVersion, currentVersion) <= 0) {
+        return {
+            command: POSTPLUS_CLI_UPDATE_COMMAND,
+            currentVersion,
+            exitCode: null,
+            latestVersion,
+            updateAvailable: false,
+        };
+    }
+    writeOutput([
+        `PostPlus CLI ${currentVersion} is older than latest ${latestVersion}.`,
+        `Updating CLI: ${POSTPLUS_CLI_UPDATE_COMMAND}`,
+        '',
+    ].join('\n'));
+    const exitCode = await runInteractiveCommand('npm', POSTPLUS_CLI_UPDATE_ARGS);
+    if (exitCode === 0) {
+        writeOutput([
+            `PostPlus CLI updated to ${latestVersion}.`,
+            'Re-run `postplus update` to update skills with the new CLI process.',
+            '',
+        ].join('\n'));
+    }
+    else {
+        writeOutput([
+            `PostPlus CLI update failed with exit code ${exitCode}.`,
+            `Fix the npm install error, then run: ${POSTPLUS_CLI_UPDATE_COMMAND}`,
+            '',
+        ].join('\n'));
+    }
+    return {
+        command: POSTPLUS_CLI_UPDATE_COMMAND,
+        currentVersion,
+        exitCode,
+        latestVersion,
+        updateAvailable: true,
+    };
+}
 export function formatUpdateStatusReport(report) {
     const lines = ['PostPlus update status', ''];
     const cliMarker = report.cli.updateAvailable ? '[WARN]' : '[PASS]';
@@ -115,7 +161,7 @@ function buildUpdateReport(input) {
             latestVersion: input.cache.cli.latestVersion,
             updateAvailable: compareVersions(input.cache.cli.latestVersion, input.currentVersion) >
                 0,
-            updateCommand: 'npm install -g @postplus/cli',
+            updateCommand: POSTPLUS_CLI_UPDATE_COMMAND,
         },
         skills: {
             currentReleaseId: input.currentSkillsReleaseId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",
@@ -21,6 +21,7 @@
     "build/skill-catalog.js",
     "build/skill-management.js",
     "build/status.js",
+    "build/subscription-status.js",
     "build/update-check.js",
     "LICENSE",
     "NOTICE",