@postplus/cli 0.1.19 → 0.1.20

package/build/doctor.js

@@ -1,21 +1,24 @@
 import { resolveFreshRemoteAuth, } from './auth-session.js';
 import { resolveHostedBaseUrl } from './hosted-release.js';
 import { formatLocalDependencyReport, generateLocalDependencyReport, } from './local-dependencies.js';
-function createPass(id, label, detail) {
+function createPass(id, label, detail, severity = 'required') {
     return {
         id,
         label,
         status: 'pass',
+        severity,
         detail,
     };
 }
-function createFail(id, label, detail, fix) {
+function createFail(id, label, detail, fix, input = {}) {
     return {
         id,
         label,
         status: 'fail',
+        severity: input.severity ?? 'required',
         detail,
         fix,
+        metadata: input.metadata,
     };
 }
 export async function generateDoctorReport() {
@@ -50,7 +53,19 @@ async function checkLocalDependencies() {
         const report = await generateLocalDependencyReport();
         const detail = formatLocalDependencyReport(report);
         if (!report.ok) {
-            return createFail('local_dependencies', 'Local dependencies', detail, 'Run the affected PostPlus skill in a local agent. The installed postplus-shared rules tell the agent how to bootstrap approved missing media dependencies.');
+            return createFail('local_dependencies', 'Task-specific local media dependencies', detail, 'Run the affected PostPlus skill in a local agent. The installed postplus-shared rules tell the agent how to bootstrap approved missing media dependencies.', {
+                severity: 'task_specific',
+                metadata: {
+                    bootstrapRule: 'postplus-shared',
+                    missingDependencies: report.checks
+                        .filter((check) => !check.ok)
+                        .map((check) => ({
+                        dependency: check.dependency,
+                        detail: check.detail,
+                        skillIds: check.skillIds,
+                    })),
+                },
+            });
         }
         return createPass('local_dependencies', 'Local dependencies', detail);
     }
@@ -61,9 +76,11 @@ async function checkLocalDependencies() {
     }
 }
 function buildDoctorReport(checks) {
+    const requiredOk = checks.every((check) => check.severity !== 'required' || check.status === 'pass');
     return {
         schemaVersion: 1,
         ok: checks.every((check) => check.status === 'pass'),
+        requiredOk,
         checks,
     };
 }
@@ -183,12 +200,20 @@ function requestWithAuth(input, path) {
 export function formatDoctorReport(report) {
     const lines = ['PostPlus CLI doctor', ''];
     for (const check of report.checks) {
-        const marker = check.status === 'pass' ? '[PASS]' : '[FAIL]';
+        const marker = check.status === 'pass'
+            ? '[PASS]'
+            : check.severity === 'task_specific'
+                ? '[WARN]'
+                : '[FAIL]';
         lines.push(`${marker} ${check.label}: ${check.detail}`);
         if (check.fix) {
             lines.push(`  Fix: ${check.fix}`);
         }
     }
-    lines.push('', report.ok ? 'Doctor passed.' : 'Doctor failed.');
+    lines.push('', report.ok
+        ? 'Doctor passed.'
+        : report.requiredOk
+            ? 'Doctor incomplete: task-specific checks need attention.'
+            : 'Doctor failed.');
     return lines.join('\n');
 }

package/build/index.js

@@ -8,7 +8,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 { readCurrentCliVersion, refreshUpdateCheckCache, } from './update-check.js';
 function printAuthHelp() {
     process.stdout.write(`PostPlus CLI — auth commands
 
@@ -41,6 +41,7 @@ Usage:
   postplus uninstall
   postplus list [--json]
   postplus status [--json]
+  postplus version
   postplus help
 
 Skills:
@@ -96,6 +97,10 @@ async function runList(json) {
     process.stdout.write(`${lines.join('\n')}\n`);
     return 0;
 }
+async function runVersion() {
+    process.stdout.write(`${await readCurrentCliVersion()}\n`);
+    return 0;
+}
 async function runSkillUpdateCommand() {
     const exitCode = await runPostPlusSkillUpdate();
     if (exitCode === 0) {
@@ -172,6 +177,11 @@ async function main() {
             printHelp();
             process.exitCode = 0;
             return;
+        case '--version':
+        case '-v':
+        case 'version':
+            process.exitCode = await runVersion();
+            return;
         case 'help': {
             const [helpTopic] = rest;
             if (helpTopic === 'auth') {

package/build/skill-catalog.js

@@ -23,7 +23,8 @@ export async function loadPublicSkillCatalog(fetchFn = fetch) {
     if (!response.ok) {
         throw new Error(`Failed to load PostPlus skill catalog (${response.status}): ${response.statusText}`);
     }
-    const payload = (await response.json());
+    const raw = await response.text();
+    const payload = parseJsonResponse(raw, POSTPLUS_SKILLS_CATALOG_URL);
     const catalog = parsePublicSkillCatalog(payload);
     return {
         ...catalog,
@@ -33,6 +34,20 @@ export async function loadPublicSkillCatalog(fetchFn = fetch) {
         listCommand: POSTPLUS_SKILLS_LIST_COMMAND,
     };
 }
+function parseJsonResponse(raw, url) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const trimmed = raw.trimStart();
+        if (trimmed.startsWith('<')) {
+            throw new Error(`PostPlus public skill catalog returned HTML instead of JSON: ${url}`);
+        }
+        throw new Error(error instanceof Error
+            ? `PostPlus public skill catalog returned invalid JSON: ${error.message}`
+            : 'PostPlus public skill catalog returned invalid JSON.');
+    }
+}
 function parsePublicSkillCatalog(payload) {
     if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
         throw new Error('PostPlus public skill catalog is invalid.');

package/build/skill-management.js

@@ -144,10 +144,8 @@ function mergeSkillNames(left, right) {
     return [...new Set([...left, ...right])].sort((a, b) => a.localeCompare(b));
 }
 async function listInstalledSkills(dependencies) {
-    const [project, global] = await Promise.all([
-        listInstalledSkillsForScope(dependencies, []),
-        listInstalledSkillsForScope(dependencies, ['--global']),
-    ]);
+    const project = await listInstalledSkillsForScope(dependencies, []);
+    const global = await listInstalledSkillsForScope(dependencies, ['--global']);
     const byKey = new Map();
     for (const skill of [...project, ...global]) {
         byKey.set(`${skill.scope}:${skill.name}:${skill.path}`, skill);

package/build/status.js

@@ -18,7 +18,7 @@ export async function generateStatusReportWithDependencies(dependencies = {}) {
     ]);
     return {
         schemaVersion: 1,
-        ok: doctor.ok && auth.ok && skills.ok && updates.ok,
+        ok: doctor.requiredOk && auth.ok && skills.ok && updates.ok,
         doctor,
         auth,
         skills,
@@ -26,10 +26,15 @@ export async function generateStatusReportWithDependencies(dependencies = {}) {
     };
 }
 export function formatStatusReport(report) {
+    const taskSpecificChecksNeedAttention = report.doctor.requiredOk && !report.doctor.ok;
     return [
         'PostPlus CLI status',
         '',
-        `Overall: ${report.ok ? 'OK' : 'INCOMPLETE'}`,
+        `Overall: ${report.ok
+            ? taskSpecificChecksNeedAttention
+                ? 'OK (task-specific checks need attention)'
+                : 'OK'
+            : 'INCOMPLETE'}`,
         '',
         formatDoctorReport(report.doctor),
         '',

package/build/update-check.js

@@ -125,7 +125,7 @@ function buildUpdateReport(input) {
         warning: null,
     };
 }
-async function readCurrentCliVersion() {
+export async function readCurrentCliVersion() {
     const packageJsonPath = new URL('../package.json', import.meta.url);
     const raw = await readFile(packageJsonPath, 'utf8');
     const parsed = JSON.parse(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",