@webpresso/agent-kit 0.21.3 → 0.21.5

package/dist/esm/cli/commands/init/scaffold-base-kit.js

@@ -1,6 +1,30 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { writeFileMerged } from './merge.js';
+const AUTHORING_TIME_DEPENDENCIES = [
+    'vitest',
+    '@playwright/test',
+    '@testing-library/jest-dom',
+    'typescript',
+];
+const EXECUTION_ONLY_REVIEW_DEPENDENCIES = [
+    'oxlint',
+    'oxfmt',
+    'prettier',
+    'markdownlint-cli2',
+    'stryker',
+];
+export function collectRuntimeContractGuidance(packageJson) {
+    const deps = {
+        ...readDependencyBucket(packageJson?.['dependencies']),
+        ...readDependencyBucket(packageJson?.['devDependencies']),
+    };
+    const installed = new Set(Object.keys(deps));
+    return {
+        keepLocalAuthoringDeps: AUTHORING_TIME_DEPENDENCIES.filter((name) => installed.has(name)),
+        reviewForRemovalDeps: EXECUTION_ONLY_REVIEW_DEPENDENCIES.filter((name) => installed.has(name)),
+    };
+}
 /** Template files relative to `catalog/base-kit/`, and their target paths relative to repoRoot. */
 const TEMPLATE_MAP = [
     ['.editorconfig.tmpl', '.editorconfig'],
@@ -18,6 +42,19 @@ const TEMPLATE_MAP = [
     ['test/.gitkeep.tmpl', 'test/.gitkeep'],
     ['e2e/.gitkeep.tmpl', 'e2e/.gitkeep'],
 ];
+/** Consumer-owned quality scaffold: create for fresh repos, never clobber. */
+const QUALITY_BOOTSTRAP_ONLY_MAP = [
+    ['tsconfig.json.tmpl', 'tsconfig.json'],
+    ['vitest.config.ts.tmpl', 'vitest.config.ts'],
+    ['oxlint.config.ts.tmpl', 'oxlint.config.ts'],
+    ['stryker.config.ts.tmpl', 'stryker.config.ts'],
+    ['playwright.config.ts.tmpl', 'playwright.config.ts'],
+    ['src/quality-sample.ts.tmpl', 'src/quality-sample.ts'],
+    ['src/quality-sample.test.ts.tmpl', 'src/quality-sample.test.ts'],
+    ['e2e/fixtures/smoke.html.tmpl', 'e2e/fixtures/smoke.html'],
+    ['e2e/smoke.spec.ts.tmpl', 'e2e/smoke.spec.ts'],
+];
+export const BASE_KIT_QUALITY_TARGETS = QUALITY_BOOTSTRAP_ONLY_MAP.map(([, targetRel]) => targetRel);
 /**
  * Bootstrap-only templates: the scaffolder writes them when absent (so a
  * fresh repo gets sane defaults) but NEVER overwrites them once they exist
@@ -75,35 +112,85 @@ function mergePackageJson(repoRoot, options, globalInstall = false) {
     const hasVerifySecrets = typeof scripts['verify:secrets'] === 'string';
     const hasSecretQuarantineAudit = typeof scripts['audit:secret-provider-quarantine'] === 'string';
     const hasPrepareScript = typeof scripts['prepare'] === 'string';
+    const hasLintScript = typeof scripts['lint'] === 'string';
+    const hasTypecheckScript = typeof scripts['typecheck'] === 'string';
+    const hasTestScript = typeof scripts['test'] === 'string' && !isNpmInitPlaceholderTestScript(scripts['test']);
+    const hasMutationScript = typeof scripts['mutation'] === 'string';
+    const hasTestMutationScript = typeof scripts['test:mutation'] === 'string';
+    const hasE2eScript = typeof scripts['e2e'] === 'string';
+    const hasQaScript = typeof scripts['qa'] === 'string';
     const verifyPathsScript = 'WP_SKIP_UPDATE_CHECK=1 wp audit absolute-path-policy --root .';
     const verifySecretsScript = 'bun scripts/check-no-dev-vars.ts';
     const secretQuarantineAuditScript = 'bun scripts/audit-secret-provider-quarantine.ts';
+    const lintScript = 'wp lint src e2e *.config.ts';
+    const typecheckScript = 'wp typecheck';
+    const testScript = 'wp test --file vitest.config.ts';
+    const mutationScript = 'wp test --mutation';
+    const testMutationScript = 'stryker run stryker.config.ts';
+    const e2eScript = 'wp e2e --config playwright.config.ts';
+    const qaScript = [
+        'wp lint src e2e *.config.ts',
+        'wp typecheck',
+        'wp test --file vitest.config.ts',
+        'wp test --mutation',
+        'wp e2e --config playwright.config.ts',
+    ].join(' && ');
     const devDeps = (pkg['devDependencies'] ?? {});
-    const hasAgentKitDevDep = typeof devDeps['webpresso'] === 'string';
-    const shouldSkipSelfInstall = packageName === 'webpresso';
+    const hasAgentKitDevDep = typeof devDeps['@webpresso/agent-kit'] === 'string';
+    const hasLegacyAgentKitDevDep = typeof devDeps['webpresso'] === 'string';
+    const shouldSkipSelfInstall = packageName === '@webpresso/agent-kit' || packageName === 'webpresso';
     const shouldManageAgentKitAsGlobal = globalInstall && !shouldSkipSelfInstall;
+    const requiredAuthoringDeps = {
+        '@playwright/test': 'latest',
+        '@stryker-mutator/core': 'latest',
+        '@stryker-mutator/vitest-runner': 'latest',
+        '@types/node': 'latest',
+        typescript: 'latest',
+        vitest: 'latest',
+    };
     if (alreadyHasEngines &&
         alreadyHasPm &&
-        (shouldSkipSelfInstall || shouldManageAgentKitAsGlobal || hasAgentKitDevDep) &&
+        (shouldSkipSelfInstall ||
+            shouldManageAgentKitAsGlobal ||
+            hasAgentKitDevDep ||
+            hasLegacyAgentKitDevDep) &&
+        Object.keys(requiredAuthoringDeps).every((name) => typeof devDeps[name] === 'string') &&
         (shouldSkipSelfInstall || hasSetupAgent) &&
         (shouldSkipSelfInstall || hasVerifyPaths) &&
         (shouldSkipSelfInstall || hasVerifySecrets) &&
         (shouldSkipSelfInstall || hasSecretQuarantineAudit) &&
-        (shouldSkipSelfInstall || hasPrepareScript)) {
+        (shouldSkipSelfInstall || hasPrepareScript) &&
+        hasLintScript &&
+        hasTypecheckScript &&
+        hasTestScript &&
+        hasMutationScript &&
+        hasTestMutationScript &&
+        hasE2eScript &&
+        hasQaScript) {
         return { targetPath: pkgPath, action: 'identical' };
     }
     pkg['engines'] = { ...existing, node: engines.node };
     if (!alreadyHasPm)
         pkg['packageManager'] = packageManager;
+    if (typeof pkg['type'] !== 'string')
+        pkg['type'] = 'module';
     // Ensure husky is in devDependencies so `vp exec husky init` works
     if (!devDeps['husky']) {
         devDeps['husky'] = '^9.0.0';
     }
-    if (!shouldSkipSelfInstall && !shouldManageAgentKitAsGlobal && !hasAgentKitDevDep) {
+    if (!shouldSkipSelfInstall &&
+        !shouldManageAgentKitAsGlobal &&
+        !hasAgentKitDevDep &&
+        !hasLegacyAgentKitDevDep) {
         // Keep consumers on the currently published dist-tag rather than a
         // repo-internal path. Do not wire this through `prepare`: `wp` is not
         // reliably on PATH during `vp install`, so `setup:agent` stays opt-in.
-        devDeps['webpresso'] = 'latest';
+        devDeps['@webpresso/agent-kit'] = 'latest';
+    }
+    for (const [name, version] of Object.entries(requiredAuthoringDeps)) {
+        if (!devDeps[name]) {
+            devDeps[name] = version;
+        }
     }
     pkg['devDependencies'] = devDeps;
     if (!shouldSkipSelfInstall && !hasSetupAgent) {
@@ -121,6 +208,27 @@ function mergePackageJson(repoRoot, options, globalInstall = false) {
     if (!shouldSkipSelfInstall && !hasPrepareScript) {
         scripts['prepare'] = 'husky';
     }
+    if (!hasLintScript) {
+        scripts['lint'] = lintScript;
+    }
+    if (!hasTypecheckScript) {
+        scripts['typecheck'] = typecheckScript;
+    }
+    if (!hasTestScript) {
+        scripts['test'] = testScript;
+    }
+    if (!hasMutationScript) {
+        scripts['mutation'] = mutationScript;
+    }
+    if (!hasTestMutationScript) {
+        scripts['test:mutation'] = testMutationScript;
+    }
+    if (!hasE2eScript) {
+        scripts['e2e'] = e2eScript;
+    }
+    if (!hasQaScript) {
+        scripts['qa'] = qaScript;
+    }
     if (Object.keys(scripts).length > 0) {
         pkg['scripts'] = scripts;
     }
@@ -161,6 +269,24 @@ export function scaffoldBaseKit(input) {
         writeFileSync(targetPath, content);
         results.push({ targetPath, action: 'created' });
     }
+    for (const [tmplRel, targetRel] of QUALITY_BOOTSTRAP_ONLY_MAP) {
+        const tmplPath = join(baseKitDir, tmplRel);
+        if (!existsSync(tmplPath))
+            continue;
+        const targetPath = join(repoRoot, targetRel);
+        if (existsSync(targetPath)) {
+            results.push({ targetPath, action: 'identical' });
+            continue;
+        }
+        const content = readFileSync(tmplPath, 'utf8');
+        if (options.dryRun) {
+            results.push({ targetPath, action: 'skipped-dry' });
+            continue;
+        }
+        mkdirSync(dirname(targetPath), { recursive: true });
+        writeFileSync(targetPath, content);
+        results.push({ targetPath, action: 'created' });
+    }
     // Make husky hook files executable
     if (!options.dryRun) {
         for (const [tmplRel, targetRel] of TEMPLATE_MAP) {
@@ -180,4 +306,13 @@ export function scaffoldBaseKit(input) {
     results.push(mergePackageJson(repoRoot, options, globalInstall));
     return results;
 }
+function readDependencyBucket(value) {
+    if (!value || typeof value !== 'object') {
+        return {};
+    }
+    return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[0] === 'string' && typeof entry[1] === 'string'));
+}
+function isNpmInitPlaceholderTestScript(value) {
+    return /^echo ['"]?Error: no test specified['"]? && exit 1$/u.test(value.trim());
+}
 //# sourceMappingURL=scaffold-base-kit.js.map

package/dist/esm/cli/commands/typecheck.js

@@ -1,3 +1,4 @@
+import { getManagedRunner } from '#tool-runtime';
 import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -17,14 +18,19 @@ export function registerTypecheckCommand(cli) {
 export function buildTypecheckCommand(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     if (hasCheckTypesScript(cwd)) {
+        const resolution = getManagedRunner('vp');
         return {
-            command: 'vp',
-            args: ['run', 'check-types'],
+            command: resolution.command,
+            args: [...resolution.args, 'run', 'check-types'],
         };
     }
+    const resolution = getManagedRunner('tsc', {
+        fallbackCommand: 'tsc',
+        fallbackArgs: [],
+    });
     return {
-        command: 'tsc',
-        args: ['--noEmit', ...(options.pretty ? [] : ['--pretty', 'false'])],
+        command: resolution.command,
+        args: [...resolution.args, '--noEmit', ...(options.pretty ? [] : ['--pretty', 'false'])],
     };
 }
 export function runTypecheckCommand(options = {}, deps = {}) {

package/dist/esm/e2e/command-builder.js

@@ -1,3 +1,4 @@
+import { getManagedRunner } from '#tool-runtime';
 import path from 'node:path';
 export function buildE2eCommand(options) {
     switch (options.step.runner) {
@@ -15,10 +16,11 @@ function buildPlaywrightCommand(options) {
         throw new Error(`Step ${step.logName} uses runner "playwright" but does not define configPath.`);
     }
     const { baseDir, configArg, files } = resolveRunnerPaths(step.configPath, options.files ?? []);
-    const args = [...buildPnpmExecPrefix(baseDir), 'playwright', 'test', '--config', configArg];
+    const resolution = withBaseDir(getManagedRunner('playwright', { filterOutput: options.filterOutput }), baseDir);
+    const args = [...resolution.args, 'test', '--config', configArg];
     appendPlaywrightFlags(args, options);
     args.push(...(step.fixedArgs ?? []), ...files, ...(options.passthrough ?? []));
-    return { command: 'pnpm', args };
+    return { command: resolution.command, args };
 }
 function buildVitestE2eCommand(options) {
     const { step } = options;
@@ -26,12 +28,13 @@ function buildVitestE2eCommand(options) {
         throw new Error(`Step ${step.logName} uses runner "vitest" but does not define configPath.`);
     }
     const { baseDir, configArg, files } = resolveRunnerPaths(step.configPath, options.files ?? []);
-    const args = [...buildPnpmExecPrefix(baseDir), 'vitest', 'run', '--config', configArg];
+    const resolution = withBaseDir(getManagedRunner('vitest', { filterOutput: options.filterOutput }), baseDir);
+    const args = [...resolution.args, 'run', '--config', configArg];
     if (options.workers !== undefined) {
         args.push('--poolOptions.threads.maxThreads', String(options.workers));
     }
     args.push(...(step.fixedArgs ?? []), ...files, ...(options.passthrough ?? []));
-    return { command: 'pnpm', args };
+    return { command: resolution.command, args };
 }
 function buildCustomCommand(options) {
     const { step } = options;
@@ -69,9 +72,6 @@ function appendPlaywrightFlags(args, options) {
         args.push('--test-list', options.testList);
     }
 }
-function buildPnpmExecPrefix(baseDir) {
-    return baseDir === '.' ? ['exec'] : ['--dir', baseDir, 'exec'];
-}
 function resolveRunnerPaths(configPath, files) {
     const normalizedConfigPath = configPath.replace(/\\/gu, '/');
     const baseDir = path.posix.dirname(normalizedConfigPath);
@@ -95,4 +95,23 @@ function resolveRunnerPaths(configPath, files) {
         }),
     };
 }
+function withBaseDir(resolution, baseDir) {
+    if (baseDir === '.') {
+        return { command: resolution.command, args: [...resolution.args] };
+    }
+    if (resolution.command === 'vp') {
+        return {
+            command: resolution.command,
+            args: ['--dir', baseDir, ...resolution.args],
+        };
+    }
+    const [wrappedCommand, ...wrappedArgs] = resolution.args;
+    if (resolution.command === 'rtk' && wrappedCommand === 'vp') {
+        return {
+            command: resolution.command,
+            args: ['vp', '--dir', baseDir, ...wrappedArgs],
+        };
+    }
+    return { command: resolution.command, args: [...resolution.args] };
+}
 //# sourceMappingURL=command-builder.js.map

package/dist/esm/e2e/execution.js

@@ -18,6 +18,7 @@ export async function createE2eExecutionPlan(input, cwd = process.cwd()) {
             workers: input.workers,
             testList: input.testList,
             passthrough: input.passthrough,
+            filterOutput: input.filterOutput,
         });
     }
     const hostAdapter = await loadConfiguredHostAdapter(cwd);
@@ -35,6 +36,7 @@ export async function createE2eExecutionPlan(input, cwd = process.cwd()) {
             workers: input.workers,
             testList: input.testList,
             passthrough: input.passthrough,
+            filterOutput: input.filterOutput,
         });
     }
     if (hostAdapter.adapter.buildExecutionPlan) {
@@ -49,6 +51,7 @@ export async function createE2eExecutionPlan(input, cwd = process.cwd()) {
             workers: input.workers,
             testList: input.testList,
             passthrough: input.passthrough,
+            filterOutput: input.filterOutput,
         });
     }
     return planE2eRun({
@@ -60,6 +63,7 @@ export async function createE2eExecutionPlan(input, cwd = process.cwd()) {
         workers: input.workers,
         testList: input.testList,
         passthrough: input.passthrough,
+        filterOutput: input.filterOutput,
     });
 }
 export function plannedGroupsToCommandConfigs(groups) {

package/dist/esm/e2e/run-planner.js

@@ -76,6 +76,7 @@ function planE2eRunsFromSuites(options) {
                 workers: options.request.workers,
                 testList: options.request.testList,
                 passthrough: options.request.passthrough,
+                filterOutput: options.request.filterOutput,
             });
             runs.push({
                 suiteId: suite.id,

package/dist/esm/e2e/types.d.ts

@@ -48,6 +48,7 @@ export interface E2eCommandRequest {
     workers?: number | string;
     testList?: string;
     passthrough?: readonly string[];
+    filterOutput?: boolean;
 }
 export interface E2eExecutionRequest extends E2eCommandRequest {
     suite?: string;

package/dist/esm/format/index.js

@@ -8,6 +8,7 @@
  */
 import { isMissingBinary, isRunFailure, runCommand } from '#mcp/tools/_shared/run-command';
 import { resolveProjectRoot } from '#mcp/tools/_shared/project-root';
+import { getManagedRunner } from '#tool-runtime';
 const DEFAULT_FORMAT_TIMEOUT_MS = 5 * 60 * 1_000;
 /**
  * Run formatter and return a structured result. Throws a clear error when
@@ -33,7 +34,12 @@ export async function runFormat(options = {}) {
     args.push('--ignore-path', '.gitignore');
     if (options.files && options.files.length > 0)
         args.push(...options.files);
-    const outcome = await runCommand('oxfmt', args, runOptions);
+    const resolution = getManagedRunner('oxfmt', {
+        fallbackCommand: 'oxfmt',
+        fallbackArgs: [],
+        filterOutput: false,
+    });
+    const outcome = await runCommand(resolution.command, [...resolution.args, ...args], runOptions);
     if (isRunFailure(outcome)) {
         if (isMissingBinary(outcome)) {
             throw new Error("oxfmt binary not found on PATH. Install it as a devDependency: 'vp install -D oxfmt'");

package/dist/esm/lint/index.js

@@ -8,6 +8,7 @@
  */
 import { isRunFailure, runCommand } from '#mcp/tools/_shared/run-command';
 import { resolveProjectRoot } from '#mcp/tools/_shared/project-root';
+import { getManagedRunner } from '#tool-runtime';
 const DEFAULT_LINT_TIMEOUT_MS = 5 * 60 * 1_000;
 /**
  * Parse oxlint's `--format=json` output (ESLint-compatible array shape) into
@@ -92,7 +93,8 @@ export async function runLint(options = {}) {
     else {
         lintArgs.push('.');
     }
-    const vpOutcome = await runCommand('vp', lintArgs, runOptions);
+    const resolution = getManagedRunner('vp', { filterOutput: false });
+    const vpOutcome = await runCommand(resolution.command, [...resolution.args, ...lintArgs], runOptions);
     if (isRunFailure(vpOutcome)) {
         return {
             passed: false,