@equinor/fusion-framework-cli-plugin-copilot 2.0.2 → 2.0.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @equinor/fusion-framework-cli-plugin-copilot
 
+## 2.0.4
+
+### Patch Changes
+
+- 3dcaae6: Internal: bump `chalk` from `5.6.2` to `6.0.0`. No API changes affect this repo's usage; chalk 6 raises its own Node.js requirement to `>=22`, already satisfied by this repo's `>=24` engines requirement.
+
+## 2.0.3
+
+### Patch Changes
+
+- 80c3e4a: Internal: Consolidate five single-export utility files under `src/utils/` into `helpers.ts` to reduce file fragmentation. No change to the public API.
+- 80c3e4a: Internal: added a missing intent comment for array-spread logic; no public API changes.
+- 80c3e4a: Internal: add clarifying intent comments and split `eval-resolve.ts`, `utils/agent-browser.ts`, `utils/process.ts`, `utils/server.ts`, `utils/daemon.ts`, and `commands/app/format.ts` into single-export modules re-exported from the existing barrels; no public API or behavior changes.
+- 80c3e4a: Internal: add clarifying intent comments throughout `commands/app/**` and split `tools/write-file.ts`'s `createAppendFileTool` into its own `tools/append-file.ts` module; no public API or behavior changes.
+- 80c3e4a: Internal: renamed 53 source files across `ai-base`, `ai-chat`, `ai-index`, and `copilot` to comply with the `filename-convention` lint rule (e.g. `config.ts` → `load-fusion-ai-config.ts`, `tools/write-file.ts` → `tools/create-write-file-tool.ts`, `prompts/plan.prompt.ts` → `prompts/create-plan-prompt.ts`). No public API changes.
+
 ## 2.0.2
 
 ### Patch Changes

package/dist/esm/commands/app/{session-logger.js → attach-session-logger.js}

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import ora from 'ora';
-import { tryFormatMessage } from './format.js';
+import { tryFormatMessage } from './try-format-message.js';
 const TOOL_ICONS = {
     browser_screenshot: '📷',
     browser_navigate: '🌐',
@@ -22,7 +22,9 @@ export function attachSessionLogger(session, options) {
     const pendingTools = new Map();
     let spinner = null;
     function syncSpinner() {
+        // No pending tools means the spinner has nothing left to show
         if (pendingTools.size === 0) {
+            // Stop the spinner only if one was actually running
             if (spinner) {
                 spinner.stop();
                 spinner = null;
@@ -30,6 +32,7 @@ export function attachSessionLogger(session, options) {
             return;
         }
         const text = [...pendingTools.values()].join(chalk.dim(' | '));
+        // Reuse the existing spinner instance rather than starting a second one
         if (spinner) {
             spinner.text = text;
         }
@@ -38,6 +41,7 @@ export function attachSessionLogger(session, options) {
         }
     }
     function pauseSpinner() {
+        // Only stop the spinner if one is actually running
         if (spinner) {
             spinner.stop();
             spinner = null;
@@ -50,6 +54,7 @@ export function attachSessionLogger(session, options) {
         syncSpinner();
     }
     session.on((event) => {
+        // Dispatch on the Copilot SDK session event type to render the right log line
         switch (event.type) {
             case 'tool.execution_start': {
                 const { toolCallId, toolName, arguments: args } = event.data;
@@ -62,6 +67,7 @@ export function attachSessionLogger(session, options) {
             }
             case 'tool.execution_complete': {
                 const label = pendingTools.get(event.data.toolCallId);
+                // Only log completion for tools we actually tracked the start of
                 if (label) {
                     pendingTools.delete(event.data.toolCallId);
                     logCompletion(label, event.data.success);
@@ -70,6 +76,7 @@ export function attachSessionLogger(session, options) {
             }
             case 'external_tool.completed': {
                 const label = pendingTools.get(event.data.requestId);
+                // Only log completion for tools we actually tracked the start of
                 if (label) {
                     pendingTools.delete(event.data.requestId);
                     logCompletion(label, true);
@@ -83,9 +90,11 @@ export function attachSessionLogger(session, options) {
                 break;
             }
             case 'assistant.message': {
+                // Skip empty assistant messages (e.g. tool-only turns)
                 if (event.data.content) {
                     pauseSpinner();
                     const formatted = tryFormatMessage(event.data.content);
+                    // Prefer the structured plan/verdict/step-result rendering when recognised
                     if (formatted) {
                         console.log(formatted);
                     }
@@ -107,6 +116,7 @@ export function attachSessionLogger(session, options) {
             }
             case 'permission.completed': {
                 const label = pendingTools.get(event.data.requestId);
+                // Only log completion for permissions we actually tracked the request of
                 if (label) {
                     const approved = event.data.result?.kind === 'approved';
                     pendingTools.delete(event.data.requestId);
@@ -116,8 +126,10 @@ export function attachSessionLogger(session, options) {
             }
             case 'session.tools_updated': {
                 const negotiatedModel = event.data.model;
+                // Only log tooling info once the server has actually negotiated a model
                 if (negotiatedModel) {
                     console.log(chalk.dim(`💾  ${negotiatedModel}`));
+                    // Warn the user when the server picked a different model than requested
                     if (options?.requestedModel && negotiatedModel !== options.requestedModel) {
                         console.log(chalk.yellow(`⚠️  Requested model "${options.requestedModel}" but server negotiated "${negotiatedModel}"`));
                     }
@@ -141,6 +153,7 @@ export function attachSessionLogger(session, options) {
             }
             case 'session.info': {
                 const { message } = event.data;
+                // Skip empty info events
                 if (message) {
                     pauseSpinner();
                     console.log(chalk.dim(`ℹ️  ${message}`));
@@ -150,6 +163,7 @@ export function attachSessionLogger(session, options) {
             }
             case 'assistant.intent': {
                 const { intent } = event.data;
+                // Skip empty intent events
                 if (intent) {
                     pauseSpinner();
                     console.log(chalk.yellow(`🎯 ${intent}`));
@@ -166,4 +180,4 @@ export function attachSessionLogger(session, options) {
         stop: () => pauseSpinner(),
     };
 }
-//# sourceMappingURL=session-logger.js.map
+//# sourceMappingURL=attach-session-logger.js.map

package/dist/esm/commands/app/attach-session-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-session-logger.js","sourceRoot":"","sources":["../../../../src/commands/app/attach-session-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AAItB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,UAAU,GAA2B;IACzC,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,OAAqC;IAErC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,IAAI,OAAO,GAAkC,IAAI,CAAC;IAElD,SAAS,WAAW;QAClB,8DAA8D;QAC9D,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC5B,oDAAoD;YACpD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,wEAAwE;QACxE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IAED,SAAS,YAAY;QACnB,mDAAmD;QACnD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,SAAS,aAAa,CAAC,KAAa,EAAE,EAAW;QAC/C,YAAY,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;QAClC,WAAW,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE;QACnB,8EAA8E;QAC9E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,sBAAsB,EAAE,CAAC;gBAC5B,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;gBAC7D,MAAM,MAAM,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,QAAQ,CAAC;gBACvE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;gBAC1C,MAAM,KAAK,GACT,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,QAAQ,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC;gBACzF,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBACpC,WAAW,EAAE,CAAC;gBACd,MAAM;YACR,CAAC;YACD,KAAK,yBAAyB,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACtD,iEAAiE;gBACjE,IAAI,KAAK,EAAE,CAAC;oBACV,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC3C,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC3C,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,yBAAyB,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrD,iEAAiE;gBACjE,IAAI,KAAK,EAAE,CAAC;oBACV,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC1C,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,EAAE,CAAC;gBAC3B,YAAY,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACnD,WAAW,EAAE,CAAC;gBACd,MAAM;YACR,CAAC;YACD,KAAK,mBAAmB,EAAE,CAAC;gBACzB,uDAAuD;gBACvD,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACvB,YAAY,EAAE,CAAC;oBACf,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACvD,2EAA2E;oBAC3E,IAAI,SAAS,EAAE,CAAC;wBACd,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACzB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACvD,CAAC;oBACD,WAAW,EAAE,CAAC;gBAChB,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,sBAAsB,EAAE,CAAC;gBAC5B,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;gBACpD,MAAM,QAAQ,GACZ,iBAAiB,CAAC,IAAI,KAAK,aAAa;oBACtC,CAAC,CAAC,iBAAiB,CAAC,QAAQ;oBAC5B,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBAC7B,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,QAAQ,EAAE,CAAC,CAAC;gBAC9C,WAAW,EAAE,CAAC;gBACd,MAAM;YACR,CAAC;YACD,KAAK,sBAAsB,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrD,yEAAyE;gBACzE,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,UAAU,CAAC;oBACxD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC1C,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACjC,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,uBAAuB,EAAE,CAAC;gBAC7B,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,KAA2B,CAAC;gBAC/D,wEAAwE;gBACxE,IAAI,eAAe,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,eAAe,EAAE,CAAC,CAAC,CAAC;oBACjD,wEAAwE;oBACxE,IAAI,OAAO,EAAE,cAAc,IAAI,eAAe,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC;wBAC1E,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,wBAAwB,OAAO,CAAC,cAAc,4BAA4B,eAAe,GAAG,CAC7F,CACF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,yBAAyB,CAAC;YAC/B,KAAK,cAAc,EAAE,CAAC;gBACpB,MAAM;YACR,CAAC;YACD,KAAK,yBAAyB,CAAC;YAC/B,KAAK,2BAA2B,CAAC;YACjC,KAAK,2BAA2B,CAAC;YACjC,KAAK,sBAAsB,CAAC;YAC5B,KAAK,oBAAoB,CAAC;YAC1B,KAAK,iBAAiB,CAAC;YACvB,KAAK,2BAA2B,CAAC;YACjC,KAAK,cAAc,CAAC;YACpB,KAAK,oBAAoB,EAAE,CAAC;gBAC1B,MAAM;YACR,CAAC;YACD,KAAK,cAAc,EAAE,CAAC;gBACpB,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,IAA4B,CAAC;gBACvD,yBAAyB;gBACzB,IAAI,OAAO,EAAE,CAAC;oBACZ,YAAY,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;oBACzC,WAAW,EAAE,CAAC;gBAChB,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,EAAE,CAAC;gBACxB,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAA2B,CAAC;gBACrD,2BAA2B;gBAC3B,IAAI,MAAM,EAAE,CAAC;oBACX,YAAY,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC;oBAC1C,WAAW,EAAE,CAAC;gBAChB,CAAC;gBACD,MAAM;YACR,CAAC;YACD;gBACE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnB,MAAM;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;KAC3B,CAAC;AACJ,CAAC"}

package/dist/esm/commands/app/{command.js → copilot-command.js}

@@ -1,16 +1,17 @@
 import { createCommand } from 'commander';
 import { basename } from 'node:path';
 import { resetDaemon, cleanup, createRunDir } from '../../utils/index.js';
-import { runLogin } from './login.js';
-import { resolveEvalCommandInput, resolveEvalFiles } from '../../eval-resolve.js';
-import { createSession } from './eval.js';
-import { startAppServer } from './server.js';
-import { attachSessionLogger } from './session-logger.js';
-import { formatVerdict } from './format.js';
+import { runLogin } from './run-login.js';
+import { resolveEvalCommandInput } from '../../resolve-eval-command-input.js';
+import { resolveEvalFiles } from '../../resolve-eval-files.js';
+import { createSession } from './create-session.js';
+import { startAppServer } from './start-app-server.js';
+import { attachSessionLogger } from './attach-session-logger.js';
+import { formatVerdict } from './format-verdict.js';
 import { existsSync, readFileSync } from 'node:fs';
-import { createPlanPrompt } from './prompts/plan.prompt.js';
-import { createStepPrompt } from './prompts/step.prompt.js';
-import { createJudgePrompt } from './prompts/judge.prompt.js';
+import { createPlanPrompt } from './prompts/create-plan-prompt.js';
+import { createStepPrompt } from './prompts/create-step-prompt.js';
+import { createJudgePrompt } from './prompts/create-judge-prompt.js';
 import chalk from 'chalk';
 /**
  * CLI command: `copilot app eval <path-or-eval>`
@@ -51,6 +52,7 @@ const _appEvalCommand = createCommand('eval')
     const absAppPath = resolvedInput.appPath;
     const port = parseInt(options.port, 10);
     const verbose = options.verbose;
+    // Reject ambiguous input that selects an eval two different ways
     if (resolvedInput.evalFile && options.eval) {
         console.error('❌ Do not combine a positional eval markdown file with --eval');
         process.exit(1);
@@ -64,7 +66,9 @@ const _appEvalCommand = createCommand('eval')
     const evalFiles = resolvedInput.evalFile
         ? [resolvedInput.evalFile]
         : resolveEvalFiles(absAppPath, options.eval);
-    console.log(`📋 Found ${evalFiles.length} eval(s): ${evalFiles.map((f) => basename(f)).join(', ')}`);
+    // Summarize which eval files were discovered before the run starts
+    const evalFileNames = evalFiles.map((f) => basename(f)).join(', ');
+    console.log(`📋 Found ${evalFiles.length} eval(s): ${evalFileNames}`);
     // Start the app dev server (unless --url provides an already-running URL)
     const { serverProcess, appUrl } = await startAppServer(absAppPath, {
         port,
@@ -87,6 +91,7 @@ const _appEvalCommand = createCommand('eval')
     });
     let failures = 0;
     try {
+        // Run every resolved eval file sequentially so output stays readable
         for (const evalFilePath of evalFiles) {
             const evalName = basename(evalFilePath, '.md');
             const query = readFileSync(evalFilePath, 'utf-8').trim();
@@ -107,11 +112,13 @@ const _appEvalCommand = createCommand('eval')
                 // ── Phase 1: Plan ──────────────────────────────────────────
                 await session.sendAndWait({ prompt: createPlanPrompt(query, ctx) }, 300_000);
                 const planPath = `${runDir}/plan.json`;
+                // Bail out of this eval when the planning phase produced no plan file
                 if (!existsSync(planPath)) {
                     console.error(chalk.red(`❌ Agent did not produce ${planPath}. The planning phase may have failed silently.`));
                     session.disconnect();
                     logger.stop();
                     failures++;
+                    // Skip execution/judging phases; this eval already failed at planning
                     continue;
                 }
                 const plan = JSON.parse(readFileSync(planPath, 'utf-8'));
@@ -119,6 +126,7 @@ const _appEvalCommand = createCommand('eval')
                 // ── Phase 2: Execute + Evaluate each step ──────────────────
                 for (const step of plan.steps) {
                     console.log(chalk.cyan(`\n── Scenario: ${step.scenario}`));
+                    // Print each acceptance criterion the agent will be judged against
                     for (const c of step.criteria) {
                         console.log(chalk.dim(`   • ${c}`));
                     }
@@ -131,9 +139,11 @@ const _appEvalCommand = createCommand('eval')
                 logger.stop();
                 // Print the verdict
                 const verdictPath = `${runDir}/verdict.json`;
+                // Only report a verdict when the judge phase actually produced one
                 if (existsSync(verdictPath)) {
                     const verdict = JSON.parse(readFileSync(verdictPath, 'utf-8'));
                     console.log(formatVerdict(verdict));
+                    // A failing verdict counts toward the overall exit-code failure total
                     if (!verdict.pass)
                         failures++;
                 }
@@ -146,6 +156,7 @@ const _appEvalCommand = createCommand('eval')
                 logger?.stop();
                 const msg = err instanceof Error ? err.message : String(err);
                 console.error(chalk.red(`\n❌ Eval "${evalName}" failed: ${msg}`));
+                // Print the stack trace too when one is available for debugging
                 if (err instanceof Error && err.stack) {
                     console.error(chalk.dim(err.stack));
                 }
@@ -173,4 +184,4 @@ const _appCommand = createCommand('app')
 export const copilotCommand = createCommand('copilot')
     .description('GitHub Copilot SDK powered commands')
     .addCommand(_appCommand);
-//# sourceMappingURL=command.js.map
+//# sourceMappingURL=copilot-command.js.map

package/dist/esm/commands/app/copilot-command.js.map

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

package/dist/esm/commands/app/{eval.js → create-session.js}

@@ -2,10 +2,11 @@ import { mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { ab, abErrorMessage } from '../../utils/index.js';
 import { createAgentBrowserTools } from './tools/index.js';
-import { createWriteFileTool, createAppendFileTool } from './tools/write-file.js';
-import { createReadFileTool } from './tools/read-file.js';
-import { createSystemPrompt } from './prompts/system.prompt.js';
-import { createDevServerContext } from './prompts/system.dev-server.prompt.js';
+import { createWriteFileTool } from './tools/create-write-file-tool.js';
+import { createAppendFileTool } from './tools/create-append-file-tool.js';
+import { createReadFileTool } from './tools/create-read-file-tool.js';
+import { createSystemPrompt } from './prompts/create-system-prompt.js';
+import { createDevServerContext } from './prompts/create-dev-server-context.js';
 /**
  * Lazily imports the Copilot SDK to avoid module resolution errors at CLI startup.
  *
@@ -27,6 +28,7 @@ export const createSession = async (options) => {
         createWriteFileTool(ctx.outDir, defineTool),
         createAppendFileTool(ctx.outDir, defineTool),
     ];
+    // Combine built-in browser and file tools with any caller-supplied tools
     const tools = [
         ...createBrowserTools(defineTool, {
             cwd: ctx.outDir,
@@ -89,4 +91,4 @@ function createBrowserTools(defineTool, options) {
     };
     return createAgentBrowserTools({ outDir, invoke }, defineTool);
 }
-//# sourceMappingURL=eval.js.map
+//# sourceMappingURL=create-session.js.map

package/dist/esm/commands/app/create-session.js.map

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

package/dist/esm/commands/app/format-plan.js

@@ -0,0 +1,24 @@
+import chalk from 'chalk';
+import { truncate } from './truncate.js';
+/**
+ * Renders a structured plan as a human-readable summary.
+ *
+ * @param plan - The plan to render, containing a summary and ordered steps.
+ * @returns A multi-line string suitable for console output.
+ */
+export function formatPlan(plan) {
+    const lines = [
+        '',
+        chalk.bold(`📋 ${plan.summary}`),
+        '',
+        ...plan.steps.flatMap((s, si) => [
+            `  ${chalk.dim(`${si + 1}.`)} ${s.scenario}`,
+            ...s.criteria
+                // Truncate each criterion so long descriptions don't wrap the terminal
+                .map((c) => chalk.dim(`     • ${truncate(c, 70)}`)),
+        ]),
+        '',
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=format-plan.js.map

package/dist/esm/commands/app/format-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-plan.js","sourceRoot":"","sources":["../../../../src/commands/app/format-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,EAAE;QACF,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/B,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;YAC5C,GAAG,CAAC,CAAC,QAAQ;gBACX,uEAAuE;iBACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;SACtD,CAAC;QACF,EAAE;KACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/esm/commands/app/format-step-result.js

@@ -0,0 +1,14 @@
+import chalk from 'chalk';
+import { statusIcon } from './status-icon.js';
+/**
+ * Renders a single step execution result.
+ *
+ * @param result - The step result to render, including its outcome, note, and evidence.
+ * @returns A formatted two-line string describing the step outcome.
+ */
+export function formatStepResult(result) {
+    const icon = statusIcon(result.ok);
+    const files = result.evidence.length ? chalk.dim(` [${result.evidence.join(', ')}]`) : '';
+    return `  ${icon}  ${result.criterion}\n${chalk.dim(`     ${result.note}`)}${files}`;
+}
+//# sourceMappingURL=format-step-result.js.map

package/dist/esm/commands/app/format-step-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-step-result.js","sourceRoot":"","sources":["../../../../src/commands/app/format-step-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,OAAO,KAAK,IAAI,KAAK,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC;AACvF,CAAC"}

package/dist/esm/commands/app/format-verdict.js

@@ -0,0 +1,38 @@
+import chalk from 'chalk';
+import { statusIcon } from './status-icon.js';
+/**
+ * Renders the final verdict as a full-width coloured report.
+ *
+ * @param verdict - The verdict to render, including per-step results, reasoning, and UX feedback.
+ * @returns A multi-line string suitable for console output.
+ */
+export function formatVerdict(verdict) {
+    const bar = '═'.repeat(60);
+    const banner = verdict.pass
+        ? chalk.bgGreen.black.bold(' ✅ PASS ')
+        : chalk.bgRed.white.bold(' ❌ FAIL ');
+    const lines = [
+        '',
+        bar,
+        `  ${banner}`,
+        bar,
+        '',
+        ...verdict.steps
+            // Render each step's outcome as a status glyph, criterion, and note
+            .map((s) => `  ${statusIcon(s.ok)}  ${s.criterion}\n${chalk.dim(`     ${s.note}`)}`),
+        '',
+        chalk.dim(`  ${verdict.reasoning}`),
+        '',
+    ];
+    // Append optional UX feedback only when the judge actually provided any
+    if (verdict.ux && verdict.ux.length > 0) {
+        lines.push(chalk.bold('  💡 UX Feedback'), '');
+        // List every UX hint as its own bullet line
+        for (const hint of verdict.ux) {
+            lines.push(chalk.yellow(`  • ${hint}`));
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=format-verdict.js.map

package/dist/esm/commands/app/format-verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-verdict.js","sourceRoot":"","sources":["../../../../src/commands/app/format-verdict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI;QACzB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QACtC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,GAAG;QACH,KAAK,MAAM,EAAE;QACb,GAAG;QACH,EAAE;QACF,GAAG,OAAO,CAAC,KAAK;YACd,oEAAoE;aACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACtF,EAAE;QACF,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,EAAE;KACH,CAAC;IAEF,wEAAwE;IACxE,IAAI,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,4CAA4C;QAC5C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/esm/commands/app/prompts/{system.dev-server.prompt.js → create-dev-server-context.js}

@@ -18,4 +18,4 @@ Fusion dev-server DOM:
 - URL pattern: /apps/{appKey} → ${ctx.url}
   `.trim();
 };
-//# sourceMappingURL=system.dev-server.prompt.js.map
+//# sourceMappingURL=create-dev-server-context.js.map

package/dist/esm/commands/app/prompts/create-dev-server-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-dev-server-context.js","sourceRoot":"","sources":["../../../../../src/commands/app/prompts/create-dev-server-context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAA4B,EAAU,EAAE;IAC7E,OAAO;;;;;;kCAMyB,GAAG,CAAC,GAAG;GACtC,CAAC,IAAI,EAAE,CAAC;AACX,CAAC,CAAC"}

package/dist/esm/commands/app/prompts/{execute-step.prompt.js → create-execute-step-prompt.js}

@@ -41,4 +41,4 @@ When done, your work will be evaluated against the step's passEvidence and failE
 Do NOT output markdown or explanations — only use browser tool calls and collect evidence.
   `.trim();
 };
-//# sourceMappingURL=execute-step.prompt.js.map
+//# sourceMappingURL=create-execute-step-prompt.js.map

package/dist/esm/commands/app/prompts/create-execute-step-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-execute-step-prompt.js","sourceRoot":"","sources":["../../../../../src/commands/app/prompts/create-execute-step-prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,OAAiB,EACjB,GAA4B,EACpB,EAAE;IACV,OAAO;;;WAGE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;;mBAExB,GAAG,CAAC,GAAG;sBACJ,GAAG,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;GAuB7B,CAAC,IAAI,EAAE,CAAC;AACX,CAAC,CAAC"}

package/dist/esm/commands/app/prompts/{judge.prompt.js → create-judge-prompt.js}

@@ -15,6 +15,7 @@ function collectEvidence(outDir) {
     const parts = [];
     // ── executions.jsonl ──
     const execPath = join(outDir, 'executions.jsonl');
+    // Fall back to a placeholder note when the executions log is missing
     if (existsSync(execPath)) {
         parts.push('### executions.jsonl', readFileSync(execPath, 'utf-8').trim());
     }
@@ -23,10 +24,13 @@ function collectEvidence(outDir) {
     }
     // ── evidence/ directory ──
     const evidenceDir = join(outDir, 'evidence');
+    // Only scan for evidence files when the directory actually exists
     if (existsSync(evidenceDir)) {
         const files = readdirSync(evidenceDir).sort();
+        // Inline readable text evidence; list binary evidence by name only
         for (const file of files) {
             const ext = extname(file).toLowerCase();
+            // Inline the content of readable text extensions; list other files by name only
             if (TEXT_EXTENSIONS.has(ext)) {
                 const content = readFileSync(join(evidenceDir, file), 'utf-8').trim();
                 parts.push(`### evidence/${file}`, content);
@@ -113,4 +117,4 @@ Only include genuine observations from the evidence. Skip "ux" if nothing stands
 If evidence for a criterion is missing or ambiguous, fail it.
   `.trim();
 };
-//# sourceMappingURL=judge.prompt.js.map
+//# sourceMappingURL=create-judge-prompt.js.map

package/dist/esm/commands/app/prompts/create-judge-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-judge-prompt.js","sourceRoot":"","sources":["../../../../../src/commands/app/prompts/create-judge-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,iEAAiE;AACjE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtF;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yBAAyB;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAClD,qEAAqE;IACrE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,kEAAkE;IAClE,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,mEAAmE;QACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACxC,gFAAgF;YAChF,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,EAAE,kBAAkB,GAAG,cAAc,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAA4B,EAAU,EAAE;IACxE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO;;;;;;EAMP,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDP,CAAC,IAAI,EAAE,CAAC;AACX,CAAC,CAAC"}

package/dist/esm/commands/app/prompts/{plan.prompt.js → create-plan-prompt.js}

@@ -44,4 +44,4 @@ Rules:
 - Keep criteria directly traceable to the spec. Do NOT invent criteria.
   `.trim();
 };
-//# sourceMappingURL=plan.prompt.js.map
+//# sourceMappingURL=create-plan-prompt.js.map

package/dist/esm/commands/app/prompts/create-plan-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plan-prompt.js","sourceRoot":"","sources":["../../../../../src/commands/app/prompts/create-plan-prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,GAA4B,EAAU,EAAE;IACtF,OAAO;;;EAGP,KAAK;;mBAEY,GAAG,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BvB,CAAC,IAAI,EAAE,CAAC;AACX,CAAC,CAAC"}

package/dist/esm/commands/app/prompts/{step.prompt.js → create-step-prompt.js}

@@ -8,8 +8,9 @@
  * @param ctx - Runtime context with output directory and app URL
  * @returns The fully interpolated prompt string
  */
-export const createStepPrompt = (step, ctx) => {
+export const createStepPrompt = (step, _ctx) => {
     const slug = slugify(step.scenario);
+    // Render each criterion with its expected pass/fail evidence for the prompt
     const criteriaBlock = step.criteria
         .map((c, i) => `${i + 1}. ${c}\n   Pass: ${step.pass[i] ?? ''}\n   Fail: ${step.fail[i] ?? ''}`)
         .join('\n');
@@ -39,4 +40,4 @@ function slugify(text) {
         .replace(/^-|-$/g, '')
         .slice(0, 60);
 }
-//# sourceMappingURL=step.prompt.js.map
+//# sourceMappingURL=create-step-prompt.js.map

package/dist/esm/commands/app/prompts/create-step-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-step-prompt.js","sourceRoot":"","sources":["../../../../../src/commands/app/prompts/create-step-prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAc,EAAE,IAA6B,EAAU,EAAE;IACxF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,4EAA4E;IAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;SAC/F,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;YACG,IAAI,CAAC,QAAQ;;;EAGvB,aAAa;;;2CAG4B,IAAI;;;kGAGmD,IAAI;GACnG,CAAC,IAAI,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;;;GAKG;AACH,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/esm/commands/app/prompts/{system.prompt.js → create-system-prompt.js}

@@ -74,4 +74,4 @@ and file tools throughout.
 - Never fabricate evidence. If a tool call fails, report the failure honestly.
   `.trim();
 };
-//# sourceMappingURL=system.prompt.js.map
+//# sourceMappingURL=create-system-prompt.js.map

package/dist/esm/commands/app/prompts/create-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-system-prompt.js","sourceRoot":"","sources":["../../../../../src/commands/app/prompts/create-system-prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAA4B,EAAU,EAAE;IACzE,OAAO;;;;0BAIiB,GAAG,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2D9B,CAAC,IAAI,EAAE,CAAC;AACX,CAAC,CAAC"}

package/dist/esm/commands/app/{login.js → run-login.js}

@@ -17,11 +17,13 @@ import { ab, resolveAppKey, cleanup, resetDaemon, sleep, stripAnsi, waitForServe
  */
 export async function runLogin(absAppPath, port, host) {
     const pkgJsonPath = join(absAppPath, 'package.json');
+    // Login needs a valid Fusion app directory; bail out clearly if this isn't one
     if (!existsSync(pkgJsonPath)) {
         console.error(`❌ No package.json found at ${absAppPath}`);
         process.exit(1);
     }
     const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+    // The app name is required to resolve the appKey later
     if (!pkgJson.name) {
         console.error(`❌ package.json at ${absAppPath} has no "name" field`);
         process.exit(1);
@@ -37,6 +39,7 @@ export async function runLogin(absAppPath, port, host) {
     });
     const serverUrl = `http://localhost:${port}`;
     const ready = await waitForServer(serverUrl, 60);
+    // Abort login when the dev server never comes up within the timeout
     if (!ready) {
         console.error('❌ Server failed to start within 60s');
         cleanup(serverProcess);
@@ -57,6 +60,7 @@ export async function runLogin(absAppPath, port, host) {
     // Wait for the Fusion app to initialise (browser console emits "✓ Done" after auth)
     console.log('⏳ Waiting for app to initialize after login... (Ctrl+C to finish early)');
     const initialized = await pollConsole((logs) => stripAnsi(logs).includes('Done'), 300_000);
+    // Report success or a soft timeout without failing the login flow
     if (initialized) {
         await sleep(2000);
         console.log('✅ Login complete — session saved.');
@@ -68,4 +72,4 @@ export async function runLogin(absAppPath, port, host) {
     console.log('🌐 Browser still open. Press Ctrl+C to exit.');
     await new Promise(() => { }); // block until SIGINT
 }
-//# sourceMappingURL=login.js.map
+//# sourceMappingURL=run-login.js.map

package/dist/esm/commands/app/run-login.js.map

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

package/dist/esm/commands/app/{server.js → start-app-server.js}

@@ -12,10 +12,12 @@ import { resolveAppKey, cleanup, waitForServer } from '../../utils/index.js';
  */
 function freePort(port) {
     try {
+        // Drop the empty string lsof emits when no matching process was found
         const pids = execSync(`lsof -ti tcp:${port}`, { encoding: 'utf-8' })
             .trim()
             .split('\n')
             .filter(Boolean);
+        // Terminate each stale process bound to the port
         for (const pid of pids) {
             try {
                 process.kill(parseInt(pid, 10), 'SIGTERM');
@@ -24,6 +26,7 @@ function freePort(port) {
                 // already dead
             }
         }
+        // Only log when we actually killed something
         if (pids.length) {
             console.log(`🔄 Killed stale process(es) on port ${port}: ${pids.join(', ')}`);
         }
@@ -50,11 +53,13 @@ export async function startAppServer(absAppPath, options) {
         return { serverProcess: undefined, appUrl: options.url };
     }
     const pkgJsonPath = join(absAppPath, 'package.json');
+    // Startup needs a valid Fusion app directory; bail out clearly if this isn't one
     if (!existsSync(pkgJsonPath)) {
         console.error(`❌ No package.json found at ${absAppPath}`);
         process.exit(1);
     }
     const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+    // The app name is required to resolve the appKey later
     if (!pkgJson.name) {
         console.error(`❌ package.json at ${absAppPath} has no "name" field`);
         process.exit(1);
@@ -71,6 +76,7 @@ export async function startAppServer(absAppPath, options) {
     });
     const serverUrl = `http://localhost:${options.port}`;
     const ready = await waitForServer(serverUrl, 60);
+    // Abort startup when the dev server never comes up within the timeout
     if (!ready) {
         console.error('❌ Server failed to start within 60s');
         cleanup(serverProcess);
@@ -80,4 +86,4 @@ export async function startAppServer(absAppPath, options) {
     console.log(`✅ Server ready at ${appUrl}`);
     return { serverProcess, appUrl };
 }
-//# sourceMappingURL=server.js.map
+//# sourceMappingURL=start-app-server.js.map

package/dist/esm/commands/app/start-app-server.js.map

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

package/dist/esm/commands/app/status-icon.js

@@ -0,0 +1,18 @@
+import chalk from 'chalk';
+/**
+ * Renders a status glyph for a step or verdict outcome.
+ *
+ * @param ok - Outcome value: `true` (pass), `false` (fail), or a string label
+ *   such as `'blocked'` or `'flaky'` for anything in between.
+ * @returns A single coloured glyph representing the outcome.
+ */
+export function statusIcon(ok) {
+    // A literal boolean outcome maps directly to pass/fail glyphs
+    if (ok === true)
+        return chalk.green('✔');
+    // An explicit failure gets its own glyph, distinct from unknown/other states
+    if (ok === false)
+        return chalk.red('✖');
+    return chalk.yellow('⚠'); // "blocked", "flaky", etc.
+}
+//# sourceMappingURL=status-icon.js.map

package/dist/esm/commands/app/status-icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-icon.js","sourceRoot":"","sources":["../../../../src/commands/app/status-icon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,EAAoB;IAC7C,8DAA8D;IAC9D,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,6EAA6E;IAC7E,IAAI,EAAE,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B;AACvD,CAAC"}