@postplus/cli 0.1.21 → 0.1.22

package/build/client-compatibility.js

@@ -0,0 +1,69 @@
+import { readFile } from 'node:fs/promises';
+import { readLocalConfig, updateLocalConfig } from './local-state.js';
+export const POSTPLUS_CLIENT_CONTRACT_VERSION = 1;
+export const POSTPLUS_CLIENT_RUNTIME = 'postplus-cli';
+export const POSTPLUS_CLIENT_COMPATIBILITY_HEADERS = {
+    cliVersion: 'x-postplus-cli-version',
+    contractVersion: 'x-postplus-client-contract-version',
+    runtime: 'x-postplus-client-runtime',
+    skillCatalogRevision: 'x-postplus-skill-catalog-revision',
+    skillName: 'x-postplus-skill-name',
+};
+export async function buildPostPlusClientCompatibilityHeaders(input = {}) {
+    const [cliVersion, config] = await Promise.all([
+        readCurrentCliVersion(),
+        readLocalConfig(),
+    ]);
+    const headers = {
+        [POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.cliVersion]: cliVersion,
+        [POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.contractVersion]: String(POSTPLUS_CLIENT_CONTRACT_VERSION),
+        [POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.runtime]: POSTPLUS_CLIENT_RUNTIME,
+    };
+    const skillCatalogRevision = config?.managedSkills?.revision?.trim();
+    const skillName = input.skillName?.trim();
+    if (skillCatalogRevision) {
+        headers[POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.skillCatalogRevision] =
+            skillCatalogRevision;
+    }
+    if (skillName) {
+        headers[POSTPLUS_CLIENT_COMPATIBILITY_HEADERS.skillName] = skillName;
+    }
+    return headers;
+}
+export async function writeCurrentCliVersionToLocalConfig() {
+    const cliVersion = await readCurrentCliVersion();
+    await updateLocalConfig((current) => ({
+        ...(current ?? {}),
+        cliVersion,
+    }));
+}
+export async function readCurrentCliVersion() {
+    const packageJsonPath = new URL('../package.json', import.meta.url);
+    const raw = await readFile(packageJsonPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version !== 'string' || !parsed.version.trim()) {
+        throw new Error('Could not read the current PostPlus CLI version.');
+    }
+    return parsed.version.trim();
+}
+export function formatPostPlusClientUpgradeError(payload) {
+    const record = payload && typeof payload === 'object' && !Array.isArray(payload)
+        ? payload
+        : {};
+    const cliCommand = record.compatibility?.upgrade?.cli?.command ??
+        'npm install -g @postplus/cli';
+    const skillsCommand = record.compatibility?.upgrade?.skills?.command ?? 'postplus update';
+    const restart = record.compatibility?.upgrade?.restartAgentSession
+        ? ' Then restart your agent session.'
+        : '';
+    return [
+        typeof record.error === 'string' && record.error.trim().length > 0
+            ? record.error.trim()
+            : 'Your PostPlus CLI or PostPlus skills are out of date.',
+        `Update CLI: ${cliCommand}.`,
+        `Update skills: ${skillsCommand}.`,
+        restart.trim(),
+    ]
+        .filter(Boolean)
+        .join(' ');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",
@@ -11,6 +11,7 @@
     "build/auth-session.js",
     "build/auth-validate.js",
     "build/auth.js",
+    "build/client-compatibility.js",
     "build/command-runner.js",
     "build/doctor.js",
     "build/hosted-release.js",