@asrunjs/asrun 0.2.0 → 0.5.3

package/dist/scripts/go.mjs

@@ -1,188 +1,188 @@
-// One-liner for a fresh machine: install everything, prepare the workspace, then start the web UI and open it.
-// Plain Node on purpose: it may run before the dependencies are installed.
-//
-//   pnpm add -D @asrunjs/asrun        (or github:wizcas/asrun#v0.1.0)
-//   pnpm exec asrun init
-//   pnpm go
-import {spawn, spawnSync} from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-
-const FRAMEWORK = path.resolve(import.meta.dirname, '..');
-const PACKAGE = '@asrunjs/asrun';
-const MARKERS = ['.asrun.json', 'profiles.yaml'];
-const port = Number(process.env.ASRUN_UI_PORT ?? 4173);
-const url = `http://127.0.0.1:${port}`;
-const openBrowser = !process.argv.includes('--no-open');
-const shell = process.platform === 'win32';
-
-// `.env` next to the command, or the framework's own `.env`; a real environment variable always wins.
-function loadRootEnv(file) {
-  try {
-    for (const raw of fs.readFileSync(file, 'utf8').split(/\r?\n/)) {
-      if (process.env.ASRUN_ROOT !== undefined) return;
-      const match = /^(?:export\s+)?ASRUN_ROOT\s*=\s*(.*)$/.exec(raw.trim());
-      if (match) {
-        process.env.ASRUN_ROOT = path.resolve(path.dirname(file), match[1].trim().replace(/^(['"])(.*)\1$/, '$2'));
-      }
-    }
-  } catch {
-    // no .env: nothing to do
-  }
-}
-loadRootEnv(path.join(process.cwd(), '.env'));
-if (process.env.ASRUN_ROOT === undefined) loadRootEnv(path.join(FRAMEWORK, '.env'));
-
-// The workspace: the project that owns profiles.yaml, cases/ and tests/. Inside the framework repository
-// (which has none of those) the demo workspace is used, so the framework itself can be developed this way.
-function findWorkspace(from) {
-  for (let dir = path.resolve(from); ; dir = path.dirname(dir)) {
-    if (MARKERS.some((marker) => fs.existsSync(path.join(dir, marker)))) return dir;
-    if (path.dirname(dir) === dir) return null;
-  }
-}
-const demo = path.join(FRAMEWORK, 'examples', 'demo');
-const ROOT = (process.env.ASRUN_ROOT && path.resolve(process.env.ASRUN_ROOT)) || findWorkspace(process.cwd()) || demo;
-if (ROOT === FRAMEWORK && !fs.existsSync(demo)) {
-  console.error('No workspace found: run this command in the project that uses asrun, or set ASRUN_ROOT.');
-  process.exit(1);
-}
-
-const step = (n, text) => console.log(`\n\x1b[1;36m[${n}/4] ${text}\x1b[0m`);
-const warn = (text) => console.log(`\x1b[33m! ${text}\x1b[0m`);
-const fail = (text) => {
-  console.error(`\x1b[31m${text}\x1b[0m`);
-  process.exit(1);
-};
-const run = (command, args, options = {}) =>
-  spawnSync(command, args, {cwd: ROOT, stdio: 'inherit', shell, ...options}).status === 0;
-const exists = (command) => spawnSync(command, ['--version'], {stdio: 'ignore', shell}).status === 0;
-
-/** The JavaScript entry point of a package's command-line tool, without relying on node_modules/.bin shims. */
-function packageBin(name, command = name) {
-  for (const base of [FRAMEWORK, path.dirname(path.dirname(FRAMEWORK)), ROOT]) {
-    const dir = path.join(base, 'node_modules', name);
-    const manifest = path.join(dir, 'package.json');
-    if (!fs.existsSync(manifest)) continue;
-    const bin = JSON.parse(fs.readFileSync(manifest, 'utf8')).bin;
-    const entry = typeof bin === 'string' ? bin : bin?.[command];
-    if (entry) return path.join(dir, entry);
-  }
-  return null;
-}
-
-/** The installed command of this workspace, or the framework's own bin while developing it here. */
-const bin = packageBin(PACKAGE) ?? path.join(FRAMEWORK, 'bin', 'asrun.mjs');
-/** The workspace's copy of the package, if any. */
-const installed = fs.existsSync(path.join(ROOT, 'node_modules', PACKAGE, 'package.json'));
-const frameworkRelative = installed
-  ? './' + path.relative(ROOT, path.join(ROOT, 'node_modules', PACKAGE)).split(path.sep).join('/')
-  : (() => {
-      const relative = path.relative(ROOT, FRAMEWORK).split(path.sep).join('/');
-      return relative === '' ? '.' : relative.startsWith('.') ? relative : `./${relative}`;
-    })();
-
-/** pnpm only installs dependencies normally; its build scripts need an explicit approval in pnpm-workspace.yaml. */
-function ensurePnpmWorkspace() {
-  if (frameworkRelative.startsWith('..')) return 'skipped';
-  const file = path.join(ROOT, 'pnpm-workspace.yaml');
-  const block = 'allowBuilds:\n  esbuild: true\n  ffmpeg-static: true\n';
-  if (!fs.existsSync(file)) {
-    fs.writeFileSync(file, `# asrun's dependencies (esbuild through tsx, ffmpeg-static) compile a binary on install.\n${block}`);
-    return 'created';
-  }
-  const text = fs.readFileSync(file, 'utf8');
-  if (text.includes('allowBuilds')) return 'kept';
-  fs.writeFileSync(file, `${text.replace(/\n*$/, '\n')}\n${block}`);
-  return 'updated';
-}
-
-async function uiIsUp() {
-  try {
-    return (await fetch(`${url}/api/info`, {signal: AbortSignal.timeout(1500)})).ok;
-  } catch {
-    return false;
-  }
-}
-
-function open(target) {
-  const [command, args] =
-    process.platform === 'darwin'
-      ? ['open', [target]]
-      : process.platform === 'win32'
-        ? ['cmd', ['/c', 'start', '', target]]
-        : ['xdg-open', [target]];
-  spawn(command, args, {stdio: 'ignore', detached: true}).on('error', () => {}).unref();
-}
-
-// ffmpeg joins the videos of a test's browser tabs into one. Never fatal: the optional ffmpeg-static package is the fallback.
-function ensureFfmpeg() {
-  // ffmpeg does not know `--version`, only `-version`.
-  if (spawnSync('ffmpeg', ['-version'], {stdio: 'ignore', shell}).status === 0) return console.log('ffmpeg: ok');
-  const installer =
-    process.platform === 'darwin' && exists('brew')
-      ? ['brew', ['install', 'ffmpeg']]
-      : process.platform === 'win32' && exists('winget')
-        ? ['winget', ['install', '--id', 'Gyan.FFmpeg', '-e', '--accept-source-agreements', '--accept-package-agreements']]
-        : null;
-  if (!installer) {
-    return warn('ffmpeg not found; the bundled ffmpeg-static is used instead. To install it yourself: brew install ffmpeg | winget install Gyan.FFmpeg | sudo apt install ffmpeg');
-  }
-  console.log(`ffmpeg not found, installing it: ${installer[0]} ${installer[1].join(' ')}`);
-  if (run(...installer)) console.log('ffmpeg: installed');
-  else warn('Could not install ffmpeg; the bundled ffmpeg-static is used instead.');
-}
-
-step(1, 'Checking this machine');
-const nodeMajor = Number(process.versions.node.split('.')[0]);
-if (nodeMajor < 22) fail(`Node 22 or newer is required (this is ${process.versions.node}). Install it from https://nodejs.org and run "pnpm go" again.`);
-console.log(`Node ${process.versions.node}: ok`);
-console.log(`workspace: ${ROOT}`);
-console.log(`framework: ${FRAMEWORK}${installed ? ' (installed)' : ' (development checkout)'}`);
-ensureFfmpeg();
-if (!exists('claude') && !exists('opencode')) {
-  warn('Neither "claude" (Claude Code) nor "opencode" found. Everything works except the AI steps (make cases, review, generate specs).');
-}
-
-step(2, 'Installing dependencies and the browser (a minute the first time, seconds after that)');
-const workspaceFile = ensurePnpmWorkspace();
-if (workspaceFile === 'created') console.log('pnpm-workspace.yaml: created (allowBuilds)');
-else if (workspaceFile === 'updated') console.log('pnpm-workspace.yaml: updated (allowBuilds)');
-const installRoot = frameworkRelative.startsWith('..') ? FRAMEWORK : ROOT;
-if (!run('pnpm', ['install'], {cwd: installRoot})) fail('Install failed. Fix the error above and run "pnpm go" again.');
-const playwright = packageBin('@playwright/test', 'playwright');
-if (playwright) {
-  if (!run(process.execPath, [playwright, 'install', 'chromium'])) warn('Could not install the Chromium browser; run "pnpm exec playwright install chromium".');
-} else {
-  warn('@playwright/test is not installed yet. Run this command again after the workspace files are in place.');
-}
-
-step(3, 'Preparing the workspace');
-// `--root` names the workspace, but the command runs where the person is: that is where `.env` belongs.
-if (!run(process.execPath, [bin, 'init', '--root', ROOT], {cwd: process.cwd()})) {
-  fail('Could not initialize the workspace. Run "pnpm asrun init" and read the message.');
-}
-run(process.execPath, [bin, 'doctor']);
-
-step(4, `Starting the web UI at ${url}`);
-if (await uiIsUp()) {
-  console.log('The UI is already running.');
-  if (openBrowser) open(url);
-  process.exit(0);
-}
-
-const env = {...process.env, ASRUN_ROOT: ROOT};
-const child = spawn(process.execPath, [bin, 'ui'], {cwd: ROOT, stdio: 'inherit', env, shell});
-// Ctrl+C reaches the UI server directly (same terminal); we only wait for it to shut down.
-process.on('SIGINT', () => {});
-process.on('SIGTERM', () => child.kill('SIGTERM'));
-child.on('exit', (code) => process.exit(code ?? 0));
-
-for (let i = 0; i < 240 && child.exitCode === null; i++) {
-  if (await uiIsUp()) {
-    console.log(`\n\x1b[1;32mReady: ${url}\x1b[0m  (Ctrl+C to stop)`);
-    if (openBrowser) open(url);
-    break;
-  }
-  await new Promise((resolve) => setTimeout(resolve, 500));
-}
+// One-liner for a fresh machine: install everything, prepare the workspace, then start the web UI and open it.
+// Plain Node on purpose: it may run before the dependencies are installed.
+//
+//   pnpm add -D @asrunjs/asrun        (or github:wizcas/asrun#<tag>)
+//   pnpm exec asrun init
+//   pnpm go
+import {spawn, spawnSync} from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const FRAMEWORK = path.resolve(import.meta.dirname, '..');
+const PACKAGE = '@asrunjs/asrun';
+const MARKERS = ['.asrun.json', 'profiles.yaml'];
+const port = Number(process.env.ASRUN_UI_PORT ?? 4173);
+const url = `http://127.0.0.1:${port}`;
+const openBrowser = !process.argv.includes('--no-open');
+const shell = process.platform === 'win32';
+
+// `.env` next to the command, or the framework's own `.env`; a real environment variable always wins.
+function loadRootEnv(file) {
+  try {
+    for (const raw of fs.readFileSync(file, 'utf8').split(/\r?\n/)) {
+      if (process.env.ASRUN_ROOT !== undefined) return;
+      const match = /^(?:export\s+)?ASRUN_ROOT\s*=\s*(.*)$/.exec(raw.trim());
+      if (match) {
+        process.env.ASRUN_ROOT = path.resolve(path.dirname(file), match[1].trim().replace(/^(['"])(.*)\1$/, '$2'));
+      }
+    }
+  } catch {
+    // no .env: nothing to do
+  }
+}
+loadRootEnv(path.join(process.cwd(), '.env'));
+if (process.env.ASRUN_ROOT === undefined) loadRootEnv(path.join(FRAMEWORK, '.env'));
+
+// The workspace: the project that owns profiles.yaml, cases/ and tests/. Inside the framework repository
+// (which has none of those) the demo workspace is used, so the framework itself can be developed this way.
+function findWorkspace(from) {
+  for (let dir = path.resolve(from); ; dir = path.dirname(dir)) {
+    if (MARKERS.some((marker) => fs.existsSync(path.join(dir, marker)))) return dir;
+    if (path.dirname(dir) === dir) return null;
+  }
+}
+const demo = path.join(FRAMEWORK, 'examples', 'demo');
+const ROOT = (process.env.ASRUN_ROOT && path.resolve(process.env.ASRUN_ROOT)) || findWorkspace(process.cwd()) || demo;
+if (ROOT === FRAMEWORK && !fs.existsSync(demo)) {
+  console.error('No workspace found: run this command in the project that uses asrun, or set ASRUN_ROOT.');
+  process.exit(1);
+}
+
+const step = (n, text) => console.log(`\n\x1b[1;36m[${n}/4] ${text}\x1b[0m`);
+const warn = (text) => console.log(`\x1b[33m! ${text}\x1b[0m`);
+const fail = (text) => {
+  console.error(`\x1b[31m${text}\x1b[0m`);
+  process.exit(1);
+};
+const run = (command, args, options = {}) =>
+  spawnSync(command, args, {cwd: ROOT, stdio: 'inherit', shell, ...options}).status === 0;
+const exists = (command) => spawnSync(command, ['--version'], {stdio: 'ignore', shell}).status === 0;
+
+/** The JavaScript entry point of a package's command-line tool, without relying on node_modules/.bin shims. */
+function packageBin(name, command = name) {
+  for (const base of [FRAMEWORK, path.dirname(path.dirname(FRAMEWORK)), ROOT]) {
+    const dir = path.join(base, 'node_modules', name);
+    const manifest = path.join(dir, 'package.json');
+    if (!fs.existsSync(manifest)) continue;
+    const bin = JSON.parse(fs.readFileSync(manifest, 'utf8')).bin;
+    const entry = typeof bin === 'string' ? bin : bin?.[command];
+    if (entry) return path.join(dir, entry);
+  }
+  return null;
+}
+
+/** The installed command of this workspace, or the framework's own bin while developing it here. */
+const bin = packageBin(PACKAGE) ?? path.join(FRAMEWORK, 'bin', 'asrun.mjs');
+/** The workspace's copy of the package, if any. */
+const installed = fs.existsSync(path.join(ROOT, 'node_modules', PACKAGE, 'package.json'));
+const frameworkRelative = installed
+  ? './' + path.relative(ROOT, path.join(ROOT, 'node_modules', PACKAGE)).split(path.sep).join('/')
+  : (() => {
+      const relative = path.relative(ROOT, FRAMEWORK).split(path.sep).join('/');
+      return relative === '' ? '.' : relative.startsWith('.') ? relative : `./${relative}`;
+    })();
+
+/** pnpm only installs dependencies normally; its build scripts need an explicit approval in pnpm-workspace.yaml. */
+function ensurePnpmWorkspace() {
+  if (frameworkRelative.startsWith('..')) return 'skipped';
+  const file = path.join(ROOT, 'pnpm-workspace.yaml');
+  const block = 'allowBuilds:\n  esbuild: true\n  ffmpeg-static: true\n';
+  if (!fs.existsSync(file)) {
+    fs.writeFileSync(file, `# asrun's dependencies (esbuild through tsx, ffmpeg-static) compile a binary on install.\n${block}`);
+    return 'created';
+  }
+  const text = fs.readFileSync(file, 'utf8');
+  if (text.includes('allowBuilds')) return 'kept';
+  fs.writeFileSync(file, `${text.replace(/\n*$/, '\n')}\n${block}`);
+  return 'updated';
+}
+
+async function uiIsUp() {
+  try {
+    return (await fetch(`${url}/api/info`, {signal: AbortSignal.timeout(1500)})).ok;
+  } catch {
+    return false;
+  }
+}
+
+function open(target) {
+  const [command, args] =
+    process.platform === 'darwin'
+      ? ['open', [target]]
+      : process.platform === 'win32'
+        ? ['cmd', ['/c', 'start', '', target]]
+        : ['xdg-open', [target]];
+  spawn(command, args, {stdio: 'ignore', detached: true}).on('error', () => {}).unref();
+}
+
+// ffmpeg joins the videos of a test's browser tabs into one. Never fatal: the optional ffmpeg-static package is the fallback.
+function ensureFfmpeg() {
+  // ffmpeg does not know `--version`, only `-version`.
+  if (spawnSync('ffmpeg', ['-version'], {stdio: 'ignore', shell}).status === 0) return console.log('ffmpeg: ok');
+  const installer =
+    process.platform === 'darwin' && exists('brew')
+      ? ['brew', ['install', 'ffmpeg']]
+      : process.platform === 'win32' && exists('winget')
+        ? ['winget', ['install', '--id', 'Gyan.FFmpeg', '-e', '--accept-source-agreements', '--accept-package-agreements']]
+        : null;
+  if (!installer) {
+    return warn('ffmpeg not found; the bundled ffmpeg-static is used instead. To install it yourself: brew install ffmpeg | winget install Gyan.FFmpeg | sudo apt install ffmpeg');
+  }
+  console.log(`ffmpeg not found, installing it: ${installer[0]} ${installer[1].join(' ')}`);
+  if (run(...installer)) console.log('ffmpeg: installed');
+  else warn('Could not install ffmpeg; the bundled ffmpeg-static is used instead.');
+}
+
+step(1, 'Checking this machine');
+const nodeMajor = Number(process.versions.node.split('.')[0]);
+if (nodeMajor < 22) fail(`Node 22 or newer is required (this is ${process.versions.node}). Install it from https://nodejs.org and run "pnpm go" again.`);
+console.log(`Node ${process.versions.node}: ok`);
+console.log(`workspace: ${ROOT}`);
+console.log(`framework: ${FRAMEWORK}${installed ? ' (installed)' : ' (development checkout)'}`);
+ensureFfmpeg();
+if (!exists('claude') && !exists('opencode')) {
+  warn('Neither "claude" (Claude Code) nor "opencode" found. Everything works except the AI steps (make cases, review, generate specs).');
+}
+
+step(2, 'Installing dependencies and the browser (a minute the first time, seconds after that)');
+const workspaceFile = ensurePnpmWorkspace();
+if (workspaceFile === 'created') console.log('pnpm-workspace.yaml: created (allowBuilds)');
+else if (workspaceFile === 'updated') console.log('pnpm-workspace.yaml: updated (allowBuilds)');
+const installRoot = frameworkRelative.startsWith('..') ? FRAMEWORK : ROOT;
+if (!run('pnpm', ['install'], {cwd: installRoot})) fail('Install failed. Fix the error above and run "pnpm go" again.');
+const playwright = packageBin('@playwright/test', 'playwright');
+if (playwright) {
+  if (!run(process.execPath, [playwright, 'install', 'chromium'])) warn('Could not install the Chromium browser; run "pnpm exec playwright install chromium".');
+} else {
+  warn('@playwright/test is not installed yet. Run this command again after the workspace files are in place.');
+}
+
+step(3, 'Preparing the workspace');
+// `--root` names the workspace, but the command runs where the person is: that is where `.env` belongs.
+if (!run(process.execPath, [bin, 'init', '--root', ROOT], {cwd: process.cwd()})) {
+  fail('Could not initialize the workspace. Run "pnpm asrun init" and read the message.');
+}
+run(process.execPath, [bin, 'doctor']);
+
+step(4, `Starting the web UI at ${url}`);
+if (await uiIsUp()) {
+  console.log('The UI is already running.');
+  if (openBrowser) open(url);
+  process.exit(0);
+}
+
+const env = {...process.env, ASRUN_ROOT: ROOT};
+const child = spawn(process.execPath, [bin, 'ui'], {cwd: ROOT, stdio: 'inherit', env, shell});
+// Ctrl+C reaches the UI server directly (same terminal); we only wait for it to shut down.
+process.on('SIGINT', () => {});
+process.on('SIGTERM', () => child.kill('SIGTERM'));
+child.on('exit', (code) => process.exit(code ?? 0));
+
+for (let i = 0; i < 240 && child.exitCode === null; i++) {
+  if (await uiIsUp()) {
+    console.log(`\n\x1b[1;32mReady: ${url}\x1b[0m  (Ctrl+C to stop)`);
+    if (openBrowser) open(url);
+    break;
+  }
+  await new Promise((resolve) => setTimeout(resolve, 500));
+}

package/dist/scripts/init.d.ts

@@ -7,8 +7,14 @@ export declare const GENERATED: {
 export declare function frameworkPath(root: string): string;
 /** True when this workspace has the package installed (or is the framework's own checkout). */
 export declare function isInstalled(root: string): boolean;
-/** Fills the `{{framework}}` placeholder of a template. */
+/** Fills the `{{framework}}` and `{{playwright}}` placeholders of a template. */
 export declare function renderTemplate(name: string, root: string): string;
+/**
+ * The Playwright CLI the MCP server runs. The workspace's own install is the normal place; a workspace that lives
+ * inside the framework repository (examples/demo) has no `node_modules` of its own, so it points at the framework's.
+ * Kept relative: the file is committed and must not name a machine.
+ */
+export declare function playwrightBin(root: string): string;
 export declare function frameworkVersion(): {
     version: string;
     commit: string;

package/dist/scripts/init.js

@@ -6,13 +6,15 @@ import { FRAMEWORK_ROOT, TEMPLATES_DIR } from '../lib/paths.js';
  * Creates the files a workspace needs. It is safe to run many times: it never overwrites a file the project owns, and
  * `--update` refreshes only the files generated from the framework templates.
  */
-const USAGE = `Usage: pnpm asrun init [--root <dir>] [--update] [--force <path>] [--no-env] [--install [spec]]
-
-  --root <dir>    the workspace to initialize (default: the current folder)
-  --update        refresh the generated files (playwright.config.ts, tests/seed.spec.ts, .claude/commands/*)
-  --force <path>  overwrite one file, e.g. --force playwright.config.ts (may be repeated)
-  --no-env        do not write .env (ASRUN_ROOT)
-  --install [spec]  also add the dependency (default "asrun"; e.g. --install github:wizcas/asrun#v0.1.0)`;
+const USAGE = `Usage: pnpm asrun init [--root <dir>] [--update] [--force <path>] [--no-env] [--install [spec]]
+
+  --root <dir>    the workspace to initialize (default: the current folder)
+  --update        refresh the generated files (playwright.config.ts, tests/seed.spec.ts, .claude/commands/*,
+                  .opencode/commands/*)
+  --force <path>  overwrite one file this tool writes, e.g. --force playwright.config.ts (may be repeated)
+  --reset-rules   allow --force on AGENTS.md, CLAUDE.md or .claude/skills/** (project-owned rules)
+  --no-env        do not write .env (ASRUN_ROOT)
+  --install [spec]  also add the dependency (default "asrun"; e.g. --install github:<owner>/<repo>#<tag>)`;
 /** Files `init` owns: `--update` rewrites exactly these, and a project never edits them. */
 export const GENERATED = [
     { file: 'playwright.config.ts', template: 'playwright.config.ts' },
@@ -21,12 +23,18 @@ export const GENERATED = [
     { file: '.claude/commands/explore-case.md', template: '.claude/commands/explore-case.md' },
     { file: '.claude/commands/gen-spec.md', template: '.claude/commands/gen-spec.md' },
     { file: '.claude/commands/heal-spec.md', template: '.claude/commands/heal-spec.md' },
+    // OpenCode does not read `.claude/commands` (only `.claude/skills`), so the same commands live here too.
+    { file: '.opencode/commands/make-case.md', template: '.claude/commands/make-case.md' },
+    { file: '.opencode/commands/explore-case.md', template: '.claude/commands/explore-case.md' },
+    { file: '.opencode/commands/gen-spec.md', template: '.claude/commands/gen-spec.md' },
+    { file: '.opencode/commands/heal-spec.md', template: '.claude/commands/heal-spec.md' },
 ];
 /** Files `init` creates once; after that the project owns them and may edit them freely. */
 const ONCE = [
     { file: 'AGENTS.md', template: 'AGENTS.md' },
     { file: 'CLAUDE.md', template: 'CLAUDE.md' },
     { file: '.mcp.json', template: '.mcp.json' },
+    { file: 'opencode.jsonc', template: 'opencode.jsonc' },
     { file: '.claude/settings.json', template: '.claude/settings.json' },
     { file: 'tsconfig.json', template: 'tsconfig.json' },
     { file: 'pnpm-workspace.yaml', template: 'pnpm-workspace.yaml' },
@@ -71,9 +79,22 @@ export function frameworkPath(root) {
 export function isInstalled(root) {
     return fs.existsSync(path.join(path.resolve(root, frameworkPath(root)), 'package.json'));
 }
-/** Fills the `{{framework}}` placeholder of a template. */
+/** Fills the `{{framework}}` and `{{playwright}}` placeholders of a template. */
 export function renderTemplate(name, root) {
-    return readTemplate(name).replaceAll('{{framework}}', frameworkPath(root));
+    return readTemplate(name)
+        .replaceAll('{{framework}}', frameworkPath(root))
+        .replaceAll('{{playwright}}', playwrightBin(root));
+}
+/**
+ * The Playwright CLI the MCP server runs. The workspace's own install is the normal place; a workspace that lives
+ * inside the framework repository (examples/demo) has no `node_modules` of its own, so it points at the framework's.
+ * Kept relative: the file is committed and must not name a machine.
+ */
+export function playwrightBin(root) {
+    if (fs.existsSync(path.join(root, 'node_modules', '.bin', 'playwright')))
+        return './node_modules/.bin/playwright';
+    const framework = frameworkPath(root);
+    return framework.startsWith('..') ? `${framework}/node_modules/.bin/playwright` : './node_modules/.bin/playwright';
 }
 export function frameworkVersion() {
     let version = '0.0.0';
@@ -183,7 +204,10 @@ export async function main(args) {
     const installAt = args.indexOf('--install');
     const install = installAt >= 0;
     const installSpec = install && args[installAt + 1] && !args[installAt + 1].startsWith('-') ? args[installAt + 1] : PACKAGE;
-    const forced = args.flatMap((arg, index) => (arg === '--force' && args[index + 1] ? [args[index + 1]] : []));
+    const forced = args
+        .flatMap((arg, index) => (arg === '--force' && args[index + 1] ? [args[index + 1]] : []))
+        .map((file) => file.split('\\').join('/'));
+    const resetRules = args.includes('--reset-rules');
     const skipEnv = args.includes('--no-env');
     if (path.resolve(root) === path.resolve(FRAMEWORK_ROOT)) {
         console.error('This folder is the framework itself, not a workspace. Run "pnpm asrun init" inside the project that uses ' +
@@ -195,6 +219,20 @@ export async function main(args) {
     const kept = [];
     const notes = [];
     const framework = frameworkPath(root);
+    // `--force` repairs a file this tool writes. A project's own rules are never overwritten by a framework update:
+    // `AGENTS.md`, `CLAUDE.md` and `.claude/skills/**` need `--reset-rules` on top.
+    const owned = [...GENERATED, ...ONCE].map((entry) => entry.file);
+    const projectRules = (file) => file === 'AGENTS.md' || file === 'CLAUDE.md' || file === '.claude/skills' || file.startsWith('.claude/skills/');
+    for (const file of forced) {
+        if (!owned.includes(file)) {
+            console.error(`--force ${file}: init only writes the files it owns (${owned.join(', ')}).`);
+            return 1;
+        }
+        if (projectRules(file) && !resetRules) {
+            console.error(`--force ${file}: this file belongs to the project. Add --reset-rules to replace it with the template.`);
+            return 1;
+        }
+    }
     const place = (entry, overwrite) => {
         const target = path.join(root, entry.file);
         if (fs.existsSync(target) && !overwrite) {
@@ -231,10 +269,20 @@ export async function main(args) {
             notes.push('pnpm-workspace.yaml lists "packages"; asrun is a dependency now, so that list can go.');
         }
     }
-    if (fs.existsSync(path.join(root, '.mcp.json'))) {
-        const mcp = fs.readFileSync(path.join(root, '.mcp.json'), 'utf8');
-        if (!mcp.includes('playwright-test'))
-            notes.push('Add the "playwright-test" MCP server to .mcp.json (see templates/.mcp.json).');
+    if (fs.existsSync(path.join(root, '.mcp.json')) && !fs.readFileSync(path.join(root, '.mcp.json'), 'utf8').includes('playwright-test')) {
+        notes.push('Add the "playwright-test" MCP server to .mcp.json (see templates/.mcp.json).');
+    }
+    if (fs.existsSync(path.join(root, 'opencode.jsonc')) && !fs.readFileSync(path.join(root, 'opencode.jsonc'), 'utf8').includes('playwright-test')) {
+        notes.push('Add the "playwright-test" MCP server to opencode.jsonc (see templates/opencode.jsonc).');
+    }
+    if (fs.existsSync(path.join(root, 'opencode.jsonc'))) {
+        const text = fs.readFileSync(path.join(root, 'opencode.jsonc'), 'utf8');
+        // A commented-out "model" (the template has one) does not set anything: only a real key counts.
+        const withoutComments = text.replace(/^\s*\/\/.*$/gm, '');
+        if (!/["']?model["']?\s*:/.test(withoutComments)) {
+            notes.push('opencode.jsonc sets no "model": a one-shot "opencode run" then uses OpenCode\'s built-in free model, which has a ' +
+                'daily usage limit. Pick a model in the AsRun web UI (top bar), or set "model" there.');
+        }
     }
     if (fs.existsSync(path.join(root, '.claude', 'settings.json'))) {
         const settings = fs.readFileSync(path.join(root, '.claude', 'settings.json'), 'utf8');

package/dist/scripts/lint-specs.js

@@ -128,8 +128,11 @@ function lint(file) {
     TARGET_REF.lastIndex = 0;
     return findings;
 }
+// A case id is written with `/` (`conduit/header-navigation`), while a path on Windows has `\`: without the
+// normalization this filter matched nothing and reported "0 spec(s)" for a spec that was right there.
+const casePath = (file) => file.replace(/\\/g, '/');
 const wanted = process.argv.slice(2).filter((arg) => !arg.startsWith('-'));
-const files = specFiles(TESTS_DIR).filter((file) => wanted.length === 0 || wanted.some((id) => file.endsWith(`${id}.spec.ts`)));
+const files = specFiles(TESTS_DIR).filter((file) => wanted.length === 0 || wanted.some((id) => casePath(file).endsWith(`${casePath(id)}.spec.ts`)));
 const findings = files.flatMap(lint);
 for (const f of findings)
     console.log(`${f.level.toUpperCase().padEnd(4)} ${f.file}:${f.line}  [${f.rule}] ${f.message}`);

package/dist/scripts/login.js

@@ -6,6 +6,7 @@ import { getProfile, listProfiles, profileLabel } from '../lib/profiles.js';
 import { parseCliTarget } from '../lib/cli.js';
 import { authFile } from '../lib/paths.js';
 import { checkSession } from '../lib/session.js';
+import { showLoginCard, showLoginCardSaved, waitForLoginCard } from '../lib/login-card.js';
 const parsed = parseCliTarget(process.argv.slice(2));
 if (!parsed.profileId || parsed.help) {
     console.log('Usage: pnpm signin <profile-id>\n\nProfiles:');
@@ -23,14 +24,41 @@ const file = authFile(profile.id);
 fs.mkdirSync(path.dirname(file), { recursive: true });
 const browser = await chromium.launch({ headless: false });
 const context = await browser.newContext({ viewport: null });
+// The card goes in before the first page, so it is there on the login page and again after every navigation.
+showLoginCard(context, `Log in as usual, including the 2FA code. When you can see the logged-in page, press "Done, save the session": ` +
+    `the session is saved and this window closes.`);
 const page = await context.newPage();
 await page.goto(new URL('/login/', profile.baseURL).href);
 console.log(`\nA browser window opened for "${profileLabel(profile)}" (${profile.baseURL}).`);
 console.log('1. Log in as usual, including the 2FA code.');
-console.log('2. Wait until you can see the logged-in page.');
+console.log('2. When you can see the logged-in page, press "Done, save the session" on the card in that window.');
+console.log('   The card sits in the bottom-left corner; drag it if it is in the way.');
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-await rl.question('3. Come back here and press Enter to save the session... ');
+const stopWaiting = new AbortController();
+const card = waitForLoginCard(context, page, stopWaiting.signal);
+const typed = rl
+    .question('   Or press Enter here (in the terminal, or the button on the job in the UI): ')
+    .then(() => 'enter');
+const answer = await Promise.race([
+    card.then((outcome) => ({ via: 'card', outcome })),
+    typed.then(() => ({ via: 'enter', outcome: 'done' })),
+]);
+stopWaiting.abort();
 rl.close();
+if (answer.via === 'card' && answer.outcome !== 'done') {
+    await browser.close().catch(() => { });
+    console.error(answer.outcome === 'cancel'
+        ? `\nNothing was saved: the login was cancelled on the card. Run \`pnpm signin ${profile.id}\` again when you are ready.`
+        : '\nNothing was saved: the browser window was closed before the session was saved. ' +
+            `Run \`pnpm signin ${profile.id}\` again.`);
+    process.exit(1);
+}
+if (answer.via === 'card') {
+    console.log('\nSaving the session from the card...');
+    // The person is still looking at the window: say that the session is safe before it disappears.
+    await showLoginCardSaved(context, 'Session saved. Closing this window...');
+    await new Promise((resolve) => setTimeout(resolve, 1200));
+}
 await context.storageState({ path: file });
 await browser.close();
 fs.chmodSync(file, 0o600);

package/dist/ui/server/actions.d.ts

@@ -24,6 +24,8 @@ export declare const startJobSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     env: z.ZodString;
     force: z.ZodOptional<z.ZodBoolean>;
     attended: z.ZodOptional<z.ZodBoolean>;
+    thinking: z.ZodOptional<z.ZodBoolean>;
+    model: z.ZodOptional<z.ZodString>;
     profiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     hints: z.ZodOptional<z.ZodString>;
     report: z.ZodOptional<z.ZodString>;
@@ -38,6 +40,8 @@ export declare const startJobSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         opencode: "opencode";
     }>;
     memo: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    thinking: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodObject<{
     action: z.ZodLiteral<"run">;
     env: z.ZodString;