@sweny-ai/core 0.1.171 → 0.1.172

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/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;
                 }

package/dist/cli/marketplace.js

@@ -22,7 +22,7 @@ export async function fetchMarketplaceWorkflow(id) {
         res = await fetch(url);
     }
     catch {
-        const err = new Error(`Could not reach github.com — check your connection`);
+        const err = new Error(`Could not reach github.com - check your connection`);
         err.kind = "network";
         throw err;
     }
@@ -147,8 +147,8 @@ export async function adaptWorkflowInteractive(workflow, options) {
         const action = await p.select({
             message: "Looks good?",
             options: [
-                { value: "accept", label: "Yes — use this workflow" },
-                { value: "refine", label: "Refine — describe what to change" },
+                { value: "accept", label: "Yes - use this workflow" },
+                { value: "refine", label: "Refine - describe what to change" },
                 { value: "cancel", label: "Cancel" },
             ],
         });

package/dist/cli/new.js

@@ -328,7 +328,7 @@ export function inferObservability(skills) {
  */
 export function buildSwenyYml(sourceControl, observability, issueTracker) {
     const lines = [];
-    lines.push("# .sweny.yml — SWEny project configuration");
+    lines.push("# .sweny.yml - SWEny project configuration");
     lines.push("# Secrets (API keys, tokens) go in .env (gitignored).");
     lines.push("# Docs: https://docs.sweny.ai/cli");
     lines.push("");
@@ -345,7 +345,7 @@ export function buildSwenyYml(sourceControl, observability, issueTracker) {
  */
 export function buildEnvTemplate(credentials) {
     const lines = [];
-    lines.push("# .env — SWEny credentials (DO NOT COMMIT)");
+    lines.push("# .env - SWEny credentials (DO NOT COMMIT)");
     lines.push("# Fill in each value, then run: sweny check");
     lines.push("");
     for (const cred of credentials) {
@@ -746,7 +746,7 @@ export async function runNew(options) {
         summaryLines.push("");
     }
     if (hasExistingConfig) {
-        summaryLines.push(chalk.dim("(.sweny.yml already exists — keeping your existing config)"));
+        summaryLines.push(chalk.dim("(.sweny.yml already exists - keeping your existing config)"));
         summaryLines.push("");
     }
     summaryLines.push(chalk.bold(hasExistingConfig ? "Workflow uses:" : "Inferred from workflow:"));
@@ -773,7 +773,7 @@ export async function runNew(options) {
         p.log.success("Created .sweny.yml");
     }
     else {
-        p.log.info(".sweny.yml already exists — keeping existing config");
+        p.log.info(".sweny.yml already exists - keeping existing config");
     }
     // 2. Append missing .env keys
     const envExistedBefore = fs.existsSync(path.join(cwd, ".env"));
@@ -786,7 +786,7 @@ export async function runNew(options) {
         p.log.success(`Appended ${addedCount} new key(s) to .env`);
     }
     else {
-        p.log.info(".env already contains all required keys — skipped");
+        p.log.info(".env already contains all required keys - skipped");
     }
     // The pack's Actions trigger (#474): never overwritten, skipped with --no-ci.
     const installTrigger = () => {
@@ -815,7 +815,7 @@ export async function runNew(options) {
             if (p.isCancel(overwrite))
                 cancel();
             if (!overwrite) {
-                p.log.info("Workflow file preserved — no changes");
+                p.log.info("Workflow file preserved - no changes");
                 p.outro("Done.");
                 return;
             }
@@ -903,8 +903,8 @@ async function runCustomWorkflowBuilder(skills) {
         const action = await p.select({
             message: "Looks good?",
             options: [
-                { value: "accept", label: "Yes — use this workflow" },
-                { value: "refine", label: "Refine — describe what to change" },
+                { value: "accept", label: "Yes - use this workflow" },
+                { value: "refine", label: "Refine - describe what to change" },
                 { value: "cancel", label: "Cancel" },
             ],
         });

package/dist/cli/publish.js

@@ -216,7 +216,7 @@ async function publishWorkflow() {
         p.log.error(`Validation failed:\n${validation.errors.map((e) => `  - ${e}`).join("\n")}`);
         return null;
     }
-    p.log.success(`Validated: ${chalk.cyan(validation.name)} — ${validation.nodeCount} nodes, ${validation.edgeCount} edges`);
+    p.log.success(`Validated: ${chalk.cyan(validation.name)} - ${validation.nodeCount} nodes, ${validation.edgeCount} edges`);
     if (validation.warnings.length > 0) {
         for (const warn of validation.warnings) {
             p.log.warn(warn);
@@ -312,7 +312,7 @@ async function selectOutputMode(type, id, sourcePath, meta) {
     const hasGh = ghAvailable();
     const options = [
         ...(hasGh
-            ? [{ value: "pr", label: "Open GitHub PR", hint: "recommended — forks marketplace repo and opens a PR" }]
+            ? [{ value: "pr", label: "Open GitHub PR", hint: "recommended - forks marketplace repo and opens a PR" }]
             : []),
         { value: "save", label: "Save submission file", hint: "saves to ./sweny-publish/" },
     ];

package/dist/cli/record.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `sweny try --record <file.svg>`: the demo as an animated terminal SVG.
+ *
+ * Runs the real `sweny try` replay (instant, no TTY) with color forced on,
+ * captures the ANSI text, and lays it out as a slate terminal window whose
+ * lines appear on a CSS keyframe timeline: the command, a spinner per node
+ * until it settles, the answer, the receipt ticket with its stamp
+ * landing last. Then it loops.
+ *
+ * Self-contained by construction: inline CSS only, a monospace font stack, no
+ * external fonts, images, links or scripts. Deterministic: no clock, no ids,
+ * no randomness; the same fixture and theme always yield the same bytes, so
+ * CI can regenerate the file and fail when the committed copy is stale.
+ * `prefers-reduced-motion` shows the finished frame with no animation.
+ */
+import { type TryFixture } from "./try.js";
+/** Terminal width the demo is rendered at (the ticket and DAG are designed for 80). */
+export declare const RECORD_COLUMNS = 80;
+/** Lines longer than this wrap in the window, like a terminal would. */
+export declare const RECORD_WRAP = 96;
+/** Width of one terminal column in the window, in px. Every segment is placed at column * CELL_W. */
+export declare const CELL_W = 7.85;
+/** Left edge of column 0. */
+export declare const TEXT_X = 24;
+export interface Style {
+    fg?: string;
+    bold?: boolean;
+    dim?: boolean;
+    underline?: boolean;
+}
+export interface Cell {
+    ch: string;
+    style: Style;
+}
+/** One line of ANSI text as styled cells. Cursor and erase sequences are dropped. */
+export declare function parseAnsiLine(line: string): Cell[];
+/** Soft-wrap a row of cells at `max` columns, on spaces, continuation indented two past the first. */
+export declare function wrapCells(cells: Cell[], max: number): Cell[][];
+export interface Row {
+    cells: Cell[];
+    /** Vertical slot. A spinner shares the slot of the line that replaces it. */
+    slot: number;
+    /** Seconds at which the row appears. */
+    from: number;
+    /** Seconds at which it disappears again (spinners). Absent: stays until the loop restarts. */
+    to?: number;
+    spinner?: boolean;
+}
+/** Lay captured output lines on the timeline. Pure. */
+export declare function buildTimeline(lines: string[], fixture: TryFixture): {
+    rows: Row[];
+    slots: number;
+    total: number;
+};
+/** Render the timeline as a self-contained animated SVG. Pure and deterministic. */
+export declare function renderRecordingSvg(lines: string[], fixture: TryFixture): string;
+/**
+ * The PR-comment preview (heading plus DAG) sits between the answer and the
+ * ticket. The recording drops it to stay a README-sized hero: tagline, nodes,
+ * answer, ticket.
+ */
+export declare function dropCommentPreview(lines: string[]): string[];
+/** Run the demo and return the SVG text. */
+export declare function recordTrySvg(fixture?: TryFixture): Promise<string>;
+/** Record to `file`, creating its directory. Returns the byte size written. */
+export declare function recordTrySvgToFile(file: string, fixture?: TryFixture): Promise<number>;

package/dist/cli/record.js

@@ -0,0 +1,344 @@
+/**
+ * `sweny try --record <file.svg>`: the demo as an animated terminal SVG.
+ *
+ * Runs the real `sweny try` replay (instant, no TTY) with color forced on,
+ * captures the ANSI text, and lays it out as a slate terminal window whose
+ * lines appear on a CSS keyframe timeline: the command, a spinner per node
+ * until it settles, the answer, the receipt ticket with its stamp
+ * landing last. Then it loops.
+ *
+ * Self-contained by construction: inline CSS only, a monospace font stack, no
+ * external fonts, images, links or scripts. Deterministic: no clock, no ids,
+ * no randomness; the same fixture and theme always yield the same bytes, so
+ * CI can regenerate the file and fail when the committed copy is stale.
+ * `prefers-reduced-motion` shows the finished frame with no animation.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { GLYPHS, PALETTE, ROLE_COLORS, SPINNER_FRAMES, SURFACE_COLORS } from "../theme.js";
+import { loadTryFixture, runTry } from "./try.js";
+/** Terminal width the demo is rendered at (the ticket and DAG are designed for 80). */
+export const RECORD_COLUMNS = 80;
+/** Lines longer than this wrap in the window, like a terminal would. */
+export const RECORD_WRAP = 96;
+const FONT_SIZE = 13;
+/** Width of one terminal column in the window, in px. Every segment is placed at column * CELL_W. */
+export const CELL_W = 7.85;
+/** Left edge of column 0. */
+export const TEXT_X = 24;
+const NBSP = "\u00A0";
+const LINE_H = 19;
+const PAD_X = TEXT_X;
+const BAR_H = 38;
+const PAD_TOP = 18;
+const PAD_BOTTOM = 22;
+const WINDOW_W = Math.ceil(RECORD_WRAP * CELL_W + PAD_X * 2);
+const FONT_STACK = "ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace";
+const SECONDS_PER_LINE = 0.06;
+const SECONDS_PER_BLANK = 0.25;
+const SECONDS_STAMP_DELAY = 0.5;
+const SECONDS_HOLD = 5;
+const BASIC_COLORS = {
+    30: PALETTE.slate900,
+    31: ROLE_COLORS.error,
+    32: ROLE_COLORS.success,
+    33: ROLE_COLORS.warning,
+    34: ROLE_COLORS.brand,
+    35: PALETTE.blue300,
+    36: ROLE_COLORS.info,
+    37: SURFACE_COLORS.dark.text,
+    90: ROLE_COLORS.muted,
+    91: ROLE_COLORS.error,
+    92: ROLE_COLORS.success,
+    93: ROLE_COLORS.warning,
+    94: ROLE_COLORS.info,
+    95: PALETTE.blue300,
+    96: ROLE_COLORS.info,
+    97: PALETTE.white,
+};
+const hex = (n) => n.toString(16).padStart(2, "0");
+/** Apply one SGR parameter list to a style. */
+function applySgr(style, params) {
+    const next = { ...style };
+    for (let i = 0; i < params.length; i++) {
+        const p = params[i];
+        if (p === 0)
+            return {};
+        else if (p === 1)
+            next.bold = true;
+        else if (p === 2)
+            next.dim = true;
+        else if (p === 22) {
+            delete next.bold;
+            delete next.dim;
+        }
+        else if (p === 4)
+            next.underline = true;
+        else if (p === 24)
+            delete next.underline;
+        else if (p === 39)
+            delete next.fg;
+        else if (p === 38 && params[i + 1] === 2) {
+            next.fg = `#${hex(params[i + 2] ?? 0)}${hex(params[i + 3] ?? 0)}${hex(params[i + 4] ?? 0)}`;
+            i += 4;
+        }
+        else if (p === 38 && params[i + 1] === 5) {
+            next.fg = SURFACE_COLORS.dark.text;
+            i += 2;
+        }
+        else if (BASIC_COLORS[p])
+            next.fg = BASIC_COLORS[p];
+    }
+    return next;
+}
+/** One line of ANSI text as styled cells. Cursor and erase sequences are dropped. */
+export function parseAnsiLine(line) {
+    const cells = [];
+    let style = {};
+    const re = /\x1B\[([0-9;]*)([A-Za-z])/g;
+    let last = 0;
+    const push = (text) => {
+        for (const ch of text.replace(/\r/g, ""))
+            cells.push({ ch, style });
+    };
+    for (let m = re.exec(line); m; m = re.exec(line)) {
+        push(line.slice(last, m.index));
+        if (m[2] === "m")
+            style = applySgr(style, m[1] === "" ? [0] : m[1].split(";").map(Number));
+        last = m.index + m[0].length;
+    }
+    push(line.slice(last));
+    return cells;
+}
+const sameStyle = (a, b) => a.fg === b.fg && !!a.bold === !!b.bold && !!a.dim === !!b.dim && !!a.underline === !!b.underline;
+/** Soft-wrap a row of cells at `max` columns, on spaces, continuation indented two past the first. */
+export function wrapCells(cells, max) {
+    const rows = [];
+    const indent = cells.findIndex((c) => c.ch !== " ");
+    const pad = " ".repeat(Math.max(0, indent) + 2);
+    let rest = cells;
+    while (rest.length > max) {
+        let cut = -1;
+        for (let i = max; i > pad.length; i--) {
+            if (rest[i].ch === " ") {
+                cut = i;
+                break;
+            }
+        }
+        if (cut < 0)
+            cut = max;
+        rows.push(rest.slice(0, cut));
+        let tail = rest.slice(cut);
+        while (tail.length > 0 && tail[0].ch === " ")
+            tail = tail.slice(1);
+        rest = [...[...pad].map((ch) => ({ ch, style: {} })), ...tail];
+    }
+    rows.push(rest);
+    return rows;
+}
+const plainText = (cells) => cells.map((c) => c.ch).join("");
+function textCells(text, style = {}) {
+    return [...text].map((ch) => ({ ch, style }));
+}
+/** Lay captured output lines on the timeline. Pure. */
+export function buildTimeline(lines, fixture) {
+    const rows = [];
+    const nodeIds = Object.keys(fixture.nodes);
+    const settledPrefix = (id) => `  ${GLYPHS.unicode.success} ${id}`;
+    const spinnerGlyph = SPINNER_FRAMES.unicode[3];
+    let t = 0.5;
+    let slot = 0;
+    // The command being typed.
+    rows.push({
+        cells: [...textCells("$ ", { fg: ROLE_COLORS.muted }), ...textCells("sweny try", { bold: true })],
+        slot: slot++,
+        from: t,
+    });
+    t += 0.9;
+    for (const line of lines) {
+        const cells = parseAnsiLine(line);
+        const text = plainText(cells);
+        const id = nodeIds.find((n) => text.startsWith(settledPrefix(n)));
+        if (id) {
+            const seconds = 0.8 + Math.min(1.6, fixture.nodes[id].duration_ms / 12000);
+            rows.push({
+                cells: [...textCells("  "), ...textCells(spinnerGlyph, { fg: ROLE_COLORS.brand }), ...textCells(` ${id}`)],
+                slot,
+                from: t,
+                to: t + seconds,
+                spinner: true,
+            });
+            t += seconds;
+        }
+        else if (/\[ (ENV|SANDBOXED|UNSANDBOXED)\b/.test(text)) {
+            // The policy stamp lands a beat after the card.
+            t += SECONDS_STAMP_DELAY;
+        }
+        for (const part of wrapCells(cells, RECORD_WRAP)) {
+            rows.push({ cells: part, slot, from: t });
+            slot++;
+        }
+        t += text.trim() === "" ? SECONDS_PER_BLANK : SECONDS_PER_LINE;
+    }
+    return { rows, slots: slot, total: t + SECONDS_HOLD };
+}
+// ── SVG ─────────────────────────────────────────────────────────
+const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+const pct = (seconds, total) => ((seconds / total) * 100).toFixed(2);
+/** Render the timeline as a self-contained animated SVG. Pure and deterministic. */
+export function renderRecordingSvg(lines, fixture) {
+    const { rows, slots, total } = buildTimeline(lines, fixture);
+    const height = BAR_H + PAD_TOP + slots * LINE_H + PAD_BOTTOM;
+    const dark = SURFACE_COLORS.dark;
+    // Color classes by first use, so the CSS is small and the order is stable.
+    const colorClass = new Map();
+    const classFor = (style) => {
+        const names = [];
+        if (style.fg) {
+            let c = colorClass.get(style.fg);
+            if (!c) {
+                c = `c${colorClass.size}`;
+                colorClass.set(style.fg, c);
+            }
+            names.push(c);
+        }
+        if (style.bold)
+            names.push("b");
+        if (style.dim)
+            names.push("d");
+        if (style.underline)
+            names.push("u");
+        return names.join(" ");
+    };
+    // Keyframes by (from, to), numbered by first use.
+    const frames = new Map();
+    const frameFor = (from, to) => {
+        const key = `${pct(from, total)}:${to === undefined ? "" : pct(to, total)}`;
+        let name = frames.get(key);
+        if (!name) {
+            name = `k${frames.size}`;
+            frames.set(key, name);
+        }
+        return name;
+    };
+    const body = [];
+    for (const row of rows) {
+        const y = BAR_H + PAD_TOP + row.slot * LINE_H + FONT_SIZE;
+        const spans = [];
+        let i = 0;
+        while (i < row.cells.length) {
+            let j = i + 1;
+            while (j < row.cells.length && sameStyle(row.cells[i].style, row.cells[j].style))
+                j++;
+            const raw = row.cells
+                .slice(i, j)
+                .map((c) => c.ch)
+                .join("");
+            // Layout must not depend on whitespace handling (rsvg, proxies and some viewers collapse
+            // spaces): each segment sits at an explicit x for its column, edge spaces become offset
+            // or nothing, and inner spaces are non-breaking.
+            const lead = raw.length - raw.trimStart().length;
+            const body_ = raw.trim();
+            if (body_ !== "") {
+                const x = (TEXT_X + (i + lead) * CELL_W).toFixed(2);
+                const text = esc(body_).replace(/ /g, NBSP);
+                const cls = classFor(row.cells[i].style);
+                spans.push(`<tspan x="${x}"${cls ? ` class="${cls}"` : ""}>${text}</tspan>`);
+            }
+            i = j;
+        }
+        const cls = `r ${frameFor(row.from, row.to)}${row.spinner ? " sp" : ""}`;
+        body.push(`<text class="${cls}" x="${TEXT_X}" y="${y}" xml:space="preserve">${spans.join("")}</text>`);
+    }
+    const css = [
+        `text{font-family:${FONT_STACK};font-size:${FONT_SIZE}px;fill:${dark.text};white-space:pre}`,
+        // No-animation default is the FINAL frame: lines visible, spinner frames hidden. Keyframes drive the replay.
+        `.r{opacity:1}`,
+        `.sp{opacity:0}`,
+        `.b{font-weight:700}`,
+        `.d{fill-opacity:.65}`,
+        `.u{text-decoration:underline}`,
+        `.t{fill:${dark.textSecondary};font-size:12px}`,
+    ];
+    for (const [fg, name] of colorClass)
+        css.push(`.${name}{fill:${fg}}`);
+    for (const [key, name] of frames) {
+        const [from, to] = key.split(":");
+        const a = Number(from);
+        const keyframe = to === ""
+            ? `0%,${from}%{opacity:0}${(a + 0.01).toFixed(2)}%,98%{opacity:1}100%{opacity:0}`
+            : `0%,${from}%{opacity:0}${(a + 0.01).toFixed(2)}%,${to}%{opacity:1}${(Number(to) + 0.01).toFixed(2)}%,100%{opacity:0}`;
+        css.push(`@keyframes ${name}{${keyframe}}`);
+        css.push(`.${name}{animation:${name} ${total.toFixed(2)}s linear infinite}`);
+    }
+    css.push(`@media (prefers-reduced-motion:reduce){.r{animation:none!important}.sp{display:none}}`);
+    const label = "Recorded demo of sweny try: two nodes run, then the answer and the receipt ticket.";
+    return [
+        `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${WINDOW_W} ${height}" width="${WINDOW_W}" height="${height}" xml:space="preserve" role="img" aria-label="${esc(label)}">`,
+        `<title>sweny try</title>`,
+        `<style>${css.join("")}</style>`,
+        `<rect x="0.5" y="0.5" width="${WINDOW_W - 1}" height="${height - 1}" rx="10" fill="${dark.background}" stroke="${dark.border}"/>`,
+        `<path d="M0.5 ${BAR_H}V10.5A10 10 0 0 1 10.5 0.5H${WINDOW_W - 10.5}A10 10 0 0 1 ${WINDOW_W - 0.5} 10.5V${BAR_H}Z" fill="${PALETTE.slate900}" stroke="${dark.border}"/>`,
+        `<circle cx="20" cy="19" r="5.5" fill="${ROLE_COLORS.error}"/>`,
+        `<circle cx="40" cy="19" r="5.5" fill="${ROLE_COLORS.warning}"/>`,
+        `<circle cx="60" cy="19" r="5.5" fill="${ROLE_COLORS.success}"/>`,
+        `<text class="t" x="${WINDOW_W / 2}" y="23" text-anchor="middle">sweny try</text>`,
+        ...body,
+        `</svg>`,
+        ``,
+    ].join("\n");
+}
+// ── Entry points ────────────────────────────────────────────────
+const stripAnsi = (s) => s.replace(/\x1B\[[0-9;]*[A-Za-z]/g, "");
+/**
+ * The PR-comment preview (heading plus DAG) sits between the answer and the
+ * ticket. The recording drops it to stay a README-sized hero: tagline, nodes,
+ * answer, ticket.
+ */
+export function dropCommentPreview(lines) {
+    const from = lines.findIndex((l) => stripAnsi(l).includes("On a pull request, CI posts"));
+    const to = lines.findIndex((l, i) => i > from && stripAnsi(l).startsWith("  \u256D"));
+    if (from < 0 || to < 0)
+        return lines;
+    return [...lines.slice(0, from), ...lines.slice(to)];
+}
+/** Run the demo and return the SVG text. */
+export async function recordTrySvg(fixture = loadTryFixture()) {
+    let out = "";
+    // The DAG renderer paints through the default chalk; pin it so the capture carries color on any host.
+    const prevLevel = chalk.level;
+    chalk.level = 3;
+    try {
+        const code = await runTry({
+            fast: true,
+            tty: false,
+            color: true,
+            rich: true,
+            unicode: true,
+            columns: RECORD_COLUMNS,
+            fixture,
+            write: (s) => {
+                out += s;
+            },
+        });
+        if (code !== 0)
+            throw new Error(`the demo run exited ${code}`);
+    }
+    finally {
+        chalk.level = prevLevel;
+    }
+    const lines = out.split("\n");
+    while (lines.length > 0 && lines[0].trim() === "")
+        lines.shift();
+    while (lines.length > 0 && lines[lines.length - 1].trim() === "")
+        lines.pop();
+    return renderRecordingSvg(dropCommentPreview(lines), fixture);
+}
+/** Record to `file`, creating its directory. Returns the byte size written. */
+export async function recordTrySvgToFile(file, fixture) {
+    const svg = await recordTrySvg(fixture);
+    fs.mkdirSync(path.dirname(path.resolve(file)), { recursive: true });
+    fs.writeFileSync(file, svg);
+    return Buffer.byteLength(svg);
+}

package/dist/cli/setup.js

@@ -12,17 +12,17 @@ const SIGNAL_LABELS = [
     {
         name: "agent-needs-input",
         color: "CA8A04",
-        description: "Agent hit a decision point — needs human clarification before it can proceed",
+        description: "Agent hit a decision point - needs human clarification before it can proceed",
     },
     {
         name: "agent-error",
         color: "B91C1C",
-        description: "Unexpected technical failure during agent execution — needs human investigation",
+        description: "Unexpected technical failure during agent execution - needs human investigation",
     },
     {
         name: "human-only",
         color: "6B7280",
-        description: "Guard rail — automation must not touch this issue or PR",
+        description: "Guard rail - automation must not touch this issue or PR",
     },
     {
         name: "needs-review",
@@ -52,7 +52,7 @@ const WORK_TYPE_LABELS = [
     {
         name: "research",
         color: "D97706",
-        description: "Spike, investigation, or report by the agent — exploratory work without a direct code change",
+        description: "Spike, investigation, or report by the agent - exploratory work without a direct code change",
         isWorkType: true,
     },
     {
@@ -64,7 +64,7 @@ const WORK_TYPE_LABELS = [
     {
         name: "spec",
         color: "BE185D",
-        description: "Spec generation — agent converted non-technical input into a structured spec",
+        description: "Spec generation - agent converted non-technical input into a structured spec",
         isWorkType: true,
     },
     {
@@ -77,7 +77,7 @@ const WORK_TYPE_LABELS = [
 const AGENT_PARENT = {
     name: "agent",
     color: "7C3AED",
-    description: "Parent group — marks all autonomous agent work",
+    description: "Parent group - marks all autonomous agent work",
 };
 const BUG_LABEL = {
     name: "bug",
@@ -254,7 +254,7 @@ ${chalk.cyan(`  source-control-provider: github
   pr-labels: agent,triage,needs-review
   issue-labels: agent`)}
 
-${chalk.dim("  GitHub labels are referenced by name — no UUIDs needed.")}
+${chalk.dim("  GitHub labels are referenced by name - no UUIDs needed.")}
 `);
 }
 // ── Command registration ───────────────────────────────────────────────────

package/dist/cli/try.d.ts

@@ -86,6 +86,10 @@ export interface TryOptions {
     tty?: boolean;
     /** Draw with Unicode. Default: what the terminal supports. */
     unicode?: boolean;
+    /** Force ANSI color on or off. Default: on for a TTY that allows color. */
+    color?: boolean;
+    /** Force the receipt ticket (true) or the plain receipt line (false). Default: `tty`. */
+    rich?: boolean;
     /** Terminal width. Default: stdout's. */
     columns?: number;
     fixture?: TryFixture;

package/dist/cli/try.js

@@ -189,7 +189,7 @@ export async function runTry(opts = {}) {
     }
     const env = process.env;
     const unicode = opts.unicode ?? supportsUnicode(env);
-    const color = tty && colorEnabled({ isTTY: true }, env);
+    const color = opts.color ?? (tty && colorEnabled({ isTTY: true }, env));
     const paint = createPaint(color);
     const g = glyphsFor(unicode);
     const columns = opts.columns ?? terminalColumns(process.stdout, env);
@@ -263,7 +263,7 @@ export async function runTry(opts = {}) {
         runId: "demo",
         stream: { write, isTTY: tty, columns },
         env,
-        rich: tty,
+        rich: opts.rich ?? tty,
         color,
         unicode,
         animate: !opts.fast,
@@ -287,8 +287,21 @@ export function registerTryCommand(program) {
         .option("--fast", "Replay instantly instead of pacing the progress")
         .option("--pace <ms>", `Milliseconds each node takes to replay (default ${DEFAULT_TRY_PACE_MS})`)
         .option("--comment-file <path>", "Also write the PR-comment markdown to <path>")
+        .option("--record <file.svg>", "Write the demo as an animated, self-contained SVG terminal recording to <file.svg>")
         .addHelpText("after", `\n${TRY_HELP_NOTE}\n`)
         .action(async (options) => {
+        if (options.record) {
+            try {
+                const { recordTrySvgToFile } = await import("./record.js");
+                const bytes = await recordTrySvgToFile(options.record);
+                process.stdout.write(`  wrote ${options.record} (${bytes} bytes)\n`);
+            }
+            catch (err) {
+                console.error(`\n  could not record the demo: ${err instanceof Error ? err.message : err}\n`);
+                process.exitCode = 1;
+            }
+            return;
+        }
         let paceMs;
         if (options.pace !== undefined) {
             paceMs = Number(options.pace);

package/dist/cli/upgrade.js

@@ -154,7 +154,7 @@ export async function runUpgrade(options, deps) {
         latest = await deps.fetchLatestVersion(tag);
     }
     catch (err) {
-        stderr.write(chalk.red(`  Error: couldn't reach the npm registry — ${err instanceof Error ? err.message : String(err)}`) +
+        stderr.write(chalk.red(`  Error: couldn't reach the npm registry - ${err instanceof Error ? err.message : String(err)}`) +
             "\n");
         stderr.write(chalk.dim("  Check your network connection and try again.") + "\n");
         exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sweny-ai/core",
-  "version": "0.1.171",
+  "version": "0.1.172",
   "type": "module",
   "bin": {
     "sweny": "./dist/cli/main.js"