Skip to content
CAI
Software that uses CAICheck a score

VeryGoodOpenSource/very_good_cli

64.2

Adequate · 13 November 2026

7.5k

lines of production code

Dart

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add CLI entry point script

The repository now includes a \bin/very\_good.dart\ script that serves as the executable entry point for the CLI. This script initializes and runs the \VeryGoodCommandRunner\ with provided arguments, ensuring standard output and error streams are flushed before the process exits.

bin · high confidence

Add Dart CLI template and bundle exports

The \very\_good\_dart\_cli\ template location now exposes the Dart CLI template and its associated bundle via new entry-point files (\very\_good\_dart\_cli.dart\, \very\_good\_dart\_cli\_bundle.dart\). This makes the Dart CLI template available for generation by the \very\_good create\ command.

_lib/src/commands/create/templates/very\_good\_dart\cli · high confidence

Add Very Good Flame Game template

Users can now generate a new project using the Very Good Flame Game template. This change introduces the template definition and its associated bundle, making it available via the \very\_good create\ command.

_lib/src/commands/create/templates/very\_good\_flame\game · high confidence

Add Very Good documentation site template

Users can now generate a new project scaffolded with a Docusaurus-based documentation site using the \very\_good create\ command. This new template includes a pre-configured Node.js environment (requiring Node 22.20.0+), standard GitHub issue and pull request templates, a CI workflow for linting and building, and a ready-to-use React/TypeScript site structure with dark mode support and custom theming.

_lib/src/commands/create/templates/very\_good\_docs\site · high confidence

Add \`very\_good update\` command for CLI self-updates

Users can now run \very\_good update\ to check for and install the latest version of the Very Good CLI. This new command uses the pub\_updater package to detect the most recent release and applies the update, providing progress feedback and error handling if the update fails or if the CLI is already up to date.

lib/src/commands · high confidence

Add library entry-point for Very Good CLI

A new \lib/very\_good\_cli.dart\ file has been added to the library, declaring the \library\ directive and including documentation that guides users on how to activate and use the CLI via \dart pub global\. This establishes the primary entry point for the Dart library.

lib · high confidence

Add new landing page with dark mode support and blog highlights

The site now features a new homepage (\index.tsx\) that includes a hero section with a logo that switches between light and dark variants based on the user's theme, a section highlighting core features like scalable templates and utility commands, and a dedicated area showcasing recent blog posts about the Flame game template and Dart CLI generation. The accompanying styles (\index.module.css\) ensure the layout is responsive and visually consistent across themes.

site/src/pages · high confidence

Add very\_good\_app\_ui command and template bundle

Users can now generate a new app UI using the \very\_good create app\_ui\ command. This change introduces the command implementation and exports the associated template bundle, enabling the creation of a standardized UI structure for new projects.

_lib/src/commands/create/templates/very\_good\_app\ui · high confidence

Added SPDX license hook to download and process license data

The \tool/spdx\_license/hooks\ directory now contains the implementation for a pre-generation hook that populates license variables for code generation. The \pre\_gen.dart\ script downloads the official SPDX license list from GitHub (mirroring the source used by PANA), parses the JSON details, and converts license names into valid Dart identifiers. It supports both fetching the default list and using a user-provided list via context variables. The hook includes configuration files (\analysis\_options.yaml\ using \very\_good\_analysis\, and \dart\_test.yaml\ for PR-only test tags) and a comprehensive test suite (\pre\_gen\_test.dart\) verifying download, parsing, identifier conversion, and error handling behaviors.

_tool/spdx\license/hooks · high confidence

Added generated SPDX license enumeration

The library now includes a generated Dart enum, SpdxLicense, containing 741 standard SPDX license identifiers. This addition provides a centralized, type-safe list of licenses for use within the pub license module, automatically sourced from the SPDX License brick.

_lib/src/pub\license · high confidence

Added pubspec.lock parser for license checking

Introduced a new \PubspecLock\ parser in the \lib/src/pubspec\_lock\ library to read and structure dependency information from \pubspec.lock\ files. This component is specifically designed to support the \packages check license\ command by extracting package names, dependency types, and source details (such as whether a package is hosted on pub.dev), enabling more accurate license analysis for project dependencies.

_lib/src/pubspec\lock · high confidence

Initial release of Very Good CLI v1.5.0

This change introduces the initial public release of the Very Good CLI (version 1.5.0). It establishes the core command-line interface structure, including a custom command runner that manages subcommands for creating projects, managing packages, running tests, and handling updates. The CLI now features automatic update checks, a thank-you message for new users, verbose logging support, and terminal-aware text wrapping for better display in various environments.

lib/src · high confidence

Initial release of the Very Good CLI documentation site

The documentation site is now available at cli.vgv.dev, built with Docusaurus 3. This release includes the core site configuration, navigation structure, and styling, along with support for dark mode and syntax highlighting for Bash, Dart, and YAML. The site is configured for deployment to GitHub Pages and includes standard development tooling such as ESLint, Prettier, and TypeScript support.

site · high confidence

Initial repository structure and documentation

The repository has been initialized with the foundational structure for the Very Good CLI project. This includes the MIT license, a code of conduct, and a detailed contributing guide. The README has been expanded to provide a comprehensive quick start, installation instructions, and documentation for all available commands (create, test, packages, mcp). Additionally, an AGENTS.md file has been added to provide architectural context and conventions for AI coding assistants, alongside standard configuration files like .gitignore, analysis\_options.yaml, and release-please configuration.

(repo-wide) · high confidence

Introduce MCP server with structured error handling and serialization

The \very\_good mcp\ command now starts a Model Context Protocol server that exposes CLI tools (such as \create\ and \test\) to AI agents. This implementation introduces a \Lock\ to serialize concurrent tool executions, preventing working-directory conflicts, and adds \StructuredToolError\ to return classified, machine-readable failure responses (e.g., validation, permission, transient, business) with recovery suggestions, improving agent coordination and error handling.

lib/src/mcp · high confidence

Introduce \`very\_good dart test\` command with comprehensive test execution options

Users can now run Dart tests directly via the \very\_good dart test\ command. This new command supports a wide range of options including coverage collection (\--coverage\, \--min-coverage\, \--show-uncovered\, \--collect-coverage-from\), test filtering (\--tags\, \--exclude-tags\, \--exclude-coverage\), execution control (\--concurrency\, \--fail-fast\, \--platform\, \--randomize-ordering-seed\), and reporting (\--report-on\, \--file-reporter\). It also integrates with the project configuration (\very\_good.yaml\) for default values and supports CI sharding (\--shard-index\, \--total-shards\).

lib/src/commands/dart · high confidence

Introduce \`very\_good packages check licenses\` command

Users can now run \very\_good packages check licenses\ to detect and validate package licenses locally using PANA's detection algorithm. The command supports filtering by dependency type (main, dev, transitive, direct-overridden), enforcing allowed or forbidden license lists, skipping specific packages, and ignoring retrieval failures. It also provides options to output results in text or CSV formats and respects configuration defined in \very\_good.yaml\.

lib/src/commands/packages/commands/check · high confidence

Introduce test optimizer brick with sharding and metadata preservation

The test optimizer brick is now available in the hooks directory, providing a pre-generation hook that scans test files and bundles them for optimized execution. This change introduces support for sharding tests across CI runners by distributing files in a deterministic round-robin fashion, ensuring reproducible partitions. It also preserves library-level test annotations (such as @Tags, @Timeout, and @Skip) in the optimized bundle, while safely dropping annotations that reference unresolved names to prevent bundle failures. A new Dart identifier generator ensures generated identifiers are valid Dart names, and the hook respects a 'skip\_very\_good\_optimization' tag to exclude specific files from optimization.

_bricks/test\optimizer/hooks · high confidence

Introduce test optimizer bundle module

A new \test\_optimizer\_bundle.dart\ module has been added to the CLI templates library, exposing the test optimizer bundle functionality. This change supports the broader test optimization features, such as sharding and filtering, by providing the necessary bundle infrastructure for test execution.

lib/src/cli/templates · medium confidence

New E2E test helper utilities for command execution and directory copying

Added a new \e2e/helpers\ package containing reusable utilities for end-to-end testing. This includes \command\_helper.dart\ to simplify running CLI commands with mocked dependencies (logger, progress, pub updater) and captured output, \copy\_directory.dart\ for recursively copying directory structures during tests, and \expect\_successful\_process\_result.dart\ to assert that process executions succeed with expected exit codes and optional stderr validation. These helpers streamline the setup and assertion logic for E2E tests.

e2e/helpers · high confidence

New \`very\_good packages\` command with local license checking

Users can now run \very\_good packages\ to manage packages, which includes a new \check\ subcommand that detects licenses locally. This change introduces the \PackagesCommand\ class, registering both the existing \packages get\ functionality and the new \check licenses\ capability under a unified command structure.

lib/src/commands/packages · high confidence

New documentation site with custom theming and dark mode

The documentation site now features a custom visual identity using the Poppins font and a specific color palette. It includes full support for dark mode, which adjusts the background, primary colors, and code highlighting for better readability. The navigation bar has been styled with a custom 'Get Started' button and icons for GitHub and VGV, with specific adjustments for mobile viewports.

site/src/css · high confidence

New template infrastructure and post-generation actions

The \create\ command now uses a new \Template\ abstraction that supports post-generation callbacks, allowing automatic execution of tasks like \dart pub get\, \flutter pub get\, \dart run pigeon\, and \dart fix --apply\ after a template is generated. This infrastructure is immediately applied to the newly added \very\_good\_dart\_cli\ template and existing templates such as \very\_good\_app\_ui\, \very\_good\_core\, \very\_good\_dart\_package\, \very\_good\_docs\_site\, \very\_good\_flame\_game\, \very\_good\_flutter\_package\, and \very\_good\_flutter\_plugin\, ensuring dependencies are installed and code fixes are applied automatically upon creation.

lib/src/commands/create/templates · high confidence

New test command with extensive configuration options

The \lib/src/commands/test/test.dart\ file introduces the core implementation for a new test command, defining the \FlutterTestOptions\ class to parse and manage a wide array of test execution parameters. Users can now configure concurrency, coverage collection (including minimum thresholds and uncovered line display), test sharding across CI runners, and various filtering mechanisms like tags and file exclusions. The command also supports advanced features such as golden file updates, fail-fast behavior, custom timeouts, platform selection, and integration with Dart defines and file reporters, providing a comprehensive interface for running and reporting on Flutter tests.

lib/src/commands/test · high confidence

Persist CLI defaults via very\_good.yaml configuration

Developers can now save frequently used CLI parameters in a project-root \very\_good.yaml\ file so that running the CLI locally matches CI behavior. The new \VeryGoodConfig\ system loads settings from this file and applies them as defaults for the \test\, \create\, \dart\, and \packages\ commands when those flags are not explicitly provided on the command line, with command-line arguments taking precedence over the file values.

_lib/src/very\_good\config · high confidence

Architecture

Refactored packages get command into dedicated module

The \very\_good packages get\ command logic has been extracted from the main commands file into a dedicated \get.dart\ module, with a new barrel file (\commands.dart\) exporting it. This change improves code organization and maintainability without altering the command's behavior or user-facing options.

lib/src/commands/packages/commands · high confidence

Reorganized create command into dedicated sub-command files

The \lib/src/commands/create/commands\ directory has been restructured to improve maintainability. Each create sub-command (such as \flutter\_app\, \dart\_cli\, \flame\_game\, etc.) is now defined in its own dedicated file (e.g., \flutter\_app.dart\, \dart\_cli.dart\) rather than being grouped together. A new \commands.dart\ barrel file exports all these sub-commands, and a shared \create\_subcommand.dart\ base class handles common logic like argument parsing and template generation. This change makes it easier to locate and modify individual command implementations.

lib/src/commands/create/commands · high confidence

Behavioural changes

Automated bundle generation for templates and test optimizer

The tooling now includes shell scripts to automatically generate and format Mason bundles for all project templates and the test optimizer brick. Running these scripts updates the bundled Dart code in the CLI's template directories, ensuring that changes to the underlying bricks are correctly packaged and formatted for use during app creation.

tool · high confidence

Generated SPDX license enum now uses a lookup map for parsing

The generated \SpdxLicense\ enum in \tool/spdx\license/\\brick\\_/spdx\_license.gen.dart\ has been updated to improve parsing efficiency. Instead of iterating through values, the \tryParse\ and \parse\ methods now utilize a pre-computed \\_valueMap\ (created via \asNameMap\) to resolve license strings to enum instances, reducing object creation overhead during parsing.

_tool/spdx\license/\\brick\\_ · high confidence_

Introduce shared pubspec parsing primitives for license checks

Adds a new \pubspec.dart\ file that defines the \PubspecDependencyType\ enum and a \tryParsePubspec\ helper function. This change centralizes the dependency classification model (direct main, direct dev, transitive, direct overridden) and provides a lenient parser for \pubspec.yaml\ files, enabling the \packages check licenses\ command to consistently process dependency information from both \pubspec.lock\ and workspace \pubspec.yaml\ sources without duplicating logic.

lib/src/pubspec · high confidence

Introduce structured CLI architecture with test optimization and coverage enhancements

The CLI implementation has been reorganized into a modular structure (cli.dart, dart\_cli.dart, flutter\_cli.dart, git\_cli.dart, test\_cli\_runner.dart, test\_event\_reporter.dart) to support advanced testing and dependency management. Users can now run tests with performance optimization and sharding across CI runners, view uncovered lines, and exclude specific files from coverage calculations. The tool also enforces a 120-second timeout on dependency installation to prevent indefinite hangs, validates git dependency reachability before installation, and provides detailed test reports including failing test summaries.

lib/src/cli · high confidence

Reorganized create command into subcommands

The \very\_good create\ command has been refactored to use a subcommand structure, allowing users to invoke specific project types directly (e.g., \very\_good create flutter\_app\, \very\_good create dart\_package\). This change co-locates the command logic with its respective subcommands, improving command discoverability and organization.

lib/src/commands/create · high confidence

Support for Pub workspaces in license checking

The \packages check licenses\ command now correctly handles Pub workspaces. Previously, running the command at the workspace root failed to identify direct dependencies because the shared \pubspec.lock\ classified all member dependencies as transitive. This change introduces a new resolver that aggregates directly-declared dependencies from the root and all member \pubspec.yaml\ files (including those modified by \pubspec\_overrides.yaml\), ensuring accurate license classification across the entire workspace.

_lib/src/pubspec\workspace · high confidence

Updated Flutter package template bundle

The generated Very Good Flutter package template has been updated to include new GitHub configuration files, such as issue and pull request templates, and a license check workflow. This ensures that newly created packages come with standardized contribution guidelines and automated license compliance checks.

_lib/src/commands/create/templates/very\_good\_flutter\package · high confidence

Updated Flutter plugin template with platform-specific CI and Pigeon code generation

The Very Good Flutter plugin template now includes platform-specific GitHub Actions workflows (Android, iOS, Linux, macOS, Web, Windows) and a license check workflow, ensuring generated projects have comprehensive CI coverage. Additionally, the template now generates Pigeon code for platform channel communication, which is automatically built during project creation.

_lib/src/commands/create/templates/very\_good\_flutter\plugin · high confidence

Updated core Flutter template to Flutter 3.47 and Dart 3.13

The generated core Flutter application template has been upgraded to target Flutter 3.47.x and Dart 3.13.0, with the \bloc\ library updated to version 9.2.1 and \flutter\_bloc\ to 9.1.1. This update also refreshes the CI workflows to use the latest Very Good workflows, enforces \very\_good\_analysis\ version 11.0.0, and includes updated IDE configurations for VS Code and IntelliJ.

_lib/src/commands/create/templates/very\_good\core · high confidence

Test coverage

Added build verification test; Added e2e test for flutter\_app creation; Added end-to-end test for flame\_game project creation; Added end-to-end test for flutter\_plugin creation; Added end-to-end test for the create docs\_site command; Added end-to-end tests for async main support and no-project scenarios; Added end-to-end tests for create commands; Added end-to-end tests for the packages check licenses command; Added test fixtures for LCOV coverage and test runner output; Added test for graceful handling of compilation errors; Added test optimizer implementation for sharding and exclusion; Added test runner template for the test optimizer brick; Added tests for MCP server components and error handling; Added tests for PubspecLock parsing and package model; Added tests for SPDX license parsing; Added tests for VeryGoodConfig YAML parsing; Added tests for command runner and logger extension; Added tests for optimization annotation preservation; Added tests for pubspec parsing and workspace dependency resolution; Added tests for spaced golden file names; Added tests for test optimization exclusion logic; Added tests for the \packages check licenses\ command; Added tests for the create command subcommand structure; Added tests for the packages check command help output; Added tests for the packages get command; Added tests for the test command; Added tests for the test optimizer hooks; Added tests for the update command; Added tests for very\_good.yaml config handling; Added tests for very\_good.yaml configuration handling; Added unit tests for CLI, Git, and coverage logic; Added unit tests for create sub-commands; Added unit tests for the Dart test command and parent Dart command; Added unit tests for the TestOptimizer component; New test helpers for command runner and multi-template commands.

Dependencies

Upgrade to Dart 3.13 and update dependencies

The minimum supported Dart SDK version is raised to 3.13.0 across the CLI, the test optimizer brick hooks, the SPDX license tool, and the documentation site. This update brings in newer versions of key dependencies, including mason 0.1.0, very\_good\_analysis 11.0.0, and mocktail 1.0.0, while also upgrading the site to React 19 and TypeScript 7.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 61 → 64 (+2.8)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 83 → 83 (+0.1)
  • Architecture 91 → 91 (+0.1)
  • Maturity 67 → 63 (-3.9)
  • Readiness 60 → 65 (+5.1)
  • Security 55 → 58 (+2.7)
  • Performance 70 → 85 (+15.0)

Resolved (14)

  • Documentation: no contributor guidance (README.md)
  • Documentation: no project overview (README.md)
  • High CVE: [CVE redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • Low CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium vulnerability: [GHSA redacted] (site/package-lock.json)
  • No ADRs found

New (20)

  • ClassTooLong: VeryGoodMCPServer (lib/src/mcp/mcp_server.dart)
  • Edited copy of a member (7 corresponding lines) (lib/src/commands/create/templates/very_good_core/very_good_core_template.dart)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • High CVE: [GHSA redacted] (site/package-lock.json)
  • Low CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • Medium CVE: [GHSA redacted] (site/package-lock.json)
  • No ADRs found (pubspec.yaml)
  • Off-boarding risk: anonymized user #1
  • Repeated repair: lib/src/mcp/structured_tool_error.dart (lib/src/mcp/structured_tool_error.dart)

Changes since last survey

  • 13 commits — 9 feature/other, 4 fixes

By area

  • lib/src — 6 commits
  • (root) — 3 commits
  • site/package-lock.json — 3 commits
  • .github/workflows — 1 commit

Notable commits

  • fix: fix(mcp): enforce wall-clock timeout for test runs (#1766)
  • fix: fix(mcp): validate check_ignore requires dart runner (#1791)
  • fix: fix: classify MCP exceptions and detect a crashed test tool (#1797)
  • fix: fix: isolate site and CLI releases (#1792)
  • change: chore(deps): bump peter-evans/create-pull-request from 8.1.1 to 8.1.2 (#1802)
  • change: chore(deps-dev): bump eslint from 10.12.0 to 10.13.0 in /site (#1785)
  • change: chore(deps-dev): bump eslint from 10.13.0 to 10.14.0 in /site (#1804)
  • change: chore(deps-dev): bump globals from 17.13.0 to 17.14.0 in /site (#1803)
  • change: chore(site): 1.2.0 (#1794)
  • change: chore: 1.6.0 (#1734)
  • change: feat(test): add --workspace flag to test the packages of a Pub workspace (#1807)
  • change: feat: add failureReason to MCP failure payloads (#1798)
  • change: feat: bump template bundles (#1801)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

VeryGoodOpenSource/very_good_cli was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 65250ade1ea509422326a263565f7ec036210e86 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.