@pulse-editor/cli 0.1.1-beta.9 → 0.1.2

package/dist/components/commands/publish.js

@@ -5,12 +5,15 @@ import { checkToken, getToken } from '../../lib/token.js';
 import Spinner from 'ink-spinner';
 import fs from 'fs';
 import { $ } from 'execa';
+import { publishApp } from '../../lib/backend/publish-app.js';
 export default function Publish({ cli }) {
     const [isInProjectDir, setIsInProjectDir] = useState(false);
     const [isCheckingAuth, setIsCheckingAuth] = useState(true);
     const [isAuthenticated, setIsAuthenticated] = useState(false);
     const [isBuilding, setIsBuilding] = useState(false);
     const [isBuildingError, setIsBuildingError] = useState(false);
+    const [isZipping, setIsZipping] = useState(false);
+    const [isZippingError, setIsZippingError] = useState(false);
     const [isPublishing, setIsPublishing] = useState(false);
     const [isPublishingError, setIsPublishingError] = useState(false);
     const [isPublished, setIsPublished] = useState(false);
@@ -45,56 +48,39 @@ export default function Publish({ cli }) {
     // Build the extension
     useEffect(() => {
         async function buildExtension() {
-            setIsBuilding(true);
-            try {
-                await $ `npm run build`;
-            }
-            catch (error) {
-                setIsBuildingError(true);
-                setIsBuilding(false);
-                setFailureMessage('Build failed. Please run `npm run build` to see the error.');
-                return;
+            if (cli.flags.build) {
+                setIsBuilding(true);
+                try {
+                    await $ `npm run build`;
+                }
+                catch (error) {
+                    setIsBuildingError(true);
+                    setFailureMessage('Build failed. Please run `npm run build` to see the error.');
+                    return;
+                }
+                finally {
+                    setIsBuilding(false);
+                }
             }
+            setIsZipping(true);
             // Zip the dist folder
             try {
-                await $({ cwd: 'dist' }) `zip -r ../node_modules/@pulse-editor/dist.zip *`;
+                await $({ cwd: 'dist' }) `zip -r ../node_modules/@pulse-editor/dist.zip .`;
             }
             catch (error) {
-                setIsBuildingError(true);
-                setIsBuilding(false);
-                setFailureMessage('Failed to zip the build output.');
+                setIsZippingError(true);
+                setFailureMessage('Failed to zip the build output. ' + error.message);
                 return;
             }
             finally {
-                setIsBuilding(false);
+                setIsZipping(false);
             }
             await publishExtension();
         }
         async function publishExtension() {
             setIsPublishing(true);
-            // Read pulse.config.json for visibility
-            const config = JSON.parse(fs.readFileSync('./dist/client/pulse.config.json', 'utf-8'));
-            const visibility = config.visibility;
-            // Upload the zip file to the server
             try {
-                const formData = new FormData();
-                const buffer = fs.readFileSync('./node_modules/@pulse-editor/dist.zip');
-                // @ts-ignore Create a Blob from the buffer
-                const blob = new Blob([buffer], {
-                    type: 'application/zip',
-                });
-                formData.append('file', blob, 'dist.zip');
-                formData.append('visibility', visibility);
-                // Send the file to the server
-                const res = await fetch(cli.flags.stage
-                    ? 'https://localhost:8080/api/app/publish'
-                    : 'https://pulse-editor.com/api/app/publish', {
-                    method: 'POST',
-                    headers: {
-                        Authorization: `Bearer ${getToken(cli.flags.stage)}`,
-                    },
-                    body: formData,
-                });
+                const res = await publishApp(cli.flags.stage);
                 if (res.status === 200) {
                     setIsPublished(true);
                 }
@@ -122,5 +108,5 @@ export default function Publish({ cli }) {
             buildExtension();
         }
     }, [isAuthenticated]);
-    return (_jsx(_Fragment, { children: !isInProjectDir ? (_jsx(Text, { color: 'redBright', children: "\u26D4 The current directory does not contain a Pulse Editor project." })) : isCheckingAuth ? (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking authentication..." })] })) : isAuthenticated ? (_jsxs(_Fragment, { children: [isBuilding && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Building..." })] })), isBuildingError && (_jsx(Text, { color: 'redBright', children: "\u274C Error building the extension. Please run `npm run build` to see the error." })), isPublishing && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Publishing..." })] })), isPublishingError && (_jsxs(_Fragment, { children: [_jsx(Text, { color: 'redBright', children: "\u274C Failed to publish extension." }), failureMessage && (_jsxs(Text, { color: 'redBright', children: ["Error: ", failureMessage] }))] })), isPublished && (_jsx(Text, { color: 'greenBright', children: "\u2705 Extension published successfully." }))] })) : (_jsxs(Text, { children: ["You are not authenticated or your access token is invalid. Publishing to Extension Marketplace is in Beta access. Please visit", _jsx(Text, { color: 'blueBright', children: " https://pulse-editor.com/beta " }), "to apply for Beta access."] })) }));
+    return (_jsx(_Fragment, { children: !isInProjectDir ? (_jsx(Text, { color: 'redBright', children: "\u26D4 The current directory does not contain a Pulse Editor project." })) : isCheckingAuth ? (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking authentication..." })] })) : !isAuthenticated ? (_jsxs(Text, { children: ["You are not authenticated or your access token is invalid. Publishing to Extension Marketplace is in Beta access. Please visit", _jsx(Text, { color: 'blueBright', children: " https://pulse-editor.com/beta " }), "to apply for Beta access."] })) : (_jsxs(_Fragment, { children: [isBuilding && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Building..." })] })), isBuildingError && (_jsx(Text, { color: 'redBright', children: "\u274C Error building the extension. Please run `npm run build` to see the error." })), isZipping && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Compressing build..." })] })), isZippingError && (_jsxs(Text, { color: 'redBright', children: ["\u274C Error zipping the build output. ", failureMessage] })), isPublishing && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Publishing..." })] })), isPublishingError && (_jsxs(_Fragment, { children: [_jsx(Text, { color: 'redBright', children: "\u274C Failed to publish extension." }), failureMessage && (_jsxs(Text, { color: 'redBright', children: ["Error: ", failureMessage] }))] })), isPublished && (_jsx(Text, { color: 'greenBright', children: "\u2705 Extension published successfully." }))] })) }));
 }

package/dist/components/commands/{start copy.d.ts → skill.d.ts}

@@ -1,5 +1,5 @@
 import { Result } from 'meow';
 import { Flags } from '../../lib/cli-flags.js';
-export default function Start({ cli }: {
+export default function Skill({ cli }: {
     cli: Result<Flags>;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/components/commands/skill.js

@@ -0,0 +1,230 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Box, Text, useInput } from 'ink';
+import Spinner from 'ink-spinner';
+import fs from 'fs';
+import path from 'path';
+import { checkToken, getToken } from '../../lib/token.js';
+import { getBackendUrl } from '../../lib/backend-url.js';
+// ---------------------------------------------------------------------------
+// MultilineInput
+// ---------------------------------------------------------------------------
+function MultilineInput({ onSubmit, focus, }) {
+    const [lines, setLines] = useState(['']);
+    useInput((input, key) => {
+        // Regular Enter (\r) → submit
+        // Shift+Enter → terminals send \n (0x0A) rather than setting key.shift+key.return
+        if (input === '\n') {
+            setLines(prev => [...prev, '']);
+            return;
+        }
+        if (key.return) {
+            const value = lines.join('\n').trim();
+            if (value)
+                onSubmit(value);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setLines(prev => {
+                const next = [...prev];
+                const last = next[next.length - 1];
+                if (last.length > 0) {
+                    next[next.length - 1] = last.slice(0, -1);
+                }
+                else if (next.length > 1) {
+                    next.pop();
+                }
+                return next;
+            });
+            return;
+        }
+        if (input) {
+            setLines(prev => {
+                const next = [...prev];
+                next[next.length - 1] += input;
+                return next;
+            });
+        }
+    }, { isActive: focus });
+    return (_jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: lines.map((line, i) => (_jsxs(Text, { children: [line, i === lines.length - 1 ? _jsx(Text, { backgroundColor: "white", children: " " }) : ''] }, i))) }));
+}
+// ---------------------------------------------------------------------------
+// SkillCreate
+// ---------------------------------------------------------------------------
+function SkillCreate({ cli }) {
+    const [skillName, setSkillName] = useState(cli.input[2]);
+    const [description, setDescription] = useState(cli.flags.description);
+    const [status, setStatus] = useState();
+    const [errorMessage, setErrorMessage] = useState('');
+    const [chunkCount, setChunkCount] = useState(0);
+    // Once both fields are collected, authenticate
+    useEffect(() => {
+        if (!skillName || !description)
+            return;
+        setStatus('authenticating');
+    }, [skillName, description]);
+    useEffect(() => {
+        if (status !== 'authenticating')
+            return;
+        async function authenticate() {
+            const token = getToken(cli.flags.stage);
+            if (token && (await checkToken(token, cli.flags.stage))) {
+                setStatus('generating');
+            }
+            else {
+                setErrorMessage('You are not authenticated. Please run pulse login first.');
+                setStatus('error');
+                setTimeout(() => process.exit(1), 0);
+            }
+        }
+        authenticate();
+    }, [status]);
+    useEffect(() => {
+        if (status !== 'generating' || !skillName || !description)
+            return;
+        async function generate() {
+            const token = getToken(cli.flags.stage);
+            const backendUrl = getBackendUrl(cli.flags.stage);
+            try {
+                const res = await fetch(`${backendUrl}/api/inference/cli/skill/create`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+                    },
+                    body: JSON.stringify({ description }),
+                });
+                if (!res.ok) {
+                    setErrorMessage(`Server returned error code ${res.status}.`);
+                    setStatus('error');
+                    setTimeout(() => process.exit(), 0);
+                    return;
+                }
+                const reader = res.body?.getReader();
+                const decoder = new TextDecoder();
+                let code = '';
+                if (reader) {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        code += decoder.decode(value, { stream: true });
+                        setChunkCount(n => n + 1);
+                    }
+                }
+                const skillDir = path.join(process.cwd(), 'src', 'skill', skillName);
+                fs.mkdirSync(skillDir, { recursive: true });
+                fs.writeFileSync(path.join(skillDir, 'action.ts'), code, 'utf-8');
+                setStatus('done');
+                setTimeout(() => process.exit(), 0);
+            }
+            catch (err) {
+                setErrorMessage(err?.message ?? String(err));
+                setStatus('error');
+                setTimeout(() => process.exit(), 0);
+            }
+        }
+        generate();
+    }, [status]);
+    return (_jsxs(_Fragment, { children: [!skillName && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Skill name:" }), _jsx(MultilineInput, { onSubmit: value => setTimeout(() => setSkillName(value), 0), focus: !skillName })] })), skillName && !description && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["What should this skill do?", ' ', _jsx(Text, { color: "blueBright", children: "(Shift+Enter for newline, Enter to confirm)" })] }), _jsx(MultilineInput, { onSubmit: value => setTimeout(() => setDescription(value), 0), focus: !!skillName && !description })] })), status === 'authenticating' && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking authentication..." })] })), status === 'generating' && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsxs(Text, { children: [" Generating skill action for \"", skillName, "\"... "] }), _jsxs(Text, { color: "blueBright", children: ["[", chunkCount, " chunks received]"] })] })), status === 'done' && (_jsxs(Text, { color: "greenBright", children: ["\u2705 Skill action created at src/skill/", skillName, "/action.ts"] })), status === 'error' && (_jsxs(Text, { color: "redBright", children: ["\u274C ", errorMessage] }))] }));
+}
+// ---------------------------------------------------------------------------
+// SkillFix
+// ---------------------------------------------------------------------------
+function SkillFix({ cli }) {
+    const [skillName, setSkillName] = useState(cli.input[2]);
+    const [status, setStatus] = useState();
+    const [errorMessage, setErrorMessage] = useState('');
+    const [chunkCount, setChunkCount] = useState(0);
+    // Once skill name is collected, authenticate
+    useEffect(() => {
+        if (!skillName)
+            return;
+        setStatus('authenticating');
+    }, [skillName]);
+    useEffect(() => {
+        if (status !== 'authenticating')
+            return;
+        async function authenticate() {
+            const token = getToken(cli.flags.stage);
+            if (token && (await checkToken(token, cli.flags.stage))) {
+                // Validate file exists before fixing
+                const actionPath = path.join(process.cwd(), 'src', 'skill', skillName, 'action.ts');
+                if (!fs.existsSync(actionPath)) {
+                    setErrorMessage(`Action file not found: src/skill/${skillName}/action.ts`);
+                    setStatus('error');
+                    setTimeout(() => process.exit(), 0);
+                    return;
+                }
+                setStatus('fixing');
+            }
+            else {
+                setErrorMessage('You are not authenticated. Please run pulse login first.');
+                setStatus('error');
+                setTimeout(() => process.exit(1), 0);
+            }
+        }
+        authenticate();
+    }, [status]);
+    useEffect(() => {
+        if (status !== 'fixing' || !skillName)
+            return;
+        async function fix() {
+            const actionPath = path.join(process.cwd(), 'src', 'skill', skillName, 'action.ts');
+            const code = fs.readFileSync(actionPath, 'utf-8');
+            const token = getToken(cli.flags.stage);
+            const backendUrl = getBackendUrl(cli.flags.stage);
+            try {
+                const res = await fetch(`${backendUrl}/api/inference/cli/skill/fix`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+                    },
+                    body: JSON.stringify({ code }),
+                });
+                if (!res.ok) {
+                    setErrorMessage(`Server returned error code ${res.status}.`);
+                    setStatus('error');
+                    setTimeout(() => process.exit(), 0);
+                    return;
+                }
+                const reader = res.body?.getReader();
+                const decoder = new TextDecoder();
+                let fixed = '';
+                if (reader) {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        fixed += decoder.decode(value, { stream: true });
+                        setChunkCount(n => n + 1);
+                    }
+                }
+                fs.writeFileSync(actionPath, fixed, 'utf-8');
+                setStatus('done');
+                setTimeout(() => process.exit(), 0);
+            }
+            catch (err) {
+                setErrorMessage(err?.message ?? String(err));
+                setStatus('error');
+                setTimeout(() => process.exit(), 0);
+            }
+        }
+        fix();
+    }, [status]);
+    return (_jsxs(_Fragment, { children: [!skillName && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Action name:" }), _jsx(MultilineInput, { onSubmit: value => setTimeout(() => setSkillName(value), 0), focus: !skillName })] })), status === 'authenticating' && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking authentication..." })] })), status === 'fixing' && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsxs(Text, { children: [" Fixing JSDoc for skill \"", skillName, "\"... "] }), _jsxs(Text, { color: "blueBright", children: ["[", chunkCount, " chunks received]"] })] })), status === 'done' && (_jsxs(Text, { color: "greenBright", children: ["\u2705 JSDoc fixed and saved to src/skill/", skillName, "/action.ts"] })), status === 'error' && (_jsxs(Text, { color: "redBright", children: ["\u274C ", errorMessage] }))] }));
+}
+// ---------------------------------------------------------------------------
+// Skill (top-level router)
+// ---------------------------------------------------------------------------
+export default function Skill({ cli }) {
+    const subCommand = cli.input[1];
+    if (subCommand === 'create') {
+        return _jsx(SkillCreate, { cli: cli });
+    }
+    if (subCommand === 'fix') {
+        return _jsx(SkillFix, { cli: cli });
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs(Text, { color: "redBright", children: ["Unknown subcommand: ", subCommand ?? '(none)'] }), _jsxs(Text, { children: ["Available subcommands:", '\n', '  ', "pulse skill create ", '<skill-name>', " --description \"", '<description>', "\"", '\n', '  ', "pulse skill fix ", '<action-name>'] })] }));
+}

