@vizzly-testing/cli 0.39.0 → 0.39.1

package/README.md

@@ -168,9 +168,9 @@ Install the Vizzly skill and a short `AGENTS.md` note:
 pnpm exec vizzly init --agent-guidance
 ```
 
-This adds `.agents/skills/vizzly` and a note in `AGENTS.md`, keeping other
-guidance. Use `--agent-skill` to install only the skill during setup.
-These flags don't open the wizard or update an existing Vizzly setup.
+This adds `.agents/skills/vizzly` and a note in `AGENTS.md`, keeping your
+other instructions. Use `--agent-skill` for just the skill. Run either command
+again to refresh it without changing your config.
 `--skip-agent-skill` skips agent setup unless you also request `--agent-guidance`.
 
 Use `context` to read local results. For cloud results, check the API schema
@@ -301,6 +301,7 @@ See their setup guides above for details.
 ## More
 
 [Full docs](https://docs.vizzly.dev) ·
+[Updating Vizzly](docs/updates.md) ·
 [Report a bug or suggest a change](https://github.com/vizzly-testing/cli/issues)
 
 PRs welcome. MIT licensed.

package/dist/cli.js

@@ -29,12 +29,14 @@ import { createPluginServices } from './plugin-api.js';
 import { loadPlugins } from './plugin-loader.js';
 import { createServices } from './services/index.js';
 import { withTimeout } from './utils/async-utils.js';
+import { runUpdatedCli } from './utils/cli-update.js';
 import { colors } from './utils/colors.js';
 import { loadConfig } from './utils/config-loader.js';
 import { getContext } from './utils/context.js';
 import { saveUserPath } from './utils/global-config.js';
 import * as output from './utils/output.js';
 import { getPackageVersion } from './utils/package-info.js';
+import { notifyUpdates } from './utils/update-notifications.js';
 
 // Custom help formatting with BearDen design system
 const formatHelp = (cmd, helper) => {
@@ -393,7 +395,7 @@ function writeCommanderError(text) {
     }
   }
 }
-program.name('vizzly').description('Vizzly CLI for visual regression testing').version(getPackageVersion()).option('-c, --config <path>', 'Config file path').option('--token <token>', 'Vizzly API token').option('-v, --verbose', 'Verbose output (shorthand for --log-level debug)').option('--log-level <level>', 'Log level: debug, info, warn, error (default: info, or VIZZLY_LOG_LEVEL env var)').option('--json [fields]', 'JSON output, optionally specify fields (e.g., --json id,status,branch)').option('--color', 'Force colored output (even in non-TTY)').option('--no-color', 'Disable colored output').option('--strict', 'Fail on any error (default: be resilient, warn on non-critical issues)').configureHelp({
+program.name('vizzly').description('Vizzly CLI for visual regression testing').version(getPackageVersion()).option('-c, --config <path>', 'Config file path').option('--token <token>', 'Vizzly API token').option('-v, --verbose', 'Verbose output (shorthand for --log-level debug)').option('--log-level <level>', 'Log level: debug, info, warn, error (default: info, or VIZZLY_LOG_LEVEL env var)').option('--json [fields]', 'JSON output, optionally specify fields (e.g., --json id,status,branch)').option('--color', 'Force colored output (even in non-TTY)').option('--no-color', 'Disable colored output').option('--no-update-notifier', 'Skip update checks and notices').option('--strict', 'Fail on any error (default: be resilient, warn on non-critical issues)').configureHelp({
   formatHelp
 });
 program.configureOutput({
@@ -402,6 +404,13 @@ program.configureOutput({
 program.showHelpAfterError('(Run vizzly --help for available commands)');
 program.showSuggestionAfterError();
 program.exitOverride();
+program.hook('preAction', async (_command, actionCommand) => {
+  if (actionCommand.name() === 'init') return;
+  let updatedCli = await notifyUpdates(actionCommand.optsWithGlobals());
+  if (!updatedCli) return;
+  let code = await runUpdatedCli(updatedCli, process.argv.slice(2), process.cwd());
+  process.exit(code);
+});
 
 // Load plugins before defining commands
 // We need to manually parse to get the config option early
@@ -456,7 +465,7 @@ if (needsRuntimeBootstrap) {
     output.debug(`Plugin loading failed: ${error.message}`);
   }
 }
-program.command('init').description('Initialize Vizzly in your project').option('--quick', 'Create an editable config without the setup wizard').option('--force', 'Overwrite existing configuration').option('--agent-skill', 'Install the Vizzly agent skill during setup').option('--agent-guidance', 'Install the Vizzly skill and AGENTS.md guidance during setup').option('--skip-agent-skill', 'Skip the Vizzly agent skill prompt').action(async options => {
+program.command('init').description('Initialize Vizzly in your project').option('--quick', 'Create an editable config without the setup wizard').option('--force', 'Overwrite existing configuration').option('--agent-skill', 'Install or refresh the Vizzly agent skill').option('--agent-guidance', 'Install or refresh the Vizzly skill and AGENTS.md guidance').option('--skip-agent-skill', 'Skip the Vizzly agent skill prompt').action(async options => {
   let globalOptions = getGlobalOptions();
   try {
     let result = await init({

package/dist/commands/init.js

@@ -119,9 +119,7 @@ export async function init(options = {}) {
   let prompts;
   try {
     if (initialized) {
-      plan = {
-        changes: []
-      };
+      plan = await planAgentSetup(cwd, agentOptions(options));
     } else if (quick) {
       let configChange = planConfig(config);
       let agents = await planAgentSetup(cwd, agentOptions(options));

package/dist/init/agents.js

@@ -1,11 +1,20 @@
+import { createHash } from 'node:crypto';
 import { readdir } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { readOptionalFile } from '../utils/config-discovery.js';
 import { fileChange } from '../utils/file-changes.js';
+import { getPackageVersion } from '../utils/package-info.js';
 let sourcePath = fileURLToPath(new URL('../../skills/vizzly/', import.meta.url));
 let start = '<!-- vizzly-agent-guidance -->';
 let end = '<!-- /vizzly-agent-guidance -->';
+export function agentGuidancePath(cwd) {
+  return path.join(cwd, '.vizzly', 'agent-guidance.json');
+}
+export async function agentGuidanceFlag(cwd) {
+  let agents = await readOptionalFile(path.join(cwd, 'AGENTS.md'));
+  return agents?.includes(start) ? '--agent-guidance' : '--agent-skill';
+}
 function guidanceContent() {
   return `${start}
 ## Visual testing with Vizzly
@@ -35,14 +44,18 @@ function addGuidance(source) {
     throw new Error('Repair the incomplete or duplicate Vizzly guidance markers in AGENTS.md before running init.');
   }
   let block = guidanceContent();
-  if (starts) return content;
+  if (starts) {
+    return content.slice(0, begin) + block.trimEnd() + content.slice(finish + end.length);
+  }
   return content.trim() ? `${content.trimEnd()}\n\n${block}` : block;
 }
 async function skillFiles(directory, prefix = '') {
   let files = [];
-  for (let entry of await readdir(directory, {
+  let entries = await readdir(directory, {
     withFileTypes: true
-  })) {
+  });
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+  for (let entry of entries) {
     let relative = path.join(prefix, entry.name);
     if (entry.isDirectory()) {
       files.push(...(await skillFiles(path.join(directory, entry.name), relative)));
@@ -52,6 +65,23 @@ async function skillFiles(directory, prefix = '') {
   }
   return files;
 }
+export async function bundledAgentSkill() {
+  let files = [];
+  let hash = createHash('sha256');
+  for (let filename of await skillFiles(sourcePath)) {
+    let content = await readOptionalFile(path.join(sourcePath, filename));
+    files.push({
+      filename,
+      content
+    });
+    hash.update(JSON.stringify([filename.split(path.sep).join('/'), content]));
+  }
+  hash.update(guidanceContent());
+  return {
+    files,
+    version: hash.digest('hex')
+  };
+}
 export async function planAgentSetup(cwd, {
   skill,
   guidance
@@ -61,17 +91,23 @@ export async function planAgentSetup(cwd, {
   };
   let targetPath = path.join(cwd, '.agents', 'skills', 'vizzly');
   let existing = await readOptionalFile(path.join(targetPath, 'SKILL.md'));
-  let changes = [];
-  if (!existing) {
-    for (let filename of await skillFiles(sourcePath)) {
-      changes.push(await fileChange(path.join(targetPath, filename), await readOptionalFile(path.join(sourcePath, filename))));
-    }
+  let skillChanges = [];
+  let bundled = await bundledAgentSkill();
+  for (let {
+    filename,
+    content
+  } of bundled.files) {
+    skillChanges.push(await fileChange(path.join(targetPath, filename), content));
   }
+  let skillStatus = 'installed';
+  if (existing) skillStatus = skillChanges.some(Boolean) ? 'updated' : 'exists';
   let agentSkill = {
-    status: existing ? 'exists' : 'installed',
+    status: skillStatus,
     sourcePath,
-    targetPath
+    targetPath,
+    version: bundled.version
   };
+  let changes = [...skillChanges];
   let agentGuidance;
   if (guidance) {
     let agentsPath = path.join(cwd, 'AGENTS.md');
@@ -91,6 +127,11 @@ export async function planAgentSetup(cwd, {
       agentsPath
     };
   }
+  let installedGuidance = {
+    version: bundled.version,
+    cliVersion: getPackageVersion()
+  };
+  changes.push(await fileChange(agentGuidancePath(cwd), `${JSON.stringify(installedGuidance, null, 2)}\n`));
   return {
     changes: changes.filter(Boolean),
     agentSkill,