@sweny-ai/core 0.1.170 → 0.1.172

package/dist/agent-env.d.ts

@@ -232,7 +232,8 @@ export declare function noPushGitConfig(dir: string): Array<[string, string]>;
  * them. A deliberate agent on an unsandboxed run that finds a credential on
  * disk (an ssh key without a passphrase, a keychain entry, a token persisted
  * in `.git/config` by a checkout) can still push. Run sandboxed (the sandbox
- * hides credential files such as `~/.ssh`) and without push credentials in CI
+ * hides credential files such as `~/.ssh`, and a checkout's persisted token,
+ * see git-credentials.ts) and without push credentials in CI
  * for a guarantee; under a strict harness policy an unsandboxed staged write
  * node is refused (`stagedWrite` in policy.ts). `enabled` false returns `env`
  * unchanged. Pure apart from creating {@link noPushDir} once.

package/dist/agent-env.js

@@ -646,7 +646,8 @@ export function noPushGitConfig(dir) {
  * them. A deliberate agent on an unsandboxed run that finds a credential on
  * disk (an ssh key without a passphrase, a keychain entry, a token persisted
  * in `.git/config` by a checkout) can still push. Run sandboxed (the sandbox
- * hides credential files such as `~/.ssh`) and without push credentials in CI
+ * hides credential files such as `~/.ssh`, and a checkout's persisted token,
+ * see git-credentials.ts) and without push credentials in CI
  * for a guarantee; under a strict harness policy an unsandboxed staged write
  * node is refused (`stagedWrite` in policy.ts). `enabled` false returns `env`
  * unchanged. Pure apart from creating {@link noPushDir} once.
@@ -670,10 +671,15 @@ export function withPushBlocked(env, enabled) {
         n++;
     }
     out.GIT_CONFIG_COUNT = String(n);
-    const ownSsh = env.GIT_SSH_COMMAND ?? (env.GIT_SSH ? shQuote(env.GIT_SSH) : undefined);
+    const wrapper = shQuote(path.join(dir, "ssh"));
+    // Applied twice, GIT_SSH_COMMAND is already our wrapper: keep the operator's command it recorded,
+    // or the wrapper would exec itself forever on a fetch.
+    const ownSsh = env.GIT_SSH_COMMAND === wrapper
+        ? env.SWENY_NO_PUSH_SSH
+        : (env.GIT_SSH_COMMAND ?? (env.GIT_SSH ? shQuote(env.GIT_SSH) : undefined));
     if (ownSsh)
         out.SWENY_NO_PUSH_SSH = ownSsh;
-    out.GIT_SSH_COMMAND = shQuote(path.join(dir, "ssh"));
+    out.GIT_SSH_COMMAND = wrapper;
     out.GIT_SSH_VARIANT = "ssh";
     out.GIT_ASKPASS = path.join(dir, "askpass");
     out.GIT_TERMINAL_PROMPT = "0";

package/dist/browser.d.ts