package/dist/components/commands/{preview copy.d.ts → upgrade.d.ts}

@@ -1,5 +1,5 @@
 import { Result } from 'meow';
 import { Flags } from '../../lib/cli-flags.js';
-export default function Preview({ cli }: {
+export default function Upgrade({ cli }: {
     cli: Result<Flags>;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/components/commands/upgrade.js

@@ -0,0 +1,53 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { $ } from 'execa';
+import React, { useEffect, useState } from 'react';
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import fs from 'fs';
+export default function Upgrade({ cli }) {
+    const [isInProjectDir, setIsInProjectDir] = useState(false);
+    const [step, setStep] = useState('check-config');
+    const [isError, setIsError] = useState(false);
+    const [errorMessage, setErrorMessage] = useState(null);
+    useEffect(() => {
+        async function checkConfig() {
+            // Check if the current dir contains pulse.config.ts
+            const currentDir = process.cwd();
+            const pulseConfigPath = `${currentDir}/pulse.config.ts`;
+            if (fs.existsSync(pulseConfigPath)) {
+                setIsInProjectDir(true);
+            }
+            setStep('upgrade');
+        }
+        checkConfig();
+    }, []);
+    useEffect(() => {
+        async function start() {
+            try {
+                await upgradePackages();
+            }
+            catch (error) {
+                setIsError(true);
+                setErrorMessage(error.message);
+            }
+        }
+        if (isInProjectDir) {
+            start();
+        }
+    }, [isInProjectDir]);
+    async function upgradePackages() {
+        const tag = cli.flags.beta ? 'beta' : 'latest';
+        await $ `npm install react@${React.version} react-dom@${React.version} --save-exact --silent --force`;
+        await $ `npm install -D @pulse-editor/cli@${tag} --silent --force`;
+        await $ `npm install @pulse-editor/shared-utils@${tag} @pulse-editor/react-api@${tag} --silent --force`;
+        // Remove webpack.config.ts if exists
+        const webpackConfigPath = `${process.cwd()}/webpack.config.ts`;
+        if (fs.existsSync(webpackConfigPath)) {
+            fs.unlinkSync(webpackConfigPath);
+        }
+        // Uninstall @module-federation/node html-webpack-plugin copy-webpack-plugin glob mini-css-extract-plugin webpack webpack-cli webpack-dev-server
+        await $ `npm uninstall @module-federation/node html-webpack-plugin copy-webpack-plugin glob mini-css-extract-plugin webpack webpack-cli webpack-dev-server --silent --force`;
+        setStep('done');
+    }
+    return (_jsx(_Fragment, { children: isError ? (_jsxs(Text, { color: 'redBright', children: ["\u274C An error occurred: ", errorMessage || 'Unknown error'] })) : !isInProjectDir ? (_jsx(Text, { color: 'redBright', children: "\u26D4 The current directory does not contain a Pulse Editor project." })) : step === 'check-config' ? (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking configuration..." })] })) : step === 'upgrade' ? (_jsx(_Fragment, { children: _jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Upgrading packages..." })] }) })) : (_jsx(Box, { children: _jsx(Text, { color: 'greenBright', children: "\u2705 Upgrade completed successfully." }) })) }));
+}

package/dist/lib/backend/publish-app.d.ts

@@ -0,0 +1 @@
+export declare function publishApp(isStage: boolean): Promise<Response>;

package/dist/lib/backend/publish-app.js

@@ -0,0 +1,26 @@
+import { getToken } from '../token.js';
+import { getBackendUrl } from '../backend-url.js';
+import fs from 'fs';
+export async function publishApp(isStage) {
+    // Upload the zip file to the server
+    // Read pulse.config.json for visibility
+    const config = JSON.parse(fs.readFileSync('./dist/pulse.config.json', 'utf-8'));
+    const visibility = config.visibility;
+    const formData = new FormData();
+    const buffer = fs.readFileSync('./node_modules/@pulse-editor/dist.zip');
+    // @ts-ignore Create a Blob from the buffer
+    const blob = new Blob([buffer], {
+        type: 'application/zip',
+    });
+    formData.append('file', blob, 'dist.zip');
+    formData.append('visibility', visibility);
+    // Send the file to the server
+    const res = await fetch(`${getBackendUrl(isStage)}/api/app/publish`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${getToken(isStage)}`,
+        },
+        body: formData,
+    });
+    return res;
+}

package/dist/lib/backend-url.d.ts

@@ -0,0 +1 @@
+export declare function getBackendUrl(stage: boolean): "https://localhost:8080" | "https://pulse-editor.com";

package/dist/lib/backend-url.js

@@ -0,0 +1,3 @@
+export function getBackendUrl(stage) {
+    return stage ? 'https://localhost:8080' : 'https://pulse-editor.com';
+}

package/dist/lib/cli-flags.d.ts

@@ -25,5 +25,23 @@ export declare const flags: {
         type: "string";
         shortFlag: string;
     };
+    beta: {
+        type: "boolean";
+    };
+    build: {
+        type: "boolean";
+        default: true;
+    };
+    path: {
+        type: "string";
+        shortFlag: string;
+    };
+    displayName: {
+        type: "string";
+    };
+    description: {
+        type: "string";
+        shortFlag: string;
+    };
 };
 export type Flags = typeof flags;

package/dist/lib/cli-flags.js

@@ -29,4 +29,22 @@ export const flags = defineFlags({
         type: 'string',
         shortFlag: 't',
     },
+    beta: {
+        type: 'boolean',
+    },
+    build: {
+        type: 'boolean',
+        default: true,
+    },
+    path: {
+        type: 'string',
+        shortFlag: 'p',
+    },
+    displayName: {
+        type: 'string',
+    },
+    description: {
+        type: 'string',
+        shortFlag: 'd',
+    },
 });

package/dist/lib/manual.js

@@ -27,6 +27,9 @@ const logout = `\
 `;
 const publish = `\
   publish         Publish Pulse Editor Extension in current directory to the Pulse Editor Platform.
+                  Flags:
+                    --noBuild
+                      Skip the build step before publishing.
 
 `;
 const create = `\
@@ -41,6 +44,9 @@ const create = `\
                     --visibility, -v [visibility]
                       The visibility of the new project. Options are private,
                       public, and unlisted.
+                    --path, -p [path]
+                      The path where to create the new project. Defaults to
+                      the name of the project in the current working directory.
 
 `;
 const preview = `\
@@ -71,6 +77,26 @@ const start = `\
 const clean = `\
   clean           Clean the dist/ directory.
 
+`;
+const upgrade = `\
+  upgrade         Upgrade Pulse Editor CLI and related packages to the latest version.
+                  Flags:
+                    --beta
+                      Upgrade to the latest beta version.
+
+`;
+const skill = `\
+  skill           Manage skill actions for the current Pulse App.
+
+                  Subcommands:
+                    create <skill-name> --description "<description>"
+                      Generate a new skill action using AI and write it to
+                      src/skill/<skill-name>/action.ts.
+
+                    fix <action-name>
+                      Fix and apply valid JSDoc comments to an existing skill
+                      action at src/skill/<action-name>/action.ts using AI.
+
 `;
 export const commandsManual = {
     help,
@@ -84,4 +110,6 @@ export const commandsManual = {
     build,
     start,
     clean,
+    upgrade,
+    skill,
 };