@postplus/cli 0.1.38 → 0.1.40

package/build/skill-management.js

@@ -1,9 +1,15 @@
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { writeCurrentCliVersionToLocalConfig } from './client-compatibility.js';
 import { runCommand, runInteractiveCommand } from './command-runner.js';
 import { clearManagedSkillBaseline, readManagedSkillBaseline, writeManagedSkillBaseline, } from './local-state.js';
 import { POSTPLUS_SKILLS_AGENT_TARGETS, formatPostPlusSkillsInstallCommand, resolvePostPlusSkillsSource, loadPublicSkillCatalog, } from './skill-catalog.js';
 import { clearUpdateCheckCache } from './update-check.js';
 const NPX_SKILLS = ['-y', 'skills'];
+const SKILLS_INSTALLER_GLOBAL_LOCK_PATH = ['.agents', '.skill-lock.json'];
+const SKILLS_INSTALLER_PROJECT_LOCK_PATH = 'skills-lock.json';
+const SKILLS_INSTALLER_POSTPLUS_SOURCE = 'postplusai/postplus-skills';
 const DEFAULT_SKILL_MUTATION_OPTIONS = {
     scope: 'global',
 };
@@ -12,8 +18,10 @@ export async function runPostPlusSkillUpdate(dependencies = {
 }, options = DEFAULT_SKILL_MUTATION_OPTIONS) {
     const catalog = await loadPublicSkillCatalog();
     const skillNames = catalog.skills.map((skill) => skill.skillId);
+    const releasedSkills = new Set(skillNames);
     const baseline = await readManagedSkillBaseline();
-    const retiredSkillNames = baseline.skillNames.filter((skillName) => !skillNames.includes(skillName));
+    const lockedSkillNames = await readPostPlusInstallerLockedSkillEntries(options.scope).then((entries) => entries.map((entry) => entry.name));
+    const retiredSkillNames = mergeSkillNames(baseline.skillNames, lockedSkillNames).filter((skillName) => !releasedSkills.has(skillName));
     if (skillNames.length === 0) {
         throw new Error('PostPlus public skill catalog has no released skills.');
     }
@@ -45,7 +53,8 @@ export async function runPostPlusSkillUninstall(dependencies = {
     const catalog = await loadPublicSkillCatalog();
     const skillNames = catalog.skills.map((skill) => skill.skillId);
     const baseline = await readManagedSkillBaseline();
-    const allKnownSkillNames = mergeSkillNames(skillNames, baseline.skillNames);
+    const lockedSkillNames = await readPostPlusInstallerLockedSkillEntries(options.scope).then((entries) => entries.map((entry) => entry.name));
+    const allKnownSkillNames = mergeSkillNames(mergeSkillNames(skillNames, baseline.skillNames), lockedSkillNames);
     if (allKnownSkillNames.length === 0) {
         throw new Error('PostPlus public skill catalog has no released skills.');
     }
@@ -96,9 +105,20 @@ async function inspectPostPlusSkillInstall(dependencies, options = {}) {
     const requiredSkillNames = catalog.skills.map((skill) => skill.skillId);
     const requiredSkills = new Set(requiredSkillNames);
     const baseline = await readManagedSkillBaseline();
-    const retiredManagedSkills = baseline.skillNames.filter((skillName) => !requiredSkills.has(skillName));
+    const baselineRetiredManagedSkills = baseline.skillNames.filter((skillName) => !requiredSkills.has(skillName));
     try {
         const installed = await listInstalledSkills(dependencies);
+        const baselineRetiredSkills = new Set(baselineRetiredManagedSkills);
+        const lockedSkills = new Set((await readPostPlusInstallerLockedSkillEntries()).map((entry) => `${entry.scope}:${entry.name}`));
+        const installedRetiredManagedSkills = [
+            ...new Set(installed
+                .filter((skill) => baselineRetiredSkills.has(skill.name) ||
+                lockedSkills.has(`${skill.scope}:${skill.name}`))
+                .map((skill) => skill.name)),
+        ]
+            .filter((skillName) => !requiredSkills.has(skillName))
+            .sort((a, b) => a.localeCompare(b));
+        const retiredManagedSkills = mergeSkillNames(baselineRetiredManagedSkills, installedRetiredManagedSkills);
         const postPlusInstalled = installed.filter((skill) => requiredSkills.has(skill.name));
         const installedNames = new Set(postPlusInstalled.map((skill) => skill.name));
         const missingSkills = [...requiredSkills].filter((skill) => !installedNames.has(skill));
@@ -110,7 +130,8 @@ async function inspectPostPlusSkillInstall(dependencies, options = {}) {
                 baseline,
                 releaseId: catalog.releaseId,
                 skillNames: requiredSkillNames,
-            })) {
+            }) &&
+            installedRetiredManagedSkills.length === 0) {
             await writeManagedSkillBaseline({
                 releaseId: catalog.releaseId,
                 skillNames: requiredSkillNames,
@@ -128,7 +149,8 @@ async function inspectPostPlusSkillInstall(dependencies, options = {}) {
         return {
             catalog,
             report: {
-                ok: missingSkills.length === 0,
+                ok: missingSkills.length === 0 &&
+                    installedRetiredManagedSkills.length === 0,
                 error: null,
                 installCommand: formatPostPlusSkillsInstallCommand(catalog.source),
                 installedCount: installedNames.size,
@@ -157,7 +179,7 @@ async function inspectPostPlusSkillInstall(dependencies, options = {}) {
                 managedSkillsReleaseId: baseline.releaseId,
                 missingSkills: [...requiredSkills],
                 requiredCount: requiredSkills.size,
-                retiredManagedSkills,
+                retiredManagedSkills: baselineRetiredManagedSkills,
                 scopes: [],
                 source: catalog.source,
                 updateCommand: formatPostPlusSkillUpdateCommand(),
@@ -212,6 +234,9 @@ export function formatSkillBaselineVerifyReport(report) {
     else {
         lines.push('  Verified baseline: unchanged');
     }
+    if (report.retiredManagedSkills.length > 0) {
+        lines.push(`  Retired managed skills: ${formatSkillList(report.retiredManagedSkills, 8)}`, `  Cleanup (global): ${report.updateCommand}`, `  Cleanup (current directory): ${formatPostPlusSkillUpdateCommand('current-directory')}`);
+    }
     if (report.missingSkills.length > 0) {
         lines.push(`  Missing: ${formatSkillList(report.missingSkills, 8)}`, `  Fix (global): ${report.installCommand}`, `  Fix (current directory): ${formatPostPlusSkillsInstallCommand(report.source, 'current-directory')}`);
     }
@@ -274,6 +299,106 @@ function haveSameSkillNames(left, right) {
     return (normalizedLeft.length === normalizedRight.length &&
         normalizedLeft.every((value, index) => value === normalizedRight[index]));
 }
+async function readPostPlusInstallerLockedSkillEntries(scope) {
+    const lockPaths = scope === 'global'
+        ? [{ path: getSkillsInstallerGlobalLockPath(), scope: 'global' }]
+        : scope === 'current-directory'
+            ? [
+                {
+                    path: getSkillsInstallerProjectLockPath(),
+                    scope: 'project',
+                },
+            ]
+            : [
+                {
+                    path: getSkillsInstallerProjectLockPath(),
+                    scope: 'project',
+                },
+                {
+                    path: getSkillsInstallerGlobalLockPath(),
+                    scope: 'global',
+                },
+            ];
+    const entries = await Promise.all(lockPaths.map((lock) => readPostPlusInstallerLockedSkillNamesFromPath(lock.path).then((skillNames) => skillNames.map((name) => ({
+        name,
+        scope: lock.scope,
+    })))));
+    return entries
+        .flat()
+        .sort((left, right) => left.scope.localeCompare(right.scope) ||
+        left.name.localeCompare(right.name));
+}
+async function readPostPlusInstallerLockedSkillNamesFromPath(lockPath) {
+    try {
+        const raw = await readFile(lockPath, 'utf8');
+        const payload = JSON.parse(raw);
+        if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+            return [];
+        }
+        const record = payload;
+        if (typeof record.version !== 'number') {
+            return [];
+        }
+        if (!record.skills || typeof record.skills !== 'object') {
+            return [];
+        }
+        return Object.entries(record.skills)
+            .filter(([, entry]) => isPostPlusSkillsInstallerLockEntry(entry))
+            .map(([skillName]) => skillName.trim())
+            .filter(Boolean)
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+function isPostPlusSkillsInstallerLockEntry(entry) {
+    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+        return false;
+    }
+    const record = entry;
+    const source = typeof record.source === 'string' ? record.source.trim() : '';
+    const sourceUrl = typeof record.sourceUrl === 'string' ? record.sourceUrl.trim() : '';
+    return (normalizeSkillsInstallerSource(source) ===
+        SKILLS_INSTALLER_POSTPLUS_SOURCE ||
+        normalizeSkillsInstallerSource(sourceUrl) ===
+            SKILLS_INSTALLER_POSTPLUS_SOURCE);
+}
+function normalizeSkillsInstallerSource(value) {
+    let normalized = value.trim().replace(/\\/g, '/');
+    if (normalized.length === 0) {
+        return '';
+    }
+    const sshMatch = normalized.match(/^git@[^:]+:(.+)$/);
+    if (sshMatch) {
+        normalized = sshMatch[1] ?? '';
+    }
+    else if (/^https?:\/\//i.test(normalized) || /^ssh:\/\//i.test(normalized)) {
+        try {
+            normalized = new URL(normalized).pathname.replace(/^\/+/, '');
+        }
+        catch {
+            return normalized.toLowerCase();
+        }
+    }
+    return normalized
+        .replace(/\.git$/i, '')
+        .replace(/\/+$/, '')
+        .toLowerCase();
+}
+function getSkillsInstallerGlobalLockPath() {
+    const xdgStateHome = process.env.XDG_STATE_HOME?.trim();
+    return xdgStateHome
+        ? join(xdgStateHome, 'skills', '.skill-lock.json')
+        : join(homedir(), ...SKILLS_INSTALLER_GLOBAL_LOCK_PATH);
+}
+function getSkillsInstallerProjectLockPath() {
+    return join(process.cwd(), SKILLS_INSTALLER_PROJECT_LOCK_PATH);
+}
 async function listInstalledSkills(dependencies) {
     const project = await listInstalledSkillsForScope(dependencies, []);
     const global = await listInstalledSkillsForScope(dependencies, ['--global']);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postplus/cli",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "packageManager": "pnpm@10.30.3+sha512.c961d1e0a2d8e354ecaa5166b822516668b7f44cb5bd95122d590dd81922f606f5473b6d23ec4a5be05e7fcd18e8488d47d978bbe981872f1145d06e9a740017",
   "type": "module",
   "description": "PostPlus CLI for PostPlus Cloud auth, status, and diagnostics.",
@@ -16,8 +16,9 @@
     "build/command-runner.js",
     "build/doctor.js",
     "build/hosted-domain-commands.js",
+    "build/generated/hosted-execution-manifest.generated.js",
+    "build/hosted-manifest-index.js",
     "build/hosted-release.js",
-    "build/hosted-schema-catalog.js",
     "build/hosted-request-schemas.js",
     "build/index.js",
     "build/local-dependencies.js",

package/build/hosted-schema-catalog.js

@@ -1,286 +0,0 @@
-// Generated from the PostPlus Cloud hosted catalog release gate.
-// Keep keys in sync with apps/web hosted capability and collection catalogs.
-export const RESEARCH_COLLECTION_HINTS = {
-    'google-trends-fast': {
-        queries: ['portable blender'],
-    },
-    'instagram-comments': {
-        directUrls: ['https://www.instagram.com/p/example/'],
-        resultsLimit: 5,
-    },
-    'instagram-email-search': {
-        Country: 'www',
-        Email_Type: '0',
-        Keyword: 'skincare creator',
-        Limit: '10',
-        social_network: 'instagram.com/',
-    },
-    'instagram-hashtags': {
-        hashtags: ['desksetup'],
-        resultsLimit: 3,
-    },
-    'instagram-posts': {
-        resultsLimit: 3,
-        username: ['openai'],
-    },
-    'instagram-profiles': {
-        resultsLimit: 3,
-        usernames: ['instagram'],
-    },
-    'instagram-search': {
-        searchLimit: 3,
-        searchTerms: ['skincare routine'],
-        searchType: 'user',
-    },
-    'tiktok-ads-top': {
-        include_analytics: true,
-        limit: 1,
-    },
-    'tiktok-comments': {
-        postURLs: ['https://www.tiktok.com/@example/video/1234567890'],
-        resultsPerPage: 5,
-    },
-    'tiktok-profiles': {
-        usernames: ['tiktok'],
-    },
-    'tiktok-related-videos': {
-        maxItems: 3,
-        postURLs: ['https://www.tiktok.com/@example/video/1234567890'],
-    },
-    'tiktok-users': {
-        maxItems: 5,
-        searchQueries: ['skincare creator'],
-    },
-    'tiktok-videos': {
-        maxItems: 3,
-        proxyCountryCode: 'US',
-        queries: ['portable blender'],
-        searchSection: '/video',
-    },
-    'youtube-channel-summary': {
-        channels: ['@Google'],
-        includeChannelInfo: true,
-        includeVideos: false,
-        maxVideosPerChannel: 0,
-    },
-    'youtube-comments': {
-        maxComments: 10,
-        startUrls: ['https://www.youtube.com/watch?v=dQw4w9WgXcQ'],
-    },
-    'youtube-video-download': {
-        urls: ['https://www.youtube.com/watch?v=dQw4w9WgXcQ'],
-    },
-};
-export const PUBLIC_CONTENT_SOURCE_HINTS = {
-    'facebook-group-posts': [
-        {
-            url: 'https://www.facebook.com/groups/example',
-        },
-    ],
-    'facebook-post-by-url': [
-        {
-            url: 'https://www.facebook.com/openai/posts/example',
-        },
-    ],
-    'facebook-profile-posts': [
-        {
-            url: 'https://www.facebook.com/openai',
-        },
-    ],
-    'youtube-videos': [
-        {
-            url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
-        },
-    ],
-};
-export const PUBLIC_CONTENT_DISCOVERY_TOOL_HINTS = {
-    'web-search': {
-        limit: 5,
-        query: 'portable blender reviews',
-    },
-};
-export const MEDIA_ENDPOINT_HINTS = {
-    'image-gpt-image-2-edit': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Edit the reference into a clean product-style vertical image.',
-        quality: 'medium',
-        size: '1024x1024',
-    },
-    'image-gpt-image-2-text': {
-        aspect_ratio: '9:16',
-        prompt: 'A realistic vertical product image on a clean white desk.',
-        quality: 'medium',
-        size: '1024x1024',
-    },
-    'image-nano-banana-2-edit': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Edit the reference into a clean product-style vertical image.',
-        quality: 'medium',
-        size: '1024x1024',
-    },
-    'image-nano-banana-2-text': {
-        aspect_ratio: '9:16',
-        prompt: 'A realistic vertical product image on a clean white desk.',
-        quality: 'medium',
-        size: '1024x1024',
-    },
-    'image-nano-banana-pro-edit-1k': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Edit the reference into a clean product-style vertical image.',
-        resolution: '1k',
-    },
-    'image-nano-banana-pro-edit-2k': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Edit the reference into a clean product-style vertical image.',
-        resolution: '2k',
-    },
-    'image-nano-banana-pro-edit-4k': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Edit the reference into a clean product-style vertical image.',
-        resolution: '4k',
-    },
-    'image-nano-banana-pro-text-1k': {
-        aspect_ratio: '9:16',
-        prompt: 'A realistic vertical product image on a clean white desk.',
-        resolution: '1k',
-    },
-    'image-nano-banana-pro-text-2k': {
-        aspect_ratio: '9:16',
-        prompt: 'A realistic vertical product image on a clean white desk.',
-        resolution: '2k',
-    },
-    'image-nano-banana-pro-text-4k': {
-        aspect_ratio: '9:16',
-        prompt: 'A realistic vertical product image on a clean white desk.',
-        resolution: '4k',
-    },
-    'image-seedream-v5-lite-edit': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Edit the reference into a clean product-style vertical image.',
-        size: '1024x1024',
-    },
-    'image-seedream-v5-lite-edit-sequential': {
-        inputUrls: ['https://example.com/reference-image.png'],
-        prompt: 'Create a coherent sequence of edited product reference images.',
-        size: '1024x1024',
-    },
-    'image-seedream-v5-lite-sequential': {
-        aspect_ratio: '9:16',
-        prompt: 'Create a coherent sequence of vertical product images.',
-        size: '1024x1024',
-    },
-    'image-seedream-v5-lite-text': {
-        aspect_ratio: '9:16',
-        prompt: 'A realistic vertical product image on a clean white desk.',
-        size: '1024x1024',
-    },
-    'transcription-whisper': {
-        audio: 'https://example.com/input-audio.mp3',
-        language: 'en',
-        response_format: 'verbose_json',
-        timestamp_granularities: ['segment'],
-    },
-    'transcription-whisper-turbo': {
-        audio: 'https://example.com/input-audio.mp3',
-        language: 'en',
-        response_format: 'verbose_json',
-        timestamp_granularities: ['segment'],
-    },
-    'transcription-whisper-with-video': {
-        language: 'en',
-        response_format: 'verbose_json',
-        timestamp_granularities: ['segment'],
-        video: 'https://example.com/input-video.mp4',
-    },
-    'video-infinitetalk': {
-        audio: 'https://example.com/voiceover.wav',
-        image: 'https://example.com/persona.png',
-        prompt: 'Talking-head delivery in a natural vertical social ad style.',
-    },
-    'video-kling-v2-6-pro-motion-control': {
-        character_orientation: 'image',
-        image: 'https://example.com/subject.png',
-        video: 'https://example.com/reference-motion.mp4',
-    },
-    'video-kling-v3-0-pro-image': {
-        duration: 5,
-        image: 'https://example.com/start-frame.png',
-        prompt: 'Animate the product in a clean realistic vertical scene.',
-        sound: false,
-    },
-    'video-kling-v3-0-pro-text': {
-        aspect_ratio: '9:16',
-        duration: 5,
-        prompt: 'A realistic vertical short-form product reveal.',
-        sound: false,
-    },
-    'video-kling-v3-0-std-image': {
-        duration: 5,
-        image: 'https://example.com/start-frame.png',
-        prompt: 'Animate the product in a clean realistic vertical scene.',
-        sound: false,
-    },
-    'video-kling-v3-0-std-text': {
-        aspect_ratio: '9:16',
-        duration: 5,
-        prompt: 'A realistic vertical short-form product reveal.',
-        sound: false,
-    },
-    'video-wanx2-1-i2v-turbo': {
-        aspect_ratio: '9:16',
-        duration: 5,
-        image: 'https://example.com/start-frame.png',
-        prompt: 'A realistic vertical short-form product reveal.',
-        resolution: '720p',
-    },
-    'video-wanx2-1-t2v-turbo': {
-        aspect_ratio: '9:16',
-        duration: 5,
-        prompt: 'A realistic vertical short-form product reveal.',
-        resolution: '720p',
-    },
-    'video-seedance-2-image': {
-        duration: 5,
-        image: 'https://example.com/start-frame.png',
-        prompt: 'A realistic vertical short-form product reveal.',
-        resolution: '720p',
-    },
-    'video-seedance-2-image-turbo': {
-        duration: 5,
-        image: 'https://example.com/start-frame.png',
-        prompt: 'A realistic vertical short-form product reveal.',
-        resolution: '720p',
-    },
-    'video-seedance-2-text': {
-        duration: 5,
-        prompt: 'A realistic vertical short-form product reveal.',
-        resolution: '720p',
-    },
-    'video-seedance-2-text-turbo': {
-        duration: 5,
-        prompt: 'A realistic vertical short-form product reveal.',
-        resolution: '720p',
-    },
-    'voice-qwen3-clone': {
-        reference_audio: 'https://example.com/reference-voice.wav',
-        text: 'Short voiceover line to synthesize.',
-    },
-    'voice-qwen3-design': {
-        language: 'en',
-        text: 'Short voiceover line to synthesize.',
-        voiceDescription: 'Warm, clear, natural creator voice.',
-    },
-};
-export const VIDEO_ANALYSIS_MODEL_HINTS = {
-    'gemini-video-analysis': {
-        contents: [
-            {
-                parts: [
-                    {
-                        text: 'Analyze this short video and return concise creative observations.',
-                    },
-                ],
-            },
-        ],
-    },
-};