lua-cli 3.12.2 → 3.14.0

package/dist/commands/compile.js

@@ -2,8 +2,8 @@
  * Compile Command
  * Uses the plugin-based compiler to compile all primitives
  */
-import path from "path";
-import { withErrorHandling, writeProgress, writeSuccess, writeError, writeInfo } from "../utils/cli.js";
+import path from 'path';
+import { withErrorHandling, writeProgress, writeSuccess, writeError, writeInfo, writeNextStep, writeHintBlock, } from '../utils/cli.js';
 import { readYamlConfig, ensureGitignored } from '../utils/files.js';
 import { getToken } from '../services/auth.js';
 import { runSyncCheck } from './sync.js';
@@ -41,6 +41,12 @@ import { trackEvent } from '../services/analytics.js';
  * @param options.debug - Enable debug mode (preserves temp files, verbose esbuild)
  * @param options.verbose - Show detailed progress output
  * @param options.sync - Run drift detection check before compiling (default: off)
+ * @param options.topLevel - When true, emit a post-compile next-step hint.
+ *   Sub-invocations (from `lua push`, `lua chat`, `lua test`) must pass
+ *   `topLevel: false` (or omit — it defaults to false) so the hint is
+ *   suppressed; otherwise users see a spurious "run `lua test`" suggestion
+ *   mid-flow during `lua push` or, worse, mid `lua test` itself.
+ *   The hint fires only when the user explicitly runs `lua compile`.
  */
 export async function compileCommand(options) {
     return withErrorHandling(async () => {
@@ -59,7 +65,9 @@ export async function compileCommand(options) {
                 try {
                     apiKey = getToken();
                 }
-                catch { /* no key — skip sync */ }
+                catch {
+                    /* no key — skip sync */
+                }
                 if (apiKey && agentId) {
                     const shouldContinue = await runSyncCheck(apiKey, agentId);
                     if (!shouldContinue) {
@@ -73,7 +81,7 @@ export async function compileCommand(options) {
                 }
             }
         }
-        writeProgress("🔨 Compiling...");
+        writeProgress('🔨 Compiling...');
         // Step 1: Run the compiler
         const rootDir = process.cwd();
         const outDir = path.join(rootDir, 'dist-v2');
@@ -102,7 +110,20 @@ export async function compileCommand(options) {
                 first_error: result.errors[0]?.message?.substring(0, 200) || null,
                 debug_mode: debugMode,
             });
-            throw new Error("Operation failed");
+            // B12: only show the compile-specific debug hint when this is a top-level
+            // `lua compile` invocation. Sub-invocations from lua push/chat/test should
+            // not tell users to run `lua compile --verbose` mid-flow.
+            if (options?.topLevel) {
+                writeHintBlock({
+                    headline: 'Compilation failed. Debug options:',
+                    lines: [
+                        { label: 'More context:', command: 'lua compile --verbose' },
+                        { label: 'Full esbuild output:', command: 'lua compile --debug' },
+                    ],
+                    when: 'error',
+                });
+            }
+            throw new Error('Compilation failed — see errors above.');
         }
         // Ensure dist-v2/ is in .gitignore
         ensureGitignored(rootDir, 'dist-v2/', 'dist/');
@@ -113,7 +134,7 @@ export async function compileCommand(options) {
             }
         }
         // Step 4: Sync YAML with manifest (all versioned primitives)
-        writeProgress("🔄 Syncing YAML with manifest...");
+        writeProgress('🔄 Syncing YAML with manifest...');
         let config = readYamlConfig();
         for (const handler of versionedHandlers) {
             handler.syncYamlWithManifest(result.manifest, config);
@@ -124,23 +145,28 @@ export async function compileCommand(options) {
         try {
             apiKey = getToken();
         }
-        catch { /* no key — skip server sync */ }
+        catch {
+            /* no key — skip server sync */
+        }
         let syncConfig = readYamlConfig();
         const agentId = syncConfig?.agent?.agentId;
         if (apiKey && agentId) {
-            writeProgress("🔄 Syncing with server...");
+            writeProgress('🔄 Syncing with server...');
             // Phase 1: Fetch all server state in parallel (6 HTTP calls at once)
-            const fetchResults = await Promise.all(syncableHandlers.map(h => h.fetchServerState(apiKey, agentId)));
+            const fetchResults = await Promise.all(syncableHandlers.map((h) => h.fetchServerState(apiKey, agentId)));
             // Phase 2: Apply YAML changes sequentially (each handler writes to its own YAML key)
             for (let i = 0; i < syncableHandlers.length; i++) {
-                const applyResult = await syncableHandlers[i].applySyncToYaml(fetchResults[i], syncConfig, result.manifest, { apiKey, agentId });
+                const applyResult = await syncableHandlers[i].applySyncToYaml(fetchResults[i], syncConfig, result.manifest, {
+                    apiKey,
+                    agentId,
+                });
                 if (applyResult.yamlUpdated) {
                     syncConfig = readYamlConfig(); // Re-read only if changed
                 }
             }
         }
         else {
-            console.log("⚠️  Skipping server sync (no API key or agent ID configured)");
+            console.log('⚠️  Skipping server sync (no API key or agent ID configured)');
         }
         // Step 6: Print summary
         const { stats } = result;
@@ -148,6 +174,17 @@ export async function compileCommand(options) {
             .map(([kind, count]) => `${count} ${kind}${count > 1 ? 's' : ''}`)
             .join(', ');
         writeSuccess(`✅ Compiled ${stats.totalPrimitives} primitives (${parts}) in ${stats.duration}ms`);
+        // Emit next-step hint only when called as a top-level `lua compile`
+        // invocation. Sub-invocations from `lua push`, `lua chat`, and `lua test`
+        // must not print "run `lua test`" mid-flow — especially not during
+        // `lua test` itself. Fixes Bugbot issue f45d2169.
+        if (options?.topLevel) {
+            writeNextStep({
+                command: 'lua test',
+                rationale: 'to verify your tools work locally before pushing',
+                when: 'success',
+            });
+        }
         if (debugMode) {
             console.log(`📊 Output: ${outDir}`);
             console.log(`   Total size: ${(stats.totalSize / 1024).toFixed(1)}KB`);
@@ -174,6 +211,6 @@ export async function compileCommand(options) {
             server_sync_performed: !!(apiKey && agentId),
             backup_out_of_sync: backupOutOfSync,
         });
-    }, "compilation");
+    }, 'compilation');
 }
 //# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