@@ -24,3 +24,5 @@ export { isWhenExpression, whenLabel, parseExpression, evaluateExpression, check
 export type { ExprNode, ExpressionScope, ExpressionResult } from "./when.js";
 export { workflowToFlow, flowToWorkflow, applyExecutionEvent, exportAsTypescript, getSkillCatalog } from "./studio.js";
 export type { FlowNode, SkillNodeData, FlowEdge } from "./studio.js";
+export { SWENY_TAGLINE, PALETTE, ROLE_COLORS, SURFACE_COLORS, GLYPHS, SPINNER_FRAMES, SPINNER_INTERVAL_MS, TICKET_BOX, MERMAID_CLASS_DEFS, MERMAID_EDGE_STYLES, } from "./theme.js";
+export type { ColorRole, GlyphKey, GlyphSet, TicketBox, DiagramNodeStatus } from "./theme.js";

package/dist/browser.js

@@ -27,3 +27,6 @@ export { workflowZ, nodeZ, edgeZ, skillZ, parseWorkflow, validateWorkflow, workf
 export { isWhenExpression, whenLabel, parseExpression, evaluateExpression, checkExpression, ExpressionSyntaxError, } from "./when.js";
 // Studio adapter
 export { workflowToFlow, flowToWorkflow, applyExecutionEvent, exportAsTypescript, getSkillCatalog } from "./studio.js";
+// Visual tokens (#479): palette, color roles, glyphs, diagram classDefs. No
+// imports, no chalk: Studio and the docs site share them with the CLI.
+export { SWENY_TAGLINE, PALETTE, ROLE_COLORS, SURFACE_COLORS, GLYPHS, SPINNER_FRAMES, SPINNER_INTERVAL_MS, TICKET_BOX, MERMAID_CLASS_DEFS, MERMAID_EDGE_STYLES, } from "./theme.js";

package/dist/budget.js

@@ -38,7 +38,11 @@ export function hasLimits(l) {
 export function spendOf(u) {
     if (!u)
         return {};
-    const tokens = isNum(u.inputTokens) || isNum(u.outputTokens) ? (u.inputTokens ?? 0) + (u.outputTokens ?? 0) : undefined;
+    // Count only finite fields: a NaN beside a real count must not turn the sum into NaN,
+    // which no limit compares as crossed (the run would pass its budget without stopping).
+    const inTokens = isNum(u.inputTokens) ? u.inputTokens : undefined;
+    const outTokens = isNum(u.outputTokens) ? u.outputTokens : undefined;
+    const tokens = inTokens !== undefined || outTokens !== undefined ? (inTokens ?? 0) + (outTokens ?? 0) : undefined;
     return { ...(tokens !== undefined ? { tokens } : {}), ...(isNum(u.costUsd) ? { costUsd: u.costUsd } : {}) };
 }
 function over(spent, limit, strictlyOver) {

package/dist/cli/check.js

@@ -63,7 +63,7 @@ export async function checkProviderConnectivity(config, opts = {}) {
             results.push(await checkSentry(creds));
         }
         else if (provider === "file") {
-            results.push({ name: "Observability (file)", status: "skip", detail: "File provider — no network check needed" });
+            results.push({ name: "Observability (file)", status: "skip", detail: "File provider - no network check needed" });
         }
         else {
             results.push({
@@ -89,7 +89,7 @@ export async function checkProviderConnectivity(config, opts = {}) {
         results.push({
             name: "Issue tracker (file)",
             status: "skip",
-            detail: "File provider — no network check needed",
+            detail: "File provider - no network check needed",
         });
     }
     else {
@@ -118,7 +118,7 @@ export async function checkProviderConnectivity(config, opts = {}) {
         results.push({
             name: "Source control (file)",
             status: "skip",
-            detail: "File provider — no network check needed",
+            detail: "File provider - no network check needed",
         });
     }
     else {
@@ -145,7 +145,7 @@ async function checkAnthropic(apiKey) {
             return {
                 name,
                 status: "fail",
-                detail: "401 Unauthorized — check ANTHROPIC_API_KEY at https://console.anthropic.com",
+                detail: "401 Unauthorized - check ANTHROPIC_API_KEY at https://console.anthropic.com",
             };
         }
         return { name, status: "fail", detail: `Unexpected HTTP ${res.status}` };
@@ -220,7 +220,7 @@ export async function checkDatadog(creds) {
         return {
             name,
             status: "fail",
-            detail: `Invalid DD_SITE "${site}" — expected a hostname like datadoghq.com or datadoghq.eu`,
+            detail: `Invalid DD_SITE "${site}" - expected a hostname like datadoghq.com or datadoghq.eu`,
         };
     }
     try {
@@ -235,7 +235,7 @@ export async function checkDatadog(creds) {
             return {
                 name,
                 status: "fail",
-                detail: "403 Forbidden — check DD_API_KEY and DD_APP_KEY at https://app.datadoghq.com/organization-settings/api-keys",
+                detail: "403 Forbidden - check DD_API_KEY and DD_APP_KEY at https://app.datadoghq.com/organization-settings/api-keys",
             };
         }
         return { name, status: "fail", detail: `Unexpected HTTP ${res.status}` };
@@ -262,7 +262,7 @@ async function checkSentry(creds) {
             return {
                 name,
                 status: "fail",
-                detail: "401 Unauthorized — check SENTRY_AUTH_TOKEN at https://sentry.io/settings/auth-tokens/",
+                detail: "401 Unauthorized - check SENTRY_AUTH_TOKEN at https://sentry.io/settings/auth-tokens/",
             };
         }
         return { name, status: "fail", detail: `Unexpected HTTP ${res.status}` };
@@ -286,7 +286,7 @@ async function checkLinear(apiKey) {
         if (res.status === 200) {
             const body = (await res.json());
             if (body.errors?.length) {
-                return { name, status: "fail", detail: "GraphQL error — check LINEAR_API_KEY" };
+                return { name, status: "fail", detail: "GraphQL error - check LINEAR_API_KEY" };
             }
             const displayName = body.data?.viewer?.name ?? "authenticated";
             return { name, status: "ok", detail: `Authenticated as ${displayName}` };
@@ -295,7 +295,7 @@ async function checkLinear(apiKey) {
             return {
                 name,
                 status: "fail",
-                detail: "401 Unauthorized — check LINEAR_API_KEY at https://linear.app/settings/api",
+                detail: "401 Unauthorized - check LINEAR_API_KEY at https://linear.app/settings/api",
             };
         }
         return { name, status: "fail", detail: `Unexpected HTTP ${res.status}` };
@@ -321,7 +321,7 @@ async function checkGitHub(token, name) {
             return {
                 name,
                 status: "fail",
-                detail: "401 Bad credentials — check GITHUB_TOKEN at https://github.com/settings/tokens",
+                detail: "401 Bad credentials - check GITHUB_TOKEN at https://github.com/settings/tokens",
             };
         }
         return { name, status: "fail", detail: `Unexpected HTTP ${res.status}` };
@@ -335,11 +335,11 @@ function networkErrorMessage(err) {
     // explicit abort surfaces as "AbortError". Either means we gave up waiting.
     const errName = err instanceof Error ? err.name : "";
     if (errName === "TimeoutError" || errName === "AbortError") {
-        return `Connection timed out after ${CHECK_TIMEOUT_MS}ms — host unreachable or too slow`;
+        return `Connection timed out after ${CHECK_TIMEOUT_MS}ms - host unreachable or too slow`;
     }
     const msg = err instanceof Error ? err.message : String(err);
     if (/ENOTFOUND|ETIMEDOUT|ECONNREFUSED/i.test(msg)) {
-        return `Network error — check your internet connection (${msg})`;
+        return `Network error - check your internet connection (${msg})`;
     }
     return msg;
 }

package/dist/cli/comment-output.d.ts

@@ -1,6 +1,6 @@
 /**
  * PR billboard: the markdown a CI runner posts as one sticky comment on a
- * pull request. Pure and runner-agnostic; the CLI writes it with
+ * pull request. Leads with the receipt ticket, then the run's DAG. Pure and runner-agnostic; the CLI writes it with
  * `--comment-file`, and any runner (the GitHub Action, GitLab, a script) posts it.
  *
  * METADATA ONLY. Node names, statuses, counts, and durations. Never prompts,
@@ -13,6 +13,8 @@ export interface RunCommentOptions {
     trace?: ExecutionTrace;
     /** Per-node wall-clock duration in ms, keyed by node id. Missing entries render as "-". */
     durationsMs?: Record<string, number>;
+    /** Run id; the ticket shows its short hash. */
+    runId?: string;
 }
 /** Hidden marker the poster searches for to update the comment in place. */
 export declare function runCommentMarker(workflowId: string): string;
@@ -22,7 +24,7 @@ export declare function formatRunComment(workflow: Workflow, results: Map<string
  * and no error text (thrown messages can embed model prose). Replaces any stale
  * success comment for the same workflow.
  */
-export declare function formatCrashComment(workflow: Workflow, summary: RunSummary): string;
+export declare function formatCrashComment(workflow: Workflow, summary: RunSummary, runId?: string): string;
 /** Write the comment markdown to `file`. Never throws; returns true only when written. */
 export declare function writeRunComment(file: string, workflow: Workflow, results: Map<string, NodeResult>, summary: RunSummary, opts?: RunCommentOptions & {
     crashed?: boolean;

package/dist/cli/comment-output.js

@@ -1,6 +1,6 @@
 /**
  * PR billboard: the markdown a CI runner posts as one sticky comment on a
- * pull request. Pure and runner-agnostic; the CLI writes it with
+ * pull request. Leads with the receipt ticket, then the run's DAG. Pure and runner-agnostic; the CLI writes it with
  * `--comment-file`, and any runner (the GitHub Action, GitLab, a script) posts it.
  *
  * METADATA ONLY. Node names, statuses, counts, and durations. Never prompts,
@@ -9,8 +9,14 @@
 import fs from "node:fs";
 import path from "node:path";
 import { toMermaidBlock } from "../mermaid.js";
-import { STEP_SUMMARY_CLASS_DEFS, formatReceipt, formatReceiptDuration, nodeStates, } from "./run-output.js";
+import { formatReceiptDuration, nodeStates } from "./run-output.js";
+import { formatTicketText } from "./ticket.js";
+import { glyphs } from "./terminal.js";
 export const RUN_COMMENT_FOOTER = "Run with [SWEny](https://github.com/swenyai/sweny): `npx @sweny-ai/core new`";
+/** The receipt ticket as a fenced block, the same card a TTY run ends on. */
+function ticketBlock(workflow, summary, runId, crashed) {
+    return ["```text", formatTicketText({ summary, workflow: workflow.id, runId, crashed }), "```"].join("\n");
+}
 /** Hidden marker the poster searches for to update the comment in place. */
 export function runCommentMarker(workflowId) {
     const safe = workflowId.replace(/[^A-Za-z0-9._-]+/g, "_").replace(/-{2,}/g, "-") || "workflow";
@@ -33,9 +39,9 @@ export function formatRunComment(workflow, results, summary, opts = {}) {
         runCommentMarker(workflow.id),
         `## ${summary.ok ? "✅" : "❌"} ${cell(workflow.name)}`,
         "",
-        `\`${formatReceipt(summary)}\``,
+        ticketBlock(workflow, summary, opts.runId),
         "",
-        toMermaidBlock(workflow, { state, trace: opts.trace, classDefs: STEP_SUMMARY_CLASS_DEFS }),
+        toMermaidBlock(workflow, { state, trace: opts.trace }),
         "",
         "<details>",
         "<summary>Nodes</summary>",
@@ -55,12 +61,12 @@ export function formatRunComment(workflow, results, summary, opts = {}) {
  * and no error text (thrown messages can embed model prose). Replaces any stale
  * success comment for the same workflow.
  */
-export function formatCrashComment(workflow, summary) {
+export function formatCrashComment(workflow, summary, runId) {
     return [
         runCommentMarker(workflow.id),
         `## ❌ ${cell(workflow.name)}`,
         "",
-        `\`${formatReceipt(summary)} · crashed\``,
+        ticketBlock(workflow, summary, runId, true),
         "",
         "The run stopped before finishing. See the job log for details.",
         "",
@@ -72,11 +78,13 @@ export function formatCrashComment(workflow, summary) {
 export function writeRunComment(file, workflow, results, summary, opts = {}) {
     try {
         fs.mkdirSync(path.dirname(file), { recursive: true });
-        fs.writeFileSync(file, opts.crashed ? formatCrashComment(workflow, summary) : formatRunComment(workflow, results, summary, opts));
+        fs.writeFileSync(file, opts.crashed
+            ? formatCrashComment(workflow, summary, opts.runId)
+            : formatRunComment(workflow, results, summary, opts));
         return true;
     }
     catch (err) {
-        process.stderr.write(`  ⚠ could not write comment file: ${err instanceof Error ? err.message : err}\n`);
+        process.stderr.write(`  ${glyphs().warning} could not write comment file: ${err instanceof Error ? err.message : err}\n`);
         return false;
     }
 }

package/dist/cli/config.js

@@ -149,7 +149,7 @@ export function parseCliInputs(options, fileConfig = {}) {
             const fromEnv = env.SWENY_CLOUD_TOKEN || "";
             const fromFile = f("cloud-token") || "";
             if (!fromEnv && fromFile) {
-                console.warn("\x1b[33m⚠ cloud-token is set in .sweny.yml — consider using SWENY_CLOUD_TOKEN env var instead to avoid accidental commits.\x1b[0m");
+                console.warn("\x1b[33m⚠ cloud-token is set in .sweny.yml - consider using SWENY_CLOUD_TOKEN env var instead to avoid accidental commits.\x1b[0m");
             }
             return fromEnv || fromFile;
         })(),
@@ -229,7 +229,7 @@ export function validateInputs(config) {
     switch (config.codingAgentProvider) {
         case "claude":
             if (!config.anthropicApiKey && !config.claudeOauthToken) {
-                errors.push("Missing: ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN — get a key at https://console.anthropic.com");
+                errors.push("Missing: ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN - get a key at https://console.anthropic.com");
             }
             break;
         case "codex":
@@ -262,13 +262,13 @@ export function validateInputs(config) {
         switch (provider) {
             case "datadog":
                 if (!creds.apiKey)
-                    errors.push("Missing: DD_API_KEY — find API keys at https://app.datadoghq.com/organization-settings/api-keys");
+                    errors.push("Missing: DD_API_KEY - find API keys at https://app.datadoghq.com/organization-settings/api-keys");
                 if (!creds.appKey)
-                    errors.push("Missing: DD_APP_KEY — find application keys at https://app.datadoghq.com/organization-settings/application-keys");
+                    errors.push("Missing: DD_APP_KEY - find application keys at https://app.datadoghq.com/organization-settings/application-keys");
                 break;
             case "sentry":
                 if (!creds.authToken)
-                    errors.push("Missing: SENTRY_AUTH_TOKEN — create a token at https://sentry.io/settings/auth-tokens/");
+                    errors.push("Missing: SENTRY_AUTH_TOKEN - create a token at https://sentry.io/settings/auth-tokens/");
                 if (!creds.organization)
                     errors.push("Missing: --sentry-org is required for sentry provider");
                 if (!creds.project)
@@ -342,33 +342,33 @@ export function validateInputs(config) {
                 break;
             case "vercel":
                 if (!creds.token)
-                    errors.push("Missing: VERCEL_TOKEN — create a token at https://vercel.com/account/tokens");
+                    errors.push("Missing: VERCEL_TOKEN - create a token at https://vercel.com/account/tokens");
                 if (!creds.projectId)
-                    errors.push("Missing: VERCEL_PROJECT_ID — find it in your Vercel project settings");
+                    errors.push("Missing: VERCEL_PROJECT_ID - find it in your Vercel project settings");
                 break;
             case "supabase":
                 if (!creds.managementApiKey)
-                    errors.push("Missing: SUPABASE_MANAGEMENT_KEY — create a token at https://supabase.com/dashboard/account/tokens");
+                    errors.push("Missing: SUPABASE_MANAGEMENT_KEY - create a token at https://supabase.com/dashboard/account/tokens");
                 if (!creds.projectRef)
-                    errors.push("Missing: SUPABASE_PROJECT_REF — find it in your Supabase project settings > General");
+                    errors.push("Missing: SUPABASE_PROJECT_REF - find it in your Supabase project settings > General");
                 break;
             case "netlify":
                 if (!creds.token)
-                    errors.push("Missing: NETLIFY_TOKEN — create a token at https://app.netlify.com/user/applications#personal-access-tokens");
+                    errors.push("Missing: NETLIFY_TOKEN - create a token at https://app.netlify.com/user/applications#personal-access-tokens");
                 if (!creds.siteId)
-                    errors.push("Missing: NETLIFY_SITE_ID — find it in Site Settings > General > Site details");
+                    errors.push("Missing: NETLIFY_SITE_ID - find it in Site Settings > General > Site details");
                 break;
             case "fly":
                 if (!creds.token)
-                    errors.push("Missing: FLY_TOKEN — create a token at https://fly.io/user/personal_access_tokens");
+                    errors.push("Missing: FLY_TOKEN - create a token at https://fly.io/user/personal_access_tokens");
                 if (!creds.appName)
-                    errors.push("Missing: FLY_APP_NAME — the name of your Fly.io application");
+                    errors.push("Missing: FLY_APP_NAME - the name of your Fly.io application");
                 break;
             case "render":
                 if (!creds.apiKey)
-                    errors.push("Missing: RENDER_API_KEY — create an API key at https://dashboard.render.com/u/settings");
+                    errors.push("Missing: RENDER_API_KEY - create an API key at https://dashboard.render.com/u/settings");
                 if (!creds.serviceId)
-                    errors.push("Missing: RENDER_SERVICE_ID — find it in your service's Settings page (srv-...)");
+                    errors.push("Missing: RENDER_SERVICE_ID - find it in your service's Settings page (srv-...)");
                 break;
             default:
                 errors.push(`Unknown --observability-provider "${provider}". Valid values: none, datadog, sentry, cloudwatch, splunk, elastic, newrelic, loki, prometheus, pagerduty, honeycomb, heroku, opsgenie, axiom, betterstack, vercel, supabase, netlify, fly, render, file`);
@@ -378,17 +378,17 @@ export function validateInputs(config) {
     switch (config.issueTrackerProvider) {
         case "linear":
             if (!config.linearApiKey)
-                errors.push("Missing: LINEAR_API_KEY — find API keys at https://linear.app/settings/api");
+                errors.push("Missing: LINEAR_API_KEY - find API keys at https://linear.app/settings/api");
             if (!config.linearTeamId)
-                errors.push("Missing: LINEAR_TEAM_ID — find it in Linear > Settings > Workspace > Teams > [your team] > copy the ID from the URL");
+                errors.push("Missing: LINEAR_TEAM_ID - find it in Linear > Settings > Workspace > Teams > [your team] > copy the ID from the URL");
             break;
         case "jira":
             if (!config.jiraBaseUrl)
-                errors.push("Missing: JIRA_BASE_URL — set to your Atlassian domain, e.g. https://your-org.atlassian.net");
+                errors.push("Missing: JIRA_BASE_URL - set to your Atlassian domain, e.g. https://your-org.atlassian.net");
             if (!config.jiraEmail)
-                errors.push("Missing: JIRA_EMAIL — your Atlassian account email address");
+                errors.push("Missing: JIRA_EMAIL - your Atlassian account email address");
             if (!config.jiraApiToken)
-                errors.push("Missing: JIRA_API_TOKEN — create a token at https://id.atlassian.com/manage-profile/security/api-tokens");
+                errors.push("Missing: JIRA_API_TOKEN - create a token at https://id.atlassian.com/manage-profile/security/api-tokens");
             break;
         case "github-issues":
         case "file":
@@ -401,13 +401,13 @@ export function validateInputs(config) {
     switch (config.sourceControlProvider) {
         case "github":
             if (!config.githubToken && !config.botToken)
-                errors.push("Missing: GITHUB_TOKEN — create a Personal Access Token at https://github.com/settings/tokens");
+                errors.push("Missing: GITHUB_TOKEN - create a Personal Access Token at https://github.com/settings/tokens");
             break;
         case "gitlab":
             if (!config.gitlabToken)
-                errors.push("Missing: GITLAB_TOKEN — create a Personal Access Token at https://gitlab.com/-/user_settings/personal_access_tokens (api + read_repository + write_repository scopes)");
+                errors.push("Missing: GITLAB_TOKEN - create a Personal Access Token at https://gitlab.com/-/user_settings/personal_access_tokens (api + read_repository + write_repository scopes)");
             if (!config.gitlabProjectId)
-                errors.push("Missing: GITLAB_PROJECT_ID — find it in GitLab > [your project] > Settings > General (numeric ID at the top)");
+                errors.push("Missing: GITLAB_PROJECT_ID - find it in GitLab > [your project] > Settings > General (numeric ID at the top)");
             break;
         case "file":
             // No external credentials needed
@@ -670,7 +670,7 @@ export function registerImplementCommand(program) {
         .option("--coding-agent-provider <provider>", "Coding agent provider (alias for --agent)")
         .option("--issue-tracker-provider <provider>", "Issue tracker (linear|jira|github-issues|file)")
         .option("--source-control-provider <provider>", "Source control (github|gitlab|file)")
-        .option("--dry-run", "Skip creating PR — report only", false)
+        .option("--dry-run", "Skip creating PR - report only", false)
         .option("--stage", "Run normally, but preview the PR and issue comment instead of writing them", false)
         .option("--max-implement-turns <n>", "Max coding agent turns (default: 40)")
         .option("--base-branch <branch>", "Base branch for PRs (default: main)")

package/dist/cli/e2e.js

@@ -87,17 +87,17 @@ This returns element references like @e1, @e2, @e3.
 Use those refs with: agent-browser click @e5, agent-browser fill @e7 "text", etc.
 
 Available commands:
-- agent-browser open <url> — navigate to URL
-- agent-browser snapshot — get accessibility tree with @refs
-- agent-browser click <ref> — click an element
-- agent-browser fill <ref> <text> — clear input and fill with text
-- agent-browser press <key> — press keyboard key (Enter, Tab, Escape)
-- agent-browser get url — get current page URL
-- agent-browser get text <ref> — get element text content
-- agent-browser screenshot <path> — save screenshot to file
-- agent-browser scroll <direction> <pixels> — scroll page
-- agent-browser scrollintoview <ref> — scroll element into view
-- agent-browser select <ref> <value> — select dropdown option`,
+- agent-browser open <url> - navigate to URL
+- agent-browser snapshot - get accessibility tree with @refs
+- agent-browser click <ref> - click an element
+- agent-browser fill <ref> <text> - clear input and fill with text
+- agent-browser press <key> - press keyboard key (Enter, Tab, Escape)
+- agent-browser get url - get current page URL
+- agent-browser get text <ref> - get element text content
+- agent-browser screenshot <path> - save screenshot to file
+- agent-browser scroll <direction> <pixels> - scroll page
+- agent-browser scrollintoview <ref> - scroll element into view
+- agent-browser select <ref> <value> - select dropdown option`,
         skills: [],
         output: {
             type: "object",
@@ -142,7 +142,7 @@ Use curl to call the Supabase Admin API:
 2. Filter for emails starting with "e2e-" and ending with "@yourapp.test"
 3. Delete each matching user: DELETE {SUPABASE_URL}/auth/v1/admin/users/{user_id}
 
-If no test users are found, that's fine — skip gracefully.
+If no test users are found, that's fine - skip gracefully.
 If the service role key is not available, skip cleanup gracefully.`;
             break;
         case "firebase":
@@ -501,7 +501,7 @@ const CLEANUP_ENV_VARS = {
  */
 export function buildE2eEnvTemplate(selections) {
     const lines = [];
-    lines.push("# E2E Testing — SWEny");
+    lines.push("# E2E Testing - SWEny");
     lines.push("# Fill in values, then run: sweny workflow run");
     lines.push("");
     lines.push(`E2E_BASE_URL=${selections.baseUrl}`);
@@ -640,7 +640,7 @@ export async function runE2eInit(options = {}) {
             if (p.isCancel(overwrite))
                 cancel();
             if (!overwrite) {
-                p.cancel("Setup cancelled — existing files preserved.");
+                p.cancel("Setup cancelled - existing files preserved.");
                 process.exit(0);
             }
         }
@@ -741,7 +741,7 @@ export async function runE2eInit(options = {}) {
             p.log.success(`Appended E2E vars to ${chalk.cyan(".env")}`);
         }
         else {
-            p.log.warn(".env already has E2E vars — skipped");
+            p.log.warn(".env already has E2E vars - skipped");
         }
     }
     else {
@@ -930,10 +930,10 @@ export async function runE2eRun(options) {
                     const elapsed = ((Date.now() - enterTime) / 1000).toFixed(1);
                     const status = event.result.data?.status || event.result.status;
                     if (isTTY) {
-                        process.stderr.write(`\x1B[1A\x1B[2K  ${icon} ${event.node} — ${status} (${elapsed}s)\n`);
+                        process.stderr.write(`\x1B[1A\x1B[2K  ${icon} ${event.node} - ${status} (${elapsed}s)\n`);
                     }
                     else {
-                        process.stderr.write(`  ${icon} ${event.node} — ${status} (${elapsed}s)\n`);
+                        process.stderr.write(`  ${icon} ${event.node} - ${status} (${elapsed}s)\n`);
                     }
                     break;
                 }