@pulse-editor/cli 0.1.1-beta.36 → 0.1.1-beta.38

package/dist/app.js

@@ -13,6 +13,7 @@ import Preview from './components/commands/preview.js';
 import Start from './components/commands/start.js';
 import Clean from './components/commands/clean.js';
 import Upgrade from './components/commands/upgrade.js';
+import Skill from './components/commands/skill.js';
 export default function App({ cli }) {
     const [command, setCommand] = useState(undefined);
     if (cli.flags.stage) {
@@ -25,5 +26,5 @@ export default function App({ cli }) {
         const cmd = cli.input[0] ?? 'help';
         setCommand(cmd);
     }, [cli.input]);
-    return (_jsxs(_Fragment, { children: [cli.flags.stage && (_jsx(Text, { color: 'yellow', children: "\u26A0\uFE0F  You are in development mode." })), command === 'help' ? (_jsx(Help, { cli: cli })) : command === 'chat' ? (_jsx(Chat, { cli: cli })) : command === 'login' ? (_jsx(Login, { cli: cli })) : command === 'logout' ? (_jsx(Logout, { cli: cli })) : command === 'publish' ? (_jsx(Publish, { cli: cli })) : command === 'create' ? (_jsx(Create, { cli: cli })) : command === 'dev' ? (_jsx(Dev, { cli: cli })) : command === 'build' ? (_jsx(Build, { cli: cli })) : command === 'preview' ? (_jsx(Preview, { cli: cli })) : command === 'start' ? (_jsx(Start, { cli: cli })) : command === 'clean' ? (_jsx(Clean, { cli: cli })) : command === 'upgrade' ? (_jsx(Upgrade, { cli: cli })) : (command !== undefined && (_jsxs(_Fragment, { children: [_jsxs(Text, { color: 'redBright', children: ["Invalid command: ", command] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: 'blueBright', children: "pulse help" }), " to see the list of available commands."] })] })))] }));
+    return (_jsxs(_Fragment, { children: [cli.flags.stage && (_jsx(Text, { color: 'yellow', children: "\u26A0\uFE0F  You are in development mode." })), command === 'help' ? (_jsx(Help, { cli: cli })) : command === 'chat' ? (_jsx(Chat, { cli: cli })) : command === 'login' ? (_jsx(Login, { cli: cli })) : command === 'logout' ? (_jsx(Logout, { cli: cli })) : command === 'publish' ? (_jsx(Publish, { cli: cli })) : command === 'create' ? (_jsx(Create, { cli: cli })) : command === 'dev' ? (_jsx(Dev, { cli: cli })) : command === 'build' ? (_jsx(Build, { cli: cli })) : command === 'preview' ? (_jsx(Preview, { cli: cli })) : command === 'start' ? (_jsx(Start, { cli: cli })) : command === 'clean' ? (_jsx(Clean, { cli: cli })) : command === 'upgrade' ? (_jsx(Upgrade, { cli: cli })) : command === 'skill' ? (_jsx(Skill, { cli: cli })) : (command !== undefined && (_jsxs(_Fragment, { children: [_jsxs(Text, { color: 'redBright', children: ["Invalid command: ", command] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: 'blueBright', children: "pulse help" }), " to see the list of available commands."] })] })))] }));
 }

package/dist/components/commands/skill.d.ts

@@ -0,0 +1,5 @@
+import { Result } from 'meow';
+import { Flags } from '../../lib/cli-flags.js';
+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/lib/backend/publish-app.js

@@ -1,4 +1,5 @@
 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
@@ -14,9 +15,7 @@ export async function publishApp(isStage) {
     formData.append('file', blob, 'dist.zip');
     formData.append('visibility', visibility);
     // Send the file to the server
-    const res = await fetch(isStage
-        ? 'https://localhost:8080/api/app/publish'
-        : 'https://pulse-editor.com/api/app/publish', {
+    const res = await fetch(`${getBackendUrl(isStage)}/api/app/publish`, {
         method: 'POST',
         headers: {
             Authorization: `Bearer ${getToken(isStage)}`,

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

@@ -39,5 +39,9 @@ export declare const flags: {
     displayName: {
         type: "string";
     };
+    description: {
+        type: "string";
+        shortFlag: string;
+    };
 };
 export type Flags = typeof flags;

package/dist/lib/cli-flags.js

@@ -43,4 +43,8 @@ export const flags = defineFlags({
     displayName: {
         type: 'string',
     },
+    description: {
+        type: 'string',
+        shortFlag: 'd',
+    },
 });

package/dist/lib/manual.js

@@ -84,6 +84,19 @@ const upgrade = `\
                     --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,
@@ -98,4 +111,5 @@ export const commandsManual = {
     start,
     clean,
     upgrade,
+    skill,
 };

package/dist/lib/server/express.js

@@ -98,6 +98,31 @@ app.all(/^\/server-function\/(.*)/, async (req, res) => {
 if (isPreview) {
     /* Preview mode */
     app.use(express.static("dist/client"));
+    // Expose skill actions as REST API endpoints in dev and preview modes
+    const skillActions = pulseConfig?.actions || [];
+    const skillActionNames = skillActions.map((a) => a.name);
+    app.post("/skill/:actionName", async (req, res) => {
+        const { actionName } = req.params;
+        if (skillActionNames.length > 0 && !skillActionNames.includes(actionName)) {
+            res
+                .status(404)
+                .json({ error: `Skill action "${actionName}" not found.` });
+            return;
+        }
+        const dir = path.resolve("node_modules/@pulse-editor/cli/dist/lib/server/preview/backend/load-remote.cjs");
+        const fileUrl = pathToFileURL(dir).href;
+        const { loadFunc } = await import(fileUrl);
+        try {
+            const action = await loadFunc(`skill/${actionName}`, pulseConfig.id, "http://localhost:3030", pulseConfig.version);
+            const result = await action(req.body);
+            res.json(result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`❌ Error running skill action "${actionName}":`, message);
+            res.status(500).json({ error: message });
+        }
+    });
     app.listen(3030, "0.0.0.0");
 }
 else if (isDev) {

package/dist/lib/token.js

@@ -1,6 +1,7 @@
 import os from 'os';
 import path from 'path';
 import fs from 'fs';
+import { getBackendUrl } from './backend-url.js';
 export function saveToken(token, devMode) {
     // Save the token to .pulse-editor/config.json in user home directory
     const configDir = path.join(os.homedir(), '.pulse-editor');
@@ -62,9 +63,7 @@ export function isTokenInEnv(devMode) {
     return false;
 }
 export async function checkToken(token, devMode) {
-    const res = await fetch(devMode
-        ? 'https://localhost:8080/api/api-keys/check'
-        : 'https://pulse-editor.com/api/api-keys/check', {
+    const res = await fetch(`${getBackendUrl(devMode)}/api/api-keys/check`, {
         body: JSON.stringify({ token }),
         headers: {
             'Content-Type': 'application/json',

package/dist/lib/webpack/compile.d.ts

@@ -1,2 +1,2 @@
-import webpack from 'webpack';
-export declare function webpackCompile(mode: 'development' | 'production' | 'preview', buildTarget?: 'client' | 'server', isWatchMode?: boolean): Promise<void | webpack.MultiCompiler>;
+import webpack from "webpack";
+export declare function webpackCompile(mode: "development" | "production" | "preview", buildTarget?: "client" | "server", isWatchMode?: boolean): Promise<void | webpack.MultiCompiler>;

package/dist/lib/webpack/compile.js

@@ -1,23 +1,25 @@
-import webpack from 'webpack';
-import { createWebpackConfig } from './webpack-config.js';
+import webpack from "webpack";
+import { generateTempTsConfig } from "./configs/utils.js";
+import { createWebpackConfig } from "./webpack-config.js";
 export async function webpackCompile(mode, buildTarget, isWatchMode = false) {
-    const configs = await createWebpackConfig(mode === 'preview', buildTarget ?? 'both', mode === 'development'
-        ? 'development'
-        : mode === 'preview'
-            ? 'development'
-            : 'production');
+    generateTempTsConfig();
+    const configs = await createWebpackConfig(mode === "preview", buildTarget ?? "both", mode === "development"
+        ? "development"
+        : mode === "preview"
+            ? "development"
+            : "production");
     const compiler = webpack(configs);
     if (isWatchMode) {
         compiler.watch({}, (err, stats) => {
             if (err) {
-                console.error('❌ Webpack build failed', err);
+                console.error("❌ Webpack build failed", err);
                 return;
             }
         });
         return compiler;
     }
     return new Promise((resolve, reject) => {
-        compiler.run(err => {
+        compiler.run((err) => {
             if (err) {
                 reject(err);
                 return;

package/dist/lib/webpack/configs/mf-client.js

@@ -20,6 +20,7 @@ class MFClientPlugin {
         if (compiler.options.mode === "development") {
             let isFirstRun = true;
             // Before build starts
+            // When a file changes and triggers a new compilation
             compiler.hooks.watchRun.tap("ReloadMessagePlugin", () => {
                 if (!isFirstRun) {
                     console.log("[client] 🔄 reloading app...");

package/dist/lib/webpack/configs/mf-server.js

@@ -5,7 +5,7 @@ import { globSync } from "glob";
 import path from "path";
 import { Node, Project, SyntaxKind } from "ts-morph";
 import wp from "webpack";
-import { discoverAppSkillActions, loadPulseConfig } from "./utils.js";
+import { discoverAppSkillActions, discoverServerFunctions, loadPulseConfig, } from "./utils.js";
 const { NodeFederationPlugin } = mfNode;
 const { webpack } = wp;
 class MFServerPlugin {
@@ -18,19 +18,33 @@ class MFServerPlugin {
     apply(compiler) {
         if (compiler.options.mode === "development") {
             let isFirstRun = true;
+            compiler.hooks.environment.tap("WatchFileChangesPlugin", () => {
+                // Watch for file changes in the server-function directory to trigger server-function rebuilds
+                compiler.hooks.thisCompilation.tap("WatchServerFunctions", (compilation) => {
+                    compilation.contextDependencies.add(path.resolve(this.projectDirName, "src/server-function"));
+                });
+                // Watch for file changes in the action directory to trigger action rebuilds
+                compiler.hooks.thisCompilation.tap("WatchActions", (compilation) => {
+                    compilation.contextDependencies.add(path.resolve(this.projectDirName, "src/skill"));
+                });
+            });
             // Before build starts
-            compiler.hooks.watchRun.tap("ReloadMessagePlugin", async (compilation) => {
+            compiler.hooks.beforeRun.tap("CleanDistPlugin", () => {
                 this.cleanServerDist();
+            });
+            // When a file changes and triggers a new compilation
+            compiler.hooks.watchRun.tap("ReloadMessagePlugin", async (compiler) => {
+                this.printChanges(compiler);
                 if (!isFirstRun) {
                     console.log(`[Server] 🔄 Reloading app...`);
-                    const isServerFunctionChange = compilation.modifiedFiles
-                        ? Array.from(compilation.modifiedFiles).some((file) => file.includes("src/server-function"))
+                    const isServerFunctionChange = compiler.modifiedFiles
+                        ? Array.from(compiler.modifiedFiles).some((file) => file.includes("src/server-function"))
                         : false;
                     if (isServerFunctionChange) {
                         await this.compileServerFunctions(compiler);
                     }
-                    const isActionChange = compilation.modifiedFiles
-                        ? Array.from(compilation.modifiedFiles).some((file) => file.includes("src/action"))
+                    const isActionChange = compiler.modifiedFiles
+                        ? Array.from(compiler.modifiedFiles).some((file) => file.includes("src/skill"))
                         : false;
                     if (isActionChange) {
                         console.log(`[Server] Detected changes in actions. Recompiling...`);
@@ -42,6 +56,14 @@ class MFServerPlugin {
                     await this.compileServerFunctions(compiler);
                     this.compileAppActionSkills();
                     console.log(`[Server] ✅ Successfully built server.`);
+                    const funcs = discoverServerFunctions();
+                    console.log(`\n🛜 Server functions:
+${Object.entries(funcs)
+                        .map(([name, file]) => {
+                        return `  - ${name.slice(2)} (from ${file})`;
+                    })
+                        .join("\n")}
+`);
                 }
             });
             // After build finishes
@@ -53,14 +75,6 @@ class MFServerPlugin {
                     console.log(`[Server] ✅ Reload finished.`);
                 }
             });
-            // Watch for file changes in the server-function directory to trigger server-function rebuilds
-            compiler.hooks.thisCompilation.tap("WatchServerFunctions", (compilation) => {
-                compilation.contextDependencies.add(path.resolve(this.projectDirName, "src/server-function"));
-            });
-            // Watch for file changes in the action directory to trigger action rebuilds
-            compiler.hooks.thisCompilation.tap("WatchActions", (compilation) => {
-                compilation.contextDependencies.add(path.resolve(this.projectDirName, "src/action"));
-            });
         }
         else {
             // Print build success/failed message
@@ -74,8 +88,8 @@ class MFServerPlugin {
                         this.compileAppActionSkills();
                     }
                     catch (err) {
-                        console.log(`[Server] ❌ Error during compilation:`, err);
-                        return;
+                        console.error(`[Server] ❌ Error during compilation:`, err);
+                        process.exit(1);
                     }
                     console.log(`[Server] ✅ Successfully built server.`);
                 }
@@ -101,31 +115,6 @@ class MFServerPlugin {
      * @param compiler
      */
     async compileServerFunctions(compiler) {
-        // Generate tsconfig for server functions
-        function generateTempTsConfig() {
-            const tempTsConfigPath = path.join(process.cwd(), "node_modules/.pulse/tsconfig.server.json");
-            const tsConfig = {
-                compilerOptions: {
-                    target: "ES2020",
-                    module: "esnext",
-                    moduleResolution: "bundler",
-                    strict: true,
-                    declaration: true,
-                    outDir: path.join(process.cwd(), "dist"),
-                },
-                include: [
-                    path.join(process.cwd(), "src/server-function/**/*"),
-                    path.join(process.cwd(), "pulse.config.ts"),
-                    path.join(process.cwd(), "global.d.ts"),
-                ],
-                exclude: [
-                    path.join(process.cwd(), "node_modules"),
-                    path.join(process.cwd(), "dist"),
-                ],
-            };
-            fs.writeFileSync(tempTsConfigPath, JSON.stringify(tsConfig, null, 2));
-        }
-        generateTempTsConfig();
         // Run a new webpack compilation to pick up new server functions
         const options = {
             ...compiler.options,
@@ -155,31 +144,8 @@ class MFServerPlugin {
         });
     }
     makeNodeFederationPlugin() {
-        function discoverServerFunctions() {
-            // Get all .ts files under src/server-function and read use default exports as entry points
-            const files = globSync("./src/server-function/**/*.ts");
-            const entryPoints = files
-                .map((file) => file.replaceAll("\\", "/"))
-                .map((file) => {
-                return {
-                    ["./" +
-                        file.replace("src/server-function/", "").replace(/\.ts$/, "")]: "./" + file,
-                };
-            })
-                .reduce((acc, curr) => {
-                return { ...acc, ...curr };
-            }, {});
-            return entryPoints;
-        }
         const funcs = discoverServerFunctions();
         const actions = discoverAppSkillActions();
-        console.log(`Discovered server functions:
-${Object.entries(funcs)
-            .map(([name, file]) => {
-            return `  - ${name.slice(2)} (from ${file})`;
-        })
-            .join("\n")}
-`);
         return new NodeFederationPlugin({
             name: this.pulseConfig.id + "_server",
             remoteType: "script",
@@ -193,9 +159,9 @@ ${Object.entries(funcs)
         }, {});
     }
     /**
-     * Register default functions defined in src/action as exposed modules in Module Federation.
+     * Register default functions defined in src/skill as exposed modules in Module Federation.
      * This will:
-     * 	1. Search for all .ts files under src/action
+     * 	1. Search for all .ts files under src/skill
      *  2. Use ts-morph to get the default function information, including function name, parameters, and JSDoc comments
      *  3. Organize the functions' information into a list of Action
      * @param compiler
@@ -224,6 +190,15 @@ ${Object.entries(funcs)
                     throw new Error(`Duplicate action name "${funcName}" detected in file ${file}. Please ensure all actions have unique names to avoid conflicts.`);
                 }
                 const defaultExportJSDocs = funcDecl.getJsDocs();
+                // Validate that the function has a JSDoc description
+                const descriptionText = defaultExportJSDocs
+                    .map((doc) => doc.getDescription().replace(/^\*+/gm, "").trim())
+                    .join("\n")
+                    .trim();
+                if (defaultExportJSDocs.length === 0 || !descriptionText) {
+                    throw new Error(`[Action Validation] Action "${funcName}" in ${file} is missing a JSDoc description. ` +
+                        `Please add a JSDoc comment block with a description above the function.`);
+                }
                 const description = defaultExportJSDocs
                     .map((doc) => doc.getFullText())
                     .join("\n");
@@ -250,12 +225,24 @@ ${Object.entries(funcs)
                             }
                         });
                     }
-                    funcParam
-                        .getType()
-                        .getProperties()
-                        .forEach((prop) => {
+                    const paramProperties = funcParam.getType().getProperties();
+                    const inputTypeDef = typeDefs["input"] ?? {};
+                    if (paramProperties.length > 0 && !typeDefs["input"]) {
+                        throw new Error(`[Action Validation] Action "${funcName}" in ${file} has parameters but is missing an ` +
+                            `"@typedef {Object} input" JSDoc block. Please document all parameters with ` +
+                            `@typedef {Object} input and @property tags.`);
+                    }
+                    paramProperties.forEach((prop) => {
                         const name = prop.getName();
-                        const inputTypeDef = typeDefs["input"] ?? {};
+                        if (!inputTypeDef[name]) {
+                            throw new Error(`[Action Validation] Action "${funcName}" in ${file}: parameter "${name}" is missing ` +
+                                `a @property entry in the "input" JSDoc typedef. Please add ` +
+                                `"@property {type} ${name} - description" to the JSDoc.`);
+                        }
+                        if (!inputTypeDef[name]?.description?.trim()) {
+                            throw new Error(`[Action Validation] Action "${funcName}" in ${file}: parameter "${name}" has an empty ` +
+                                `description in the JSDoc @property. Please provide a meaningful description.`);
+                        }
                         const variable = {
                             description: inputTypeDef[name]?.description ?? "",
                             type: this.getType(inputTypeDef[name]?.type ?? ""),
@@ -272,12 +259,24 @@ ${Object.entries(funcs)
                     return;
                 }
                 const returns = {};
-                funcDecl
-                    .getReturnType()
-                    .getProperties()
-                    .forEach((prop) => {
+                const returnProperties = funcDecl.getReturnType().getProperties();
+                const outputTypeDef = typeDefs["output"] ?? {};
+                if (returnProperties.length > 0 && !typeDefs["output"]) {
+                    throw new Error(`[Action Validation] Action "${funcName}" in ${file} returns properties but is missing an ` +
+                        `"@typedef {Object} output" JSDoc block. Please document all return values with ` +
+                        `@typedef {Object} output and @property tags.`);
+                }
+                returnProperties.forEach((prop) => {
                     const name = prop.getName();
-                    const outputTypeDef = typeDefs["output"] ?? {};
+                    if (!outputTypeDef[name]) {
+                        throw new Error(`[Action Validation] Action "${funcName}" in ${file}: return property "${name}" is missing ` +
+                            `a @property entry in the "output" JSDoc typedef. Please add ` +
+                            `"@property {type} ${name} - description" to the JSDoc.`);
+                    }
+                    if (!outputTypeDef[name]?.description?.trim()) {
+                        throw new Error(`[Action Validation] Action "${funcName}" in ${file}: return property "${name}" has an empty ` +
+                            `description in the JSDoc @property. Please provide a meaningful description.`);
+                    }
                     const variable = {
                         description: outputTypeDef[name]?.description ?? "",
                         type: this.getType(outputTypeDef[name]?.type ?? ""),
@@ -295,7 +294,6 @@ ${Object.entries(funcs)
             });
         });
         // You can now register `actions` in Module Federation or expose them as needed
-        console.log("Discovered skill actions:\n", actions.map((a) => "- " + a.name).join("\n"));
         // Register actions in pulse config for runtime access
         this.pulseConfig.actions = actions;
     }
@@ -346,6 +344,20 @@ ${Object.entries(funcs)
         console.warn(`[Type Warning] Unrecognized type "${text}". Consider adding explicit types in your action's JSDoc comments for better type safety and documentation.`);
         return text;
     }
+    printChanges(compiler) {
+        const modified = compiler.modifiedFiles
+            ? Array.from(compiler.modifiedFiles)
+            : [];
+        const removed = compiler.removedFiles
+            ? Array.from(compiler.removedFiles)
+            : [];
+        const allChanges = [...modified, ...removed];
+        if (allChanges.length > 0) {
+            console.log(`[Server] ✏️ Detected file changes:\n${allChanges
+                .map((file) => `  - ${file}`)
+                .join("\n")}`);
+        }
+    }
 }
 export async function makeMFServerConfig(mode) {
     const projectDirName = process.cwd();

package/dist/lib/webpack/configs/preview.js

@@ -37,6 +37,13 @@ class PreviewClientPlugin {
 ✨ Try it out in your browser and let the magic happen! 🚀
 `;
                 console.log("[client-preview] ✅ Successfully built preview.");
+                const skillActions = this.pulseConfig?.actions || [];
+                const actionNames = skillActions.map((a) => a.name);
+                if (actionNames.length > 0) {
+                    console.log("\n🎯 Skill action endpoints:\n" +
+                        actionNames.map((n) => ` - /skill/${n}`).join("\n") +
+                        "\n");
+                }
                 console.log(previewStartupMessage);
                 isFirstRun = false;
             }

package/dist/lib/webpack/configs/utils.d.ts

@@ -1,6 +1,10 @@
 export declare function loadPulseConfig(): Promise<any>;
 export declare function getLocalNetworkIP(): string;
 export declare function readConfigFile(): Promise<any>;
+export declare function discoverServerFunctions(): {
+    [x: string]: string;
+};
 export declare function discoverAppSkillActions(): {
     [x: string]: string;
 } | null;
+export declare function generateTempTsConfig(): void;

package/dist/lib/webpack/configs/utils.js

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import { existsSync } from "fs";
+import { existsSync, writeFileSync } from "fs";
 import fs from "fs/promises";
 import { globSync } from "glob";
 import { networkInterfaces } from "os";
@@ -81,6 +81,21 @@ export async function readConfigFile() {
     const data = await fs.readFile("dist/pulse.config.json", "utf-8");
     return JSON.parse(data);
 }
+export function discoverServerFunctions() {
+    // Get all .ts files under src/server-function and read use default exports as entry points
+    const files = globSync("./src/server-function/**/*.ts");
+    const entryPoints = files
+        .map((file) => file.replaceAll("\\", "/"))
+        .map((file) => {
+        return {
+            ["./" + file.replace("src/server-function/", "").replace(/\.ts$/, "")]: "./" + file,
+        };
+    })
+        .reduce((acc, curr) => {
+        return { ...acc, ...curr };
+    }, {});
+    return entryPoints;
+}
 export function discoverAppSkillActions() {
     // Get all .ts files under src/skill and read use default exports as entry points
     const files = globSync("./src/skill/*/action.ts");
@@ -116,3 +131,30 @@ export function discoverAppSkillActions() {
     }, {});
     return entryPoints;
 }
+// Generate tsconfig for server functions
+export function generateTempTsConfig() {
+    const tempTsConfigPath = path.join(process.cwd(), "node_modules/.pulse/tsconfig.server.json");
+    if (existsSync(tempTsConfigPath)) {
+        return;
+    }
+    const tsConfig = {
+        compilerOptions: {
+            target: "ES2020",
+            module: "esnext",
+            moduleResolution: "bundler",
+            strict: true,
+            declaration: true,
+            outDir: path.join(process.cwd(), "dist"),
+        },
+        include: [
+            path.join(process.cwd(), "src/server-function/**/*"),
+            path.join(process.cwd(), "pulse.config.ts"),
+            path.join(process.cwd(), "global.d.ts"),
+        ],
+        exclude: [
+            path.join(process.cwd(), "node_modules"),
+            path.join(process.cwd(), "dist"),
+        ],
+    };
+    writeFileSync(tempTsConfigPath, JSON.stringify(tsConfig, null, 2));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pulse-editor/cli",
-	"version": "0.1.1-beta.36",
+	"version": "0.1.1-beta.38",
 	"license": "MIT",
 	"bin": {
 		"pulse": "dist/cli.js"