@@ -1 +1 @@
-{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"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"}

package/dist/commands/completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6JH;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDrE"}
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgKH;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CrE"}

package/dist/commands/completion.js

@@ -4,6 +4,7 @@
  */
 import { withErrorHandling } from '../utils/cli.js';
 import { trackEvent } from '../services/analytics.js';
+import { validateOrSuggest } from '../utils/aliases.js';
 /**
  * Bash completion script
  */
@@ -15,7 +16,7 @@ _lua_completion() {
     prev="\${COMP_WORDS[COMP_CWORD-1]}"
     
     # Main commands
-    commands="auth init compile test push deploy chat env persona production resources admin docs channels logs skills features completion"
+    commands="admin auth channels chat compile completion deploy describe docs env features init logs persona production push resources skills status test"
     
     # Subcommands
     case "\${prev}" in
@@ -66,7 +67,7 @@ _lua() {
     local line state
 
     _arguments -C \\
-        "1: :(auth init compile test push deploy chat env persona production resources admin docs channels logs skills features completion)" \\
+        "1: :(admin auth channels chat compile completion deploy describe docs env features init logs persona production push resources skills status test)" \\
         "*::arg:->args"
 
     case $line[1] in
@@ -119,6 +120,8 @@ complete -c lua -f -n "__fish_use_subcommand" -a "channels" -d "Manage channels"
 complete -c lua -f -n "__fish_use_subcommand" -a "logs" -d "View logs"
 complete -c lua -f -n "__fish_use_subcommand" -a "skills" -d "Manage skills"
 complete -c lua -f -n "__fish_use_subcommand" -a "features" -d "Manage agent features"
+complete -c lua -f -n "__fish_use_subcommand" -a "status" -d "Show project status"
+complete -c lua -f -n "__fish_use_subcommand" -a "describe" -d "Describe project state"
 complete -c lua -f -n "__fish_use_subcommand" -a "completion" -d "Generate completion script"
 
 # Auth subcommands
@@ -189,13 +192,9 @@ Then follow the instructions above to add it to your shell configuration.
             return;
         }
         // Validate shell type
-        const validShells = ['bash', 'zsh', 'fish'];
-        if (!validShells.includes(shell.toLowerCase())) {
-            console.error(`❌ Invalid shell: "${shell}". Must be one of: ${validShells.join(', ')}`);
-            throw new Error("Invalid shell:");
-        }
+        shell = validateOrSuggest('completion.shell', shell);
         // Output the appropriate completion script
-        switch (shell.toLowerCase()) {
+        switch (shell) {
             case 'bash':
                 console.log(BASH_COMPLETION);
                 break;
@@ -207,6 +206,6 @@ Then follow the instructions above to add it to your shell configuration.
                 break;
         }
         trackEvent('cli_completion_generated', { shell_type: shell || null });
-    }, "completion");
+    }, 'completion');
 }
 //# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

@@ -1 +1 @@
-{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;GAEG;AACH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDvB,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtB,CAAC;AAEF;;GAEG;AACH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAc;IACpD,OAAO,iBAAiB,CAAC,KAAK,IAAI,EAAE;QAClC,2CAA2C;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsBjB,CAAC,CAAC;YACG,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,qBAAqB,KAAK,sBAAsB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxF,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC;QAED,2CAA2C;QAC3C,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5B,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,KAAK;gBACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC7B,MAAM;QACV,CAAC;QACD,UAAU,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC,EAAE,YAAY,CAAC,CAAC;AACnB,CAAC"}
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDvB,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtB,CAAC;AAEF;;GAEG;AACH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAc;IACpD,OAAO,iBAAiB,CAAC,KAAK,IAAI,EAAE;QAClC,2CAA2C;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsBjB,CAAC,CAAC;YACG,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,KAAK,GAAG,iBAAiB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAErD,2CAA2C;QAC3C,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,KAAK;gBACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC7B,MAAM;QACV,CAAC;QACD,UAAU,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC,EAAE,YAAY,CAAC,CAAC;AACnB,CAAC"}

package/dist/commands/configure.js

@@ -2,8 +2,8 @@
  * Configure Command
  * Orchestrates the authentication setup process
  */
-import { withErrorHandling, clearPromptLines } from "../utils/cli.js";
-import { promptAuthMethod, handleApiKeyAuth, handleEmailAuth, handleApiKeyAuthNonInteractive, handleEmailOtpRequest, handleEmailOtpVerify, } from "../utils/auth-flows.js";
+import { withErrorHandling, clearPromptLines } from '../utils/cli.js';
+import { promptAuthMethod, handleApiKeyAuth, handleEmailAuth, handleApiKeyAuthNonInteractive, handleEmailOtpRequest, handleEmailOtpVerify, } from '../utils/auth-flows.js';
 import { trackEvent } from '../services/analytics.js';
 /**
  * Main configure command - sets up authentication credentials.
@@ -59,10 +59,10 @@ export async function configureCommand(options = {}) {
             // Interactive mode: Prompt for auth method
             authMethod = await promptAuthMethod();
             clearPromptLines(2);
-            if (authMethod === "api-key") {
+            if (authMethod === 'api-key') {
                 await handleApiKeyAuth();
             }
-            else if (authMethod === "email") {
+            else if (authMethod === 'email') {
                 await handleEmailAuth();
             }
         }
@@ -71,6 +71,6 @@ export async function configureCommand(options = {}) {
             non_interactive_mode: nonInteractive,
             otp_step: email ? (otp ? 'verify' : 'request') : null,
         });
-    }, "configuration");
+    }, 'configuration');
 }
 //# sourceMappingURL=configure.js.map

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8HH;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAmF9E"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqIH;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA0H9E"}

package/dist/commands/deploy.js

@@ -4,10 +4,10 @@
  */
 import { readYamlConfig, validateSkillConfig } from '../utils/files.js';
 import { skillHandler, webhookHandler, jobHandler, preprocessorHandler, postprocessorHandler, } from '../primitives/index.js';
-import { withErrorHandling, writeProgress, writeSuccess, writeInfo, clearPromptLines } from '../utils/cli.js';
+import { withErrorHandling, writeProgress, writeSuccess, writeInfo, clearPromptLines, writeNextStep, writeHintBlock, writeTip, } from '../utils/cli.js';
 import { requireAuthOrExit } from '../utils/command-utils.js';
 import { safePrompt } from '../utils/prompt-handler.js';
-import { sortVersionsByDate, promptVersionSelection, confirmDeployment, } from '../utils/deploy-helpers.js';
+import { sortVersionsByDate, promptVersionSelection, confirmDeployment } from '../utils/deploy-helpers.js';
 import { BASE_URLS } from '../config/constants.js';
 import SkillApi from '../api/skills.api.service.js';
 import WebhookApi from '../api/webhook.api.service.js';
@@ -15,7 +15,9 @@ import JobApi from '../api/job.api.service.js';
 import PreProcessorApi from '../api/preprocessor.api.service.js';
 import PostProcessorApi from '../api/postprocessor.api.service.js';
 import PersonaApi from '../api/persona.api.service.js';
+import { buildLogsCommand } from './log-tip.js';
 import { trackEvent } from '../services/analytics.js';
+import { validateOrSuggest } from '../utils/aliases.js';
 /**
  * Normalize a server version object to the VersionInfo shape expected by
  * sortVersionsByDate / promptVersionSelection / formatVersionChoice.
@@ -116,6 +118,10 @@ export async function deployCommand(type, cmdObj) {
         if (!type && (cmdObj?.skillName || cmdObj?.skillVersion)) {
             type = 'skill';
         }
+        // Normalize alias first (e.g. 'everything' → 'all') so the guard below can catch it
+        if (type) {
+            type = validateOrSuggest('deploy.type', type, { allowAll: true });
+        }
         // Handle 'all' (requires --force, like `lua push all`)
         if (type === 'all') {
             if (!options.force) {
@@ -128,25 +134,13 @@ export async function deployCommand(type, cmdObj) {
         const config = readYamlConfig();
         validateSkillConfig(config);
         const agentId = config.agent.agentId;
-        const validTypes = ['skill', 'webhook', 'job', 'preprocessor', 'postprocessor', 'persona'];
         let selectedType;
         if (type) {
-            if (!validTypes.includes(type)) {
-                console.log('\nUsage:');
-                console.log('  lua deploy                         Interactive selection');
-                console.log('  lua deploy skill                   Deploy a skill version');
-                console.log('  lua deploy webhook                 Deploy a webhook version');
-                console.log('  lua deploy job                     Deploy a job version');
-                console.log('  lua deploy preprocessor            Deploy a preprocessor version');
-                console.log('  lua deploy postprocessor           Deploy a postprocessor version');
-                console.log('  lua deploy persona                 Deploy a persona version');
-                console.log('  lua deploy all --force             Deploy latest version of all');
-                throw new Error(`Invalid type: "${type}". Must be one of: ${validTypes.join(', ')}, or "all".`);
-            }
             selectedType = type;
         }
         else {
-            const answer = await safePrompt([{
+            const answer = await safePrompt([
+                {
                     type: 'list',
                     name: 'type',
                     message: 'What would you like to deploy?',
@@ -158,7 +152,8 @@ export async function deployCommand(type, cmdObj) {
                         { name: '📤  PostProcessor', value: 'postprocessor' },
                         { name: '🤖  Persona', value: 'persona' },
                     ],
-                }]);
+                },
+            ]);
             if (!answer) {
                 console.log('Deployment cancelled.');
                 return;
@@ -166,12 +161,14 @@ export async function deployCommand(type, cmdObj) {
             selectedType = answer.type;
         }
         const apiKey = await requireAuthOrExit();
+        let personaDeployed = false;
+        let versionedOutcome = null;
         if (selectedType === 'persona') {
-            await deployPersonaVersion(apiKey, agentId, options);
+            personaDeployed = await deployPersonaVersion(apiKey, agentId, options);
         }
         else {
-            const deployConfig = VERSIONED_DEPLOY_TYPES.find(dt => dt.type === selectedType);
-            await deployVersionedPrimitive(deployConfig, config, apiKey, agentId, options);
+            const deployConfig = VERSIONED_DEPLOY_TYPES.find((dt) => dt.type === selectedType);
+            versionedOutcome = await deployVersionedPrimitive(deployConfig, config, apiKey, agentId, options);
         }
         trackEvent('cli_deploy_completed', {
             primitive_type: selectedType,
@@ -179,6 +176,47 @@ export async function deployCommand(type, cmdObj) {
             entity_selected_by_name: !!options.name,
             version_selected_by_flag: !!options.version,
         });
+        const deployed = selectedType === 'persona' ? personaDeployed : (versionedOutcome?.deployed ?? false);
+        const hintPrintedAlready = selectedType !== 'persona' && !!versionedOutcome?.hintPrinted;
+        if (!deployed) {
+            return;
+        }
+        if (selectedType === 'webhook') {
+            // B8: use the resolved entity name (available for both --name and interactive selections)
+            const webhookNameToken = versionedOutcome?.entityName || options.name?.trim() || '<webhook-name>';
+            writeHintBlock({
+                headline: 'Webhook is live. Trigger it, then inspect logs:',
+                lines: [
+                    { label: 'Find URL:', command: `lua webhooks view --webhook-name ${webhookNameToken}` },
+                    { label: 'Trigger:', command: 'curl -X POST <URL from above>' },
+                    {
+                        label: 'Inspect:',
+                        command: buildLogsCommand({
+                            primitiveType: 'webhook',
+                            name: webhookNameToken !== '<webhook-name>' ? webhookNameToken : undefined,
+                        }),
+                    },
+                ],
+                when: 'success',
+            });
+        }
+        else if (selectedType === 'persona') {
+            writeNextStep({
+                command: 'lua chat -e production -m "test"',
+                rationale: 'to verify the new persona responds correctly',
+                when: 'success',
+            });
+        }
+        else if (!hintPrintedAlready) {
+            writeHintBlock({
+                headline: 'Version is live. Generate traffic first, then inspect:',
+                lines: [
+                    { label: 'Test:', command: `lua chat -e production -m "your test message"` },
+                    { label: 'Inspect:', command: buildLogsCommand({ primitiveType: selectedType }) },
+                ],
+                when: 'success',
+            });
+        }
     }, 'deployment');
 }
 /**
@@ -188,7 +226,7 @@ async function deployVersionedPrimitive(deployConfig, config, apiKey, agentId, o
     const entities = deployConfig.handler.getFromYaml(config);
     if (entities.length === 0) {
         writeInfo(`ℹ️  No ${deployConfig.label}s found in configuration. Nothing to deploy.`);
-        return;
+        return { deployed: false, hintPrinted: false, entityName: '' };
     }
     // Select entity
     let selectedEntity;
@@ -204,15 +242,17 @@ async function deployVersionedPrimitive(deployConfig, config, apiKey, agentId, o
         selectedEntity = entities[0];
     }
     else {
-        const answer = await safePrompt([{
+        const answer = await safePrompt([
+            {
                 type: 'list',
                 name: 'entity',
                 message: `Select a ${deployConfig.label} to deploy:`,
                 choices: entities.map((e) => ({ name: `${e.name} (v${e.version})`, value: e })),
-            }]);
+            },
+        ]);
         if (!answer) {
             console.log('Deployment cancelled.');
-            return;
+            return { deployed: false, hintPrinted: false, entityName: '' };
         }
         clearPromptLines(2);
         selectedEntity = answer.entity;
@@ -236,10 +276,10 @@ async function deployVersionedPrimitive(deployConfig, config, apiKey, agentId, o
             selectedVersion = sortedVersions[0].version;
         }
         else {
-            const exists = sortedVersions.some(v => v.version === options.version);
+            const exists = sortedVersions.some((v) => v.version === options.version);
             if (!exists) {
                 console.log('\nAvailable versions:');
-                sortedVersions.slice(0, 5).forEach(v => console.log(`  - ${v.version}`));
+                sortedVersions.slice(0, 5).forEach((v) => console.log(`  - ${v.version}`));
                 if (sortedVersions.length > 5)
                     console.log(`  ... and ${sortedVersions.length - 5} more`);
                 throw new Error(`Version "${options.version}" not found.`);
@@ -263,14 +303,30 @@ async function deployVersionedPrimitive(deployConfig, config, apiKey, agentId, o
     writeProgress('🔄 Publishing version...');
     const result = await deployConfig.handler.publishVersion(apiKey, agentId, entityId, selectedVersion);
     if (!result.success) {
+        // Publish is a management operation — no execution logs exist for a failed publish.
+        // The error reason is already on screen.
         throw new Error(`Failed to deploy: ${result.error || 'Unknown error'}`);
     }
     writeSuccess(`✅ ${deployConfig.label} "${selectedEntity.name}" v${selectedVersion} deployed successfully`);
-    // Update YAML with the deployed version
+    // B11: consolidate YAML update to a single location (applies to all types including job).
     if (selectedVersion !== selectedEntity.version) {
         writeInfo(`📝 Updating YAML with deployed version: ${selectedVersion}`);
         deployConfig.handler.updateVersionInYaml(selectedEntity.name, selectedVersion);
     }
+    // B6: job prints its own hint block; set hintPrinted so the outer deployCommand
+    // skips the generic "Version is live" block (avoiding duplicate hints).
+    if (deployConfig.type === 'job') {
+        writeHintBlock({
+            headline: 'Job is live. Trigger or wait for schedule, then inspect logs:',
+            lines: [
+                { label: 'Manual trigger:', command: `lua jobs trigger --job-name ${selectedEntity.name}` },
+                { label: 'Inspect:', command: buildLogsCommand({ primitiveType: 'job', name: selectedEntity.name }) },
+            ],
+            when: 'success',
+        });
+        return { deployed: true, hintPrinted: true, entityName: selectedEntity.name };
+    }
+    return { deployed: true, hintPrinted: false, entityName: selectedEntity.name };
 }
 /**
  * Deploy a persona version. Persona uses integer version IDs (not semver).
@@ -296,25 +352,27 @@ async function deployPersonaVersion(apiKey, agentId, options) {
             if (isNaN(v)) {
                 throw new Error(`Invalid persona version: "${options.version}". Must be a number or 'latest'.`);
             }
-            if (!sortedVersions.some(pv => pv.version === v)) {
+            if (!sortedVersions.some((pv) => pv.version === v)) {
                 throw new Error(`Persona version ${v} not found.`);
             }
             selectedVersion = v;
         }
     }
     else {
-        const answer = await safePrompt([{
+        const answer = await safePrompt([
+            {
                 type: 'list',
                 name: 'version',
                 message: 'Select a persona version to deploy:',
-                choices: sortedVersions.map(v => ({
+                choices: sortedVersions.map((v) => ({
                     name: `v${v.version}${v.isCurrent ? ' (CURRENT)' : ''} — ${new Date(v.createdDate).toLocaleDateString()}`,
                     value: v.version,
                 })),
-            }]);
+            },
+        ]);
         if (!answer) {
             console.log('Deployment cancelled.');
-            return;
+            return false;
         }
         clearPromptLines(2);
         selectedVersion = answer.version;
@@ -330,9 +388,11 @@ async function deployPersonaVersion(apiKey, agentId, options) {
     writeProgress('🔄 Deploying persona...');
     const deployResult = await personaApi.deployVersion(selectedVersion);
     if (!deployResult.success) {
+        // Persona deploy is a management operation — no execution logs exist.
         throw new Error(`Failed to deploy persona: ${deployResult.error?.message || 'Unknown error'}`);
     }
     writeSuccess(`✅ Persona v${selectedVersion} deployed successfully`);
+    return true;
 }
 /**
  * Deploy latest version of every primitive — mirrors `lua push all --force --auto-deploy`.
@@ -344,6 +404,7 @@ async function deployAllCommand(_options) {
     const agentId = config.agent.agentId;
     let deployedCount = 0;
     let failedCount = 0;
+    const failedItems = [];
     console.log('\n🚀 Deploying latest versions of all primitives...\n');
     // Deploy all versioned primitives
     for (const deployConfig of VERSIONED_DEPLOY_TYPES) {
@@ -371,11 +432,13 @@ async function deployAllCommand(_options) {
                 }
                 else {
                     console.warn(`  ⚠️  Failed to deploy ${deployConfig.label} "${entity.name}": ${result.error}`);
+                    failedItems.push({ kind: deployConfig.type, name: entity.name, error: result.error || 'Unknown error' });
                     failedCount++;
                 }
             }
             catch (e) {
                 console.warn(`  ⚠️  Error deploying ${deployConfig.label} "${entity.name}": ${e.message}`);
+                failedItems.push({ kind: deployConfig.type, name: entity.name, error: e.message });
                 failedCount++;
             }
         }
@@ -392,29 +455,63 @@ async function deployAllCommand(_options) {
             }
             else {
                 console.warn('  ⚠️  Failed to deploy persona');
+                failedItems.push({
+                    kind: 'persona',
+                    name: 'persona',
+                    error: deployResult.error?.message || 'Unknown error',
+                });
                 failedCount++;
             }
         }
     }
     catch (e) {
         console.warn(`  ⚠️  Error deploying persona: ${e.message}`);
+        failedItems.push({ kind: 'persona', name: 'persona', error: e.message });
         failedCount++;
     }
     console.log();
     if (deployedCount > 0) {
         writeSuccess(`✅ Deployed ${deployedCount} primitive${deployedCount !== 1 ? 's' : ''} successfully`);
     }
-    if (failedCount > 0) {
-        console.warn(`⚠️  ${failedCount} deployment${failedCount !== 1 ? 's' : ''} failed`);
-    }
     if (deployedCount === 0 && failedCount === 0) {
         writeInfo('ℹ️  No primitives found to deploy.');
     }
+    // Aggregate failure block. Deploy failures are management-plane — no execution logs
+    // exist for them. Suggest retrying rather than checking logs.
+    if (failedItems.length > 0) {
+        console.warn(`\n⚠️  ${failedItems.length} deployment${failedItems.length !== 1 ? 's' : ''} failed:`);
+        for (const item of failedItems) {
+            console.warn(`     ${item.kind} "${item.name}": ${item.error}`);
+        }
+        writeTip('Re-deploy failed items with: lua deploy all --force');
+    }
     trackEvent('cli_deploy_completed', {
         primitive_type: 'all',
         force_mode: true,
         deployed_count: deployedCount,
         failed_count: failedCount,
     });
+    if (deployedCount > 0 && failedCount === 0) {
+        writeHintBlock({
+            headline: 'All deployed. Generate traffic first, then inspect:',
+            lines: [
+                { label: 'Test:', command: 'lua chat -e production -m "your test message"' },
+                { label: 'Inspect:', command: buildLogsCommand({ limit: 10 }) },
+            ],
+            when: 'success',
+        });
+    }
+    else if (deployedCount > 0 && failedCount > 0) {
+        // Some succeeded — remind them to test what's live, and retry failures.
+        writeHintBlock({
+            headline: 'Partial deploy. Test what is live and re-deploy failures:',
+            lines: [
+                { label: 'Test live:', command: 'lua chat -e production -m "your test message"' },
+                { label: 'Re-deploy:', command: 'lua deploy all --force' },
+            ],
+            when: 'partial',
+        });
+    }
+    // Total failure: no hint — errors already shown above.
 }
 //# sourceMappingURL=deploy.js.map