@zibby/cli 0.1.5

package/bin/zibby.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+
+// Suppress dotenv promotional messages
+process.env.DOTENV_CONFIG_QUIET = 'true';
+
+import '@zibby/skills';
+import { Command } from 'commander';
+import { initCommand } from '../src/commands/init.js';
+import { runCommand } from '../src/commands/run.js';
+import { videoCommand } from '../src/commands/video.js';
+import { uploadCommand } from '../src/commands/upload.js';
+import { ciSetupCommand } from '../src/commands/ci-setup.js';
+// implement and analyze are lazy-loaded (they pull in @aws-sdk/client-s3 which isn't needed for local commands)
+import { setupPlaywrightMcpCommand, setupCiCommand, testWithVideoCommand } from '../src/commands/setup-scripts.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+
+const program = new Command();
+
+program
+  .name('zibby')
+  .description('Zibby Test Automation - AI-powered test generation')
+  .version(packageJson.version);
+
+program
+  .command('init')
+  .description('Initialize a new Zibby test project (like rails new)')
+  .argument('[project-name]', 'Project name (optional, uses current directory if not provided)')
+  .option('--agent <type>', 'Agent to use (claude, cursor)')
+  .option('--skip-install', 'Skip npm install')
+  .option('-f, --force', 'Force reinitialize (overwrite existing config)')
+  .option('--headed', 'Run MCP browser in headed mode (visible browser)')
+  .option('--headless', 'Run MCP browser in headless mode (hidden browser)')
+  .option('--api-key <key>', 'Zibby API key for cloud sync')
+  .option('--cloud-sync', 'Enable cloud sync and install Zibby MCP')
+  .option('-m, --mem', 'Enable test memory (initializes Dolt DB, adds ZIBBY_MEMORY to .env)')
+  .action(initCommand);
+
+program
+  .command('run')
+  .description('Run a test specification')
+  .argument('[spec-path]', 'Path to test spec file (e.g., test-specs/auth/login.txt)')
+  .option('--sources <ids>', 'Comma-separated test case IDs to fetch from cloud')
+  .option('--execution <id>', 'Execution ID containing the test cases (required with --sources)')
+  .option('--agent <type>', 'Agent to use (claude, cursor) - overrides config')
+  .option('--workflow <name>', 'Workflow to use (e.g., QuickSmokeWorkflow, quick-smoke)')
+  .option('--headless', 'Run browser in headless mode')
+  .option('--node <name>', 'Run only a specific node (e.g., execute_live, generate_script)')
+  .option('--session <id>', 'Use existing session (e.g., 1768974629717 or "last") - requires --node')
+  .option('--project <id>', 'Project ID (optional, auto-detected from ZIBBY_API_KEY)')
+  .option('--collection <id-or-name>', 'Collection ID or name (creates new if name doesn\'t exist)')
+  .option('--folder <path>', 'Folder path within collection (optional, requires --collection)')
+  .option('--sync', 'Force upload to cloud (overrides cloudSync: false)')
+  .option('--no-sync', 'Skip upload to cloud (overrides cloudSync: true)')
+  .option('--config <path>', 'Path to config file', '.zibby.config.js')
+  .option('--auto-approve', 'Auto-approve MCP tools (for CI/CD)')
+  .option('-o, --open', 'Open test results in browser after completion')
+  .option('--verbose', 'Show info level logs')
+  .option('--debug', 'Show debug level logs (most verbose)')
+  .option('-m, --mem', 'Enable test memory (Dolt-backed knowledge from previous runs)')
+  .action((specPath, options) => {
+    if (options.debug) {
+      process.env.ZIBBY_DEBUG = 'true';
+    } else if (options.verbose) {
+      process.env.ZIBBY_VERBOSE = 'true';
+    }
+    if (options.mem) {
+      process.env.ZIBBY_MEMORY = '1';
+      process.env.ZIBBY_EXTRA_SKILLS = process.env.ZIBBY_EXTRA_SKILLS
+        ? `${process.env.ZIBBY_EXTRA_SKILLS},memory`
+        : 'memory';
+    }
+    return runCommand(specPath, options);
+  });
+
+program
+  .command('implement')
+  .description('Implement a Jira ticket using AI agent (runs in ECS container)')
+  .action(async (...args) => {
+    const { implementCommand } = await import('../src/commands/implement.js');
+    return implementCommand(...args);
+  });
+
+program
+  .command('analyze')
+  .description('Analyze a Jira ticket against the codebase (runs in ECS container)')
+  .option('--workflow <path>', 'Path to a local workflow JSON file (e.g., .zibby/workflow-analysis.json)')
+  .action(async (...args) => {
+    const { analyzeCommand } = await import('../src/commands/analyze-graph.js');
+    return analyzeCommand(...args);
+  });
+
+program
+  .command('video')
+  .description('Organize test videos next to test files')
+  .action(videoCommand);
+
+program
+  .command('upload <spec-path>')
+  .description('Upload existing test artifacts to Zibby Cloud')
+  .option('--project <id>', 'Project ID (REQUIRED - use flag or ZIBBY_PROJECT_ID env)')
+  .option('--collection <id-or-name>', 'Collection ID or name (creates new if name doesn\'t exist)')
+  .option('--folder <path>', 'Folder path within collection (optional)')
+  .option('--agent <type>', 'Agent used (for metadata)')
+  .action(uploadCommand);
+
+program
+  .command('login')
+  .description('Log in to Zibby (opens browser for authentication)')
+  .action(async () => {
+    const { loginCli } = await import('../src/auth/cli-login.js');
+    await loginCli();
+    process.exit(0);
+  });
+
+program
+  .command('logout')
+  .description('Log out from Zibby (clears saved session)')
+  .action(async () => {
+    const { logoutCli } = await import('../src/auth/cli-login.js');
+    logoutCli();
+    process.exit(0);
+  });
+
+program
+  .command('status')
+  .description('Show current authentication status and token details')
+  .option('--json', 'Output in JSON format (for scripts)')
+  .action(async (options) => {
+    const { showLoginStatus } = await import('../src/auth/cli-login.js');
+    await showLoginStatus(options);
+    process.exit(0);
+  });
+
+program
+  .command('list')
+  .description('List your projects and API tokens')
+  .action(async () => {
+    const { listProjectsCommand } = await import('../src/commands/list-projects.js');
+    await listProjectsCommand();
+  });
+
+program
+  .command('ci-setup')
+  .description('Setup Cursor Agent for CI/CD (patch and configure)')
+  .option('--get-keys', 'Get MCP approval keys')
+  .option('--save', 'Save approval keys to project')
+  .action(ciSetupCommand);
+
+program
+  .command('setup-playwright')
+  .description('Setup official Playwright MCP (from cursor-agent-package)')
+  .option('--headed', 'Configure MCP in headed mode (visible browser)')
+  .option('--viewport-width <width>', 'Viewport width (default: 1280)', '1280')
+  .option('--viewport-height <height>', 'Viewport height (default: 720)', '720')
+  .action((options) => {
+    const viewport = {
+      width: parseInt(options.viewportWidth, 10) || 1280,
+      height: parseInt(options.viewportHeight, 10) || 720
+    };
+    return setupPlaywrightMcpCommand({ ...options, viewport });
+  });
+
+program
+  .command('setup-ci-full')
+  .description('Complete CI/CD setup from scratch')
+  .action(setupCiCommand);
+
+program
+  .command('test-video')
+  .description('Run Playwright tests with video recording')
+  .argument('[test-file]', 'Test file to run (default: tests/)')
+  .option('--headed', 'Run in headed mode (visible browser)')
+  .action(testWithVideoCommand);
+
+// ============================================
+// MEMORY COMMANDS (test knowledge database)
+// ============================================
+const memory = program
+  .command('memory')
+  .description('Test memory database — version-controlled knowledge from runs');
+
+memory
+  .command('stats')
+  .description('Show memory database statistics')
+  .action(async () => {
+    const { memoryStatsCommand } = await import('../src/commands/memory.js');
+    return memoryStatsCommand();
+  });
+
+memory
+  .command('init')
+  .description('Initialize the memory database (Dolt)')
+  .action(async () => {
+    const { memoryInitCommand } = await import('../src/commands/memory.js');
+    return memoryInitCommand();
+  });
+
+memory
+  .command('compact')
+  .description('Prune old data and run Dolt GC to reclaim storage')
+  .option('--max-runs <n>', 'Keep last N runs per spec (default: 50)', parseInt)
+  .option('--max-age <days>', 'Remove data older than N days (default: 90)', parseInt)
+  .action(async (options) => {
+    const { memoryCompactCommand } = await import('../src/commands/memory.js');
+    return memoryCompactCommand(options);
+  });
+
+memory
+  .command('reset')
+  .description('Wipe the memory database')
+  .option('-f, --force', 'Confirm reset')
+  .action(async (options) => {
+    const { memoryResetCommand } = await import('../src/commands/memory.js');
+    return memoryResetCommand(options);
+  });
+
+// ============================================
+// WORKFLOW COMMANDS (download / upload / list)
+// ============================================
+const workflow = program
+  .command('workflow')
+  .description('Manage workflow graphs (download, upload, list)');
+
+workflow
+  .command('download')
+  .description('Download a workflow graph from Zibby Cloud to .zibby/')
+  .option('--project <id>', 'Project ID (or ZIBBY_PROJECT_ID env)')
+  .option('--type <type>', 'Workflow type: analysis, implementation, run_test')
+  .option('--api-key <key>', 'API key (or ZIBBY_API_KEY env)')
+  .option('--output <dir>', 'Output directory (default: .zibby/)')
+  .option('--include-default', 'Download the built-in default graph if no custom one exists')
+  .action(async (options) => {
+    const { workflowDownloadCommand } = await import('../src/commands/workflow.js');
+    return workflowDownloadCommand(options);
+  });
+
+workflow
+  .command('upload')
+  .description('Upload a local workflow graph to Zibby Cloud (validates before upload)')
+  .option('--project <id>', 'Project ID (or ZIBBY_PROJECT_ID env)')
+  .option('--type <type>', 'Workflow type: analysis, implementation, run_test')
+  .option('--api-key <key>', 'API key (or ZIBBY_API_KEY env)')
+  .option('--file <path>', 'Path to workflow JSON (default: .zibby/workflow-<type>.json)')
+  .action(async (options) => {
+    const { workflowUploadCommand } = await import('../src/commands/workflow.js');
+    return workflowUploadCommand(options);
+  });
+
+workflow
+  .command('list')
+  .description('List all workflows for a project')
+  .option('--project <id>', 'Project ID (or ZIBBY_PROJECT_ID env)')
+  .option('--api-key <key>', 'API key (or ZIBBY_API_KEY env)')
+  .action(async (options) => {
+    const { workflowListCommand } = await import('../src/commands/workflow.js');
+    return workflowListCommand(options);
+  });
+
+program.parse();
+

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@zibby/cli",
+  "version": "0.1.5",
+  "description": "Zibby CLI - Test automation generator and runner",
+  "type": "module",
+  "bin": {
+    "zibby": "./bin/zibby.js"
+  },
+  "scripts": {
+    "test": "vitest run test/auth*.test.js test/two-layer-auth.test.js",
+    "test:unit": "vitest run src/",
+    "test:auth": "vitest run test/auth*.test.js test/two-layer-auth.test.js",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix ."
+  },
+  "keywords": [
+    "testing",
+    "automation",
+    "e2e",
+    "playwright",
+    "ai"
+  ],
+  "author": "Zibby",
+  "license": "MIT",
+  "homepage": "https://zibby.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZibbyHQ/zibby-agent"
+  },
+  "bugs": {
+    "url": "https://github.com/ZibbyHQ/zibby-agent/issues"
+  },
+  "dependencies": {
+    "@aws-sdk/client-sqs": "^3.1000.0",
+    "@zibby/skills": "*",
+    "@zibby/core": "^0.1.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "dotenv": "^17.2.3",
+    "glob": "^10.3.10",
+    "handlebars": "^4.7.8",
+    "inquirer": "^13.3.0",
+    "node-fetch": "^3.3.2",
+    "open": "^10.2.0",
+    "ora": "^8.0.1"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "!src/**/__tests__/",
+    "!src/**/*.test.js",
+    "!src/**/*.spec.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "@zibby/memory": "*"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
+  }
+}