agentic_base 0.2.1

A Dart CLI tool that generates agent-ready Flutter repositories with canonical context and deterministic workflows.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.1 - 2026-04-20

Fixed

• root-anchor .pubignore entries so generated-app brick docs stay in the pub.dev archive
• restore packaged agentic_base create output for required generated docs such as docs/01-architecture.md

Testing

• dart pub publish --dry-run verified that bricks/agentic_app/__brick__/{{project_name.snakeCase()}}/docs/01-architecture.md remains in the archive

0.2.0 - 2026-04-20

Added

• classic Gitflow repo policy with documented main, develop, feature/*, release/*, and hotfix/* roles
• PR route enforcement via .github/workflows/gitflow-guard.yml
• CODEOWNERS and a pull request template to standardize review requests after CI passes
• docs/15-default-app-service-matrix.md as the canonical V1 default-app service matrix reference
• docs/16-profile-rollout-migration-guide.md with the manual upgrade checklist for older generated repos
• lib/src/config/profile_preset.dart as the generator-owned source of truth for default modules, providers, starter seams, and profile verify policy
• generated starter seams for EntitlementService, ConsentService, and starter_runtime_profile.dart
• starter widget regression coverage for commerce, journey, and settings profile signals
• harness.observability as the additive local-first observability support envelope in .info/agentic.yaml
• generated app runtime observability seams, network correlation, and telemetry export hooks
• agentic_base inspect plus generated ./tools/inspect-evidence.sh for latest-run bundle inspection
• docs/17-observability-contract.md, docs/18-local-operator-reporting.md, and docs/19-observability-rollout-migration-guide.md

Changed

• pub.dev release archives now exclude repo-only docs/, plans/, coverage output, and repomix artifacts via .pubignore
• package README deep links now point at the repository docs so the published page keeps working after the leaner archive cut
• repo CI now runs for pull requests into main and develop, plus pushes to main, develop, release/*, and hotfix/*
• deployment docs now record the repo merge strategy targets and the current GitHub branch-protection limitation for private repos on this plan
• shared contract guidance now prefers extension-based ergonomics for raw contract models, keeping locale/DI/runtime behavior outside the transport contract
• generated smoke verification now uses a dedicated app-shell-smoke tag so the slow canary is not duplicated in the generic test pass
• smoke policy now distinguishes a fast blocking lane from a slow blocking canary for harness, verify, evidence, and native-surface changes
• contract-frozen surfaces now use evidence_quality instead of observability, with validator and manifest parsing updated to enforce canonical quality dimensions and normalize stale manifest values
• create now defaults to subscription-commerce-app, while explicit empty module overrides still suppress preset-owned defaults
• generated verify and release-preflight surfaces now render profile-aware gate packs and explicit advisory skips for Tier 2 profiles
• the package slow canary now runs generated verify.sh in a fast smoke mode, streams verify output live, and leaves real native readiness to the dedicated CI native gate
• the default starter theme now ships the trustworthy-commerce family with Lexend, Source Sans 3, and google_fonts
• the default payments seam now uses store-native in_app_purchase, and the starter commerce lane keeps payments, entitlement, consent, and ads responsibilities separate
• evidence bundles now emit structured telemetry files beside summary.json and commands.ndjson, and the latest run is published through a deterministic local latest/ pointer
• observability stays local-first and additive; evidence_quality remains a run-evidence dimension, not a telemetry rename

Testing

• dart analyze --fatal-infos passed
• targeted tests passed: test/src/config/project_metadata_test.dart and test/src/generators/project_generator_test.dart
• targeted tests passed: test/src/config/profile_preset_test.dart, test/src/cli/commands/create_command_test.dart, test/src/generators/profile_gate_contract_test.dart, and test/src/docs/harness_contract_documentation_test.dart
• generated-app smoke regression passed: test/integration/generated_app_smoke_test.dart
• targeted tests passed: test/src/cli/commands/inspect_command_test.dart and test/src/observability/run_ledger_test.dart
• shell syntax checks passed for the generated tools/verify.sh and tools/release-preflight.sh
• full dart test passed

0.1.0 - 2026-04-09

Added

• create command — generate Flutter projects with Clean Architecture
• feature command — scaffold 3-layer features (full or flat)
• add/remove commands — manage 25 built-in modules
• gen command — code generation pipeline (build_runner + format)
• eval command — test runner with optional coverage reporting
• deploy command — trigger CI/CD deployment via GitHub Actions
• doctor command — environment health check (Dart, Flutter, Mason)
• brick command — community Mason brick management (add/remove/list)
• init command — add agentic_base to existing Flutter projects
• upgrade command — dependency upgrade with version tracking
• 3 state management options: Cubit (default), Riverpod, MobX
• Full Material 3 theme generation with 19 component themes
• CI/CD workflow templates (GitHub Actions + Fastlane)
• AGENTS.md + CLAUDE.md generation for AI agent integration
• 25 built-in modules across 6 categories: Core, Communication, Monetization, Media, Location, Device