cleany 2.0.9
cleany: ^2.0.9 copied to clipboard
Interactive Flutter architecture CLI for features, components and use cases, with Cubit or Bloc, safe generation, environment configuration and encrypted local storage.
Changelog #
Unreleased #
-
Replace the Sembast adapters and dependencies with ObjectBox and objectbox_flutter_libs pinned to 5.3.2. Preserve the LocalStorage/DI API, AES-GCM value encryption, HMAC key names and typed key policies; support JSON, DateTime and Uint8List without database-specific payload types.
-
Ship stable internal KV model bindings generated with ObjectBox 5.3.2 without adding its incompatible generator dependency to application toolchains. Native storage supports Android/iOS/macOS/Linux/Windows; Web explicitly reports unsupported storage.
-
Safely upgrade unchanged owned storage scaffold code through reviewed Doctor plans with source backups; preserve customized adapters for manual migration. Detect legacy database files before opening ObjectBox and require explicit on-device export/import instead of silently hiding existing data.
-
Update storage documentation and focused storage/generation fixtures for the new backend.
-
Automatically clean analyzer-reported unused imports and supported core print calls in authored staged sources, preserving print-argument side effects and custom methods. Re-analyze before commit; remaining errors roll back the operation. Disclose cleanup in review/progress and retain protected-source checks for unrelated builder changes.
-
Preserve bounded structured Dart analyzer JSON beyond the ordinary log-line limit so larger diagnostic batches can be cleaned reliably. Add focused unit and real Flutter regressions.
-
Fix protected-source failures for valid
gen-l10noutput during Doctor/script runs. Verify untracked/changed outputs against original ARB/header inputs in an isolated workspace, permit planned localization updates, and record output/resource fingerprints. Preserve custom source and unrelated helpers; include configured localization resources in staging and provide a localization-specific fix message. -
Reconcile recognizable manual primary/additional use-case renames and isolated deletions in Doctor before template restoration. Persist source/class/repository-method identities and retired operations; update generated Cubit/Bloc, state/event, DI and automatic loading bindings without resurrecting deleted use cases.
-
Repair stale repository forwarding calls only when one compatible, unambiguous contract exists. Preserve customized business logic/DI and report manual reconciliation when ownership or signatures cannot be established.
-
Retain adopted operation metadata through later generation and feature rename/move/removal. Add focused unit and real Flutter CLI-14 regressions, including cancellation and repeated repair.
2.0.7 - 2026-11-08 #
Changed #
- fix bugs
[2.0.7] - 2026-11-08 #
Changed #
- Default new flavor YAML storage policies to
auto, using a random key held in platform secure storage instead of a shared scaffold password. Preserve existing configured keys; explicit YAML, runtime and dart-define overrides remain supported. Key changes still require data migration. - Verify changed, source-owned builder outputs against a clean staged rebuild before refreshing their ownership. Record source fingerprints, summarize verification once, and preserve originals on mismatches or failed validation.
Fixed #
- Repair stale bindings after manually deleting the last feature without requiring legacy FeaturePages/RouteNames files. Infer local navigation from manifest metadata and system markers; retain customized bindings for manual resolution.
- Report invalid recorded Dart source with its file, line, column and parser diagnostic. Suggest fixing that source instead of inferring naming errors from unrelated words in a diagnostic.
- Align original generated-app expectations with current CLI messages and storage defaults; keep explicit password-mode coverage separate from vault-mode coverage.
Validation #
- Add focused regressions for last-feature recovery, layout inference, syntax diagnostics, source/output provenance and preservation of unreproducible outputs. Update related Flutter fixtures and CI coverage; verify repositoryGuard and dbSecretKey contracts in generated applications.
2.0.6 - 2026-11-06 #
Changed #
- Allow HTTP and HTTPS API base URLs in dev. Require HTTPS in uat/prod, including localhost and loopback addresses, across CLI validation and generated AppConfig paths.
- Keep the dev placeholder at http://localhost:80 and use https://localhost:80 for omitted uat/prod URLs so initialization satisfies the same policy.
- Stop generating api_endpoints.dart; define API paths inside each feature's client/datasource. Doctor retires only unchanged, owned, unreferenced placeholders and stale ownership records, preserving custom/referenced files.
- Remove unused recognized Flutter MainApp/MyApp demo widgets from main.dart and delegate to main_dev.dart. Archive original bytes; preserve widgets needed by project code, exports or tests, ambiguous source, and custom startup logic. Support cleanup of previously rewired entrypoints through Doctor.
- Update the README and generated run guidance. Synchronize package, CLI and template versions at 2.0.6.
Validation #
- Add focused generator and Flutter checks for environment URL policy, dart-define overrides, obsolete-file ownership, and safe entrypoint cleanup.
2.0.5 - 2026-11-05 #
Added #
- Add a project/version/status header with registered feature/component counts, contextual setup/repair recommendations, and disabled-option explanations.
- Support optional arrow navigation, back navigation with retained inputs, compact menu redraws, m/M shortcuts, distinct prompt/selection colors, and automatic identifier case conversion.
- Combine supported project repairs, interrupted-operation recovery, local cache cleanup, and timeout settings under Self-healing doctor & recovery. Require explicit approval and archived originals before rebuilding damaged owned outputs.
- Add four reviewed script recipes: standard setup, generated-output rebuild, build-cache cleanup, and automated repair. Run fixed sequences with fail-fast execution; disclose shared pub-cache repair before approval.
- Install MyBlocObserver for debug-only Cubit/Bloc lifecycle, event, change, transition, and error diagnostics. Evaluate payloads lazily and isolate logging failures; Profile/Release never print state payloads.
- Support additional use cases with List
Changed #
- Reorganize the fixed 1–15 menu: shared services join Generation; entry lists support direct management; Rename and Move become separate actions. Keep independent use-case creation and Apply and validate / Cancel review. Remove positional shortcuts and architecture reset from the CLI; retain the library reset API.
- Generate one feature-owned routing file with paths and private page/BlocProvider composition. New projects omit RouteNames, FeaturePages, and separate feature Pages files. Preserve recorded legacy/custom navigation through Doctor, use-case additions, registry recovery, rename/move, and removal.
- Default omitted/blank initialization API URLs to http://localhost:80. Continue requiring HTTPS for nonlocal UAT/prod endpoints and reject explicitly empty API overrides.
- Validate all public AppConfig construction paths before services open. Remove Dart storage-password fallbacks; resolve keys from dart-define, explicit startup arguments, or flavor YAML. Direct AppConfig construction requires a key.
- Split startup into bootstrap, ApplicationRoot, and ApplicationLifetime; classify failures with StartupStage and retain localized retry/session recovery.
- Delegate database setup to StorageInitializer and separate the platform key store from typed StorageKeyResolver policies: VaultKey, PassphraseKey, and RawKey. Preserve the existing encryption format and stored data.
- Move SessionDataException to app/services/service_extension and update service/startup imports. Keep shared services behind the engine-independent LocalStorage contract.
- Observe Flutter and main-isolate errors through a safe shared sink while preserving handler ownership. Classify/localize HTTP 404 and 429, with optional Retry-After seconds and no implicit retries.
Fixed #
- Stage explicitly planned native files without collecting unrelated platform output; safely add Android release INTERNET permission while preserving custom XML.
- Match Doctor DI repairs to actual controller constructors, preserve custom registrations/routes, and report unsupported signatures without guessing arguments.
- Guard repository Results against synchronous/asynchronous diagnostic failures with a shared repositoryGuard boundary.
- Quarantine reviewed project cache folders at commit without copying large caches into memory. Restore them on safe rollback, preserve concurrent edits/unreferenced backups, and recreate unchanged resolver metadata after cleanup.
- Protect authored logic from builder replacements while allowing explicitly requested formatting-only changes. Keep committed outcomes independent of progress/log/cleanup failures.
- Restore terminal settings before closing stdin, preserve cancellation/retry behavior, and standardize Cause / Suggested fix / Log file diagnostics.
- Refresh the README around practical usage and add focused generation, Flutter, storage/configuration, navigation, and terminal regressions.
2.0.4 - 2026-11-02 #
-
Add menu 12, Create locater, with validated snake_case/PascalCase names, class-only generation under lib/locaters, lazy app-scoped GetIt registration, borrowed UI providers, and transactional ownership/rollback. Move Doctor/recovery/maintenance to 13/14/15.
-
Initialize encrypted AppSettingsManager and UserSessionManager with centralized LocalKeys and immutable typed session data. Load them before the UI, publish only successful writes, update theme/locale reactively, and read the latest session token in trusted-origin Dio requests.
-
Integrate locaters with missing-file/binding repair, marked registry recovery and archived reset; preserve custom registrations and unrelated source formatting. Keep older initialized manager profiles unchanged during repair.
-
Add App config value to collect dev, uat and prod String values, preserve flavor YAML/custom code, and generate typed AppConfig fields with String.fromEnvironment overrides, including explicitly empty custom values.
-
Expose the same DI-owned AppConfig and AppLocalStorage instances through root providers for context.read access in pages; preserve constructor injection for controllers and Data services and app-owned disposal.
-
Add read-only bool AppConfig.isDebug based on Flutter kDebugMode across all environments; reserve IS_DEBUG against custom configuration keys.
-
Initialize encrypted Sembast key/value storage with typed CRUD, LocalKeys, optional collection decoding, authenticated AES-256-GCM values and HMAC record identifiers. Use pass_key_storage as the scaffold password with PBKDF2-HMAC-SHA256 and a random persisted salt; retain optional auto vault keys and 32-byte base64 raw keys.
-
Group the six database, cipher, key-store and exception helpers under core/storage/storage_extension; document platform prerequisites, public configuration limits and explicit key/password migrations.
-
Keep menu numbering sequential: App config value 11, Project Doctor 12, recovery 13 and maintenance/reset 14; retain Apply and validate / Cancel review.
-
Recover registered configuration field names with Doctor, restore missing generated configuration/bootstrap/storage files, preserve valid environment choices during archived reset, and retain legacy storage profiles during repair. Archive malformed flavor YAML before resetting to defaults.
-
Add configuration key/CLI/rollback/repair tests and generated Flutter checks for context access, all flavor values, dart-define precedence, encryption, password/key loss, tampering, persistence, concurrent vault initialization, DI disposal and web compilation.
-
Synchronize the package and generated-template version at 2.0.4 and refresh the README, installation examples and English usage guide for pub.dev.
-
Pin generated apps to Sizer 3.1.3, wrap MaterialApp.router before evaluating responsive themes, and split light/dark Material 3 styling into AppColors, AppTextTheme and AppTheme. Add bounded responsive typography/spacing and preserve system text scaling.
-
Support explicit/system theme modes and safe Doctor integration for recognizable legacy MaterialApp roots; keep theme repair, dependencies, reset and responsive widget tests consistent.
-
Generate Cubit/Bloc features and components with one typed primary status field, such as homeStatus, inside their Freezed State; update it with copyWith and render initial/loading/success/failure using when callbacks. Added operations keep their own independent typed status fields.
-
Include shared operation state during bootstrap and track presentation state style and primary field names through Doctor, registry recovery, refactoring, and use-case additions, preserving existing legacy union and three-field contracts.
-
Remove obsolete generated component page factories before generation/Doctor validation, preserve required widget constructor inputs, and stop recreating legacy component factories or controller registrations during repair.
2.0.3 - 2026-11-01 #
- Generate self-contained components with local Cubit/Bloc providers and automatic disposal, without central DI or FeaturePages entries; preserve previous component wiring during repair and refactoring.
- Preserve customized Models during Doctor inspection and report unsupported discovered schemas without aborting the project report.
- Default added use cases to the feature Entity, allow selecting another existing Domain Entity, and create typed Data mapping hooks when Model and Entity shapes differ.
- Track selected Entity references through repair, discovery and rename/move without rewriting existing schemas.
- Support raw lists, numeric lists, lists of JSON maps, JSON maps, sets and dynamic fields, with case-insensitive input and correct Dart type normalization.
- Reuse project-local validated compiler metadata while staging fresh inputs and rerunning builders and analysis; clear failed/interrupted caches and support maintenance cleanup.
- Preserve default native app icons when Flavorizr does not generate per-flavor catalogs.
- Add actual generated-contract runtime tests and Android/iOS/macOS dev, uat and prod native build jobs.
2.0.2 - 2026-10-31 #
- Reorganize the colored CLI into Generation, Cleanup, Inspection & Management, Core & Setup, and Maintenance & Recovery, using the new 1–13 numbering.
- Explain each command before its prompts, including listing, recovery, maintenance, and exit; keep retry and maintenance-shortcut routing independent of menu numbers.
- Generate component widgets directly inside their component folder, with sibling Cubit/Bloc directories and corrected imports and page factories.
- Track component layouts so Doctor, registry recovery, rename/move, and removal preserve components generated with the previous widgets subfolder.
- Refresh the pub.dev README, command examples, environment setup guide, and CLI/generated Flutter regression coverage.
- Add menu option 3 to create entity-returning or void use cases on existing features, with shared feature repository contracts and Data implementations, central DI, independent typed Cubit/Bloc action state, and a documented backend connection hook that returns Failure until implemented.
- Include added use cases in ownership, Doctor repair/discovery, rename/move, removal, and generated Flutter runtime tests for both API providers.
- Extend the existing feature repository for new use cases instead of creating one repository per operation; retain compatibility with legacy operation contracts.
- Add environment/native VS Code launch profiles with public API URL prompts and a generated run guide. Connect recognizable Flutter scaffold main functions to dev with exact original backups, preserve custom entrypoints/profiles, and support Doctor/reset.
- Prevent builders from replacing existing unstaged files; freeze validated plans and preserve output permissions.
- Preserve customized Doctor integrations and unrelated refactoring bytes; track ownership of individual integration nodes.
- Retain unknown recovery backups, add independent checksummed journal snapshots, and append per-file transitions.
- Separate application outcomes from progress/log/cleanup warnings, retain retry inputs, and isolate operation logs.
- Share pubspec repair/reset settings, follow referenced configurations, validate SDK consistency and flavor prerequisites, and improve startup/service lifecycle diagnostics.
2.0.0 - 2026-10-31 #
- Replace legacy commands with a colored numbered CLI for initialization, feature/component generation, listing, removal, repair, refactoring, maintenance, and native flavors.
- Generate one Feature-Based + Clean Architecture template with Cubit/Bloc, Freezed, multiple_result, central DI, and optional Retrofit over Dio.
- Add compact response fields (
name:type:jsonKey) with y/n nullability and direct review; fix repository constructor lints on current Dart. - Add isolated validation, versioned file ownership, selective staging, kernel locks, per-file rollback/recovery, and archived reset.
- Support official Arabic/English localization, dev/UAT/prod identities, and transactional Android/iOS/macOS Flavorizr configuration.
- Refresh pub.dev metadata, API documentation, runnable examples, usage guides, and current dependencies. Cleany now requires Dart 3.13+.
- Breaking: replace the 1.x template/helper APIs and command aliases; existing generated layouts require an explicit migration. No database SDK is forced.
1.0.22 #
✨ Improvements #
- General library updates and minor bug fixes to enhance overall performance and stability.
1.0.20 31-03-2025 #
✨ Improvements #
- General library updates and minor bug fixes to enhance overall performance and stability.
1.0.19 31-03-2025 #
✨ Improvements #
- General library updates and minor bug fixes to enhance overall performance and stability.
1.0.18 31-03-2025 #
♻️ Changed #
- Models: Fully migrated from
dart_mappabletofreezedfor data classes and code generation.
🐛 Fixed #
- Localization: Resolved the naming issue for language files in the
assetsdirectory. Renamed the files fromar-Ar.jsonanden-US.jsonto the standard formatar.jsonanden.json.
✨ Improvements #
- General library updates and minor bug fixes to enhance overall performance and stability.
1.0.16 07-03-2025 #
Added #
- Smart Collision Detection: The tool now recursively scans all feature directories (
lib/features/,lib/features/sub/, and parent sub-folders) to prevent duplicate feature names and avoid import conflicts. - Full Windows Support: Enhanced CLI commands execution for Windows OS using shell resolution.
Fixed #
- Improved Output Logging: Refactored all console outputs using a dedicated
Loggerfor a cleaner and more professional terminal experience. - Optimized README.md: Completely redesigned the documentation with clear guides for installation, Windows setup, and usage examples.
- Modular DI Structure: Each generated feature now has its own isolated
di/folder and dependency injection file for better maintainability and cleaner code. - Performance Optimization: Eliminated redundant
build_runnercalls during the generation process to speed up feature creation.
1.0.13 #
1.0.1 #
- 🛠 Fixed bug with package installation on Windows.
1.0.0 #
- Initial release of Cleany.
- First public version published.
- Core structure generation.
- Feature generation (Screen & Widget) with Clean Architecture.
- Automatic Dependency Injection and Routing setup.