@git.zone/cli 1.16.7 → 1.16.9

package/readme.md

@@ -47,12 +47,14 @@ gitzone template [template-name]
 ```
 
 **Available templates:**
+
 - **`npm`** - TypeScript npm package with testing, CI/CD, and full tooling
 - **`service`** - Microservice architecture with Docker support
-- **`website`** - Modern web application with LitElement and service workers  
+- **`website`** - Modern web application with LitElement and service workers
 - **`wcc`** - Web Component Collection for reusable UI components
 
 Each template comes pre-configured with:
+
 - ✅ TypeScript with modern configurations
 - ✅ Automated testing setup
 - ✅ CI/CD pipelines (GitLab/GitHub)
@@ -81,6 +83,7 @@ gitzone format --verbose
 ```
 
 **Format features:**
+
 - 🔄 **Smart caching** - Only processes changed files
 - 🛡️ **Rollback support** - Undo formatting changes if needed
 - 📊 **Detailed reporting** - See exactly what changed
@@ -88,6 +91,7 @@ gitzone format --verbose
 - 🎯 **Module-specific formatting** - Target specific formatters
 
 **Rollback capabilities:**
+
 ```bash
 # List all available backups
 gitzone format --list-backups
@@ -103,6 +107,7 @@ gitzone format --clean-backups
 ```
 
 **Formatters included:**
+
 - **Prettier** - JavaScript/TypeScript code formatting
 - **License** - Ensure proper licensing
 - **Package.json** - Standardize package configurations
@@ -121,6 +126,7 @@ gitzone commit
 ```
 
 Features:
+
 - 📝 Interactive commit message builder
 - 🏷️ Automatic version bumping (major/minor/patch)
 - 📜 Changelog generation
@@ -128,6 +134,7 @@ Features:
 - 🎯 Conventional commit compliance
 
 The commit wizard guides you through:
+
 1. **Type selection** (feat/fix/docs/style/refactor/perf/test/chore)
 2. **Scope definition** (component/module affected)
 3. **Description crafting**
@@ -153,6 +160,7 @@ gitzone meta remove [name]
 ```
 
 Perfect for:
+
 - Monorepo management
 - Multi-package projects
 - Coordinated deployments
@@ -168,6 +176,7 @@ gitzone docker prune
 ```
 
 This command removes:
+
 - Stopped containers
 - Unused images
 - Dangling volumes
@@ -196,6 +205,7 @@ gitzone deprecate
 ```
 
 Interactive wizard for:
+
 - Setting deprecation notices
 - Guiding users to replacements
 - Updating registry metadata
@@ -210,6 +220,7 @@ gitzone start
 ```
 
 Automatically:
+
 - Checks out master branch
 - Pulls latest changes
 - Installs dependencies
@@ -266,18 +277,21 @@ Customize gitzone behavior through `npmextra.json`:
 ## 🏆 Best Practices
 
 ### For New Projects
+
 1. Start with a template: `gitzone template npm`
 2. Customize the generated structure
 3. Run initial format: `gitzone format`
 4. Set up CI/CD: `gitzone open ci`
 
 ### For Existing Projects
+
 1. Initialize: `gitzone start`
 2. Format codebase: `gitzone format --dry-run` (preview first!)
 3. Apply formatting: `gitzone format --yes`
 4. Commit changes: `gitzone commit`
 
 ### For Teams
+
 1. Document format preferences in `npmextra.json`
 2. Use `--save-plan` for reviewable format changes
 3. Enable rollback for safety
@@ -286,6 +300,7 @@ Customize gitzone behavior through `npmextra.json`:
 ## 🎯 Common Workflows
 
 ### Clean Development Cycle
+
 ```bash
 # 1. Start fresh
 gitzone start
@@ -304,6 +319,7 @@ gitzone commit
 ```
 
 ### Multi-Repository Management
+
 ```bash
 # 1. Set up meta repository
 gitzone meta init
@@ -318,6 +334,7 @@ gitzone meta update
 ```
 
 ### Safe Formatting with Rollback
+
 ```bash
 # 1. Preview changes
 gitzone format --dry-run
@@ -335,17 +352,20 @@ gitzone format --rollback
 ## 🔌 Integrations
 
 ### CI/CD Platforms
+
 - **GitLab CI** - Full pipeline support with templates
 - **GitHub Actions** - Automated workflows
 - **Docker** - Container-based deployments
 
 ### Development Tools
+
 - **TypeScript** - First-class support
 - **Prettier** - Code formatting
 - **ESLint** - Linting (via format modules)
 - **npm/pnpm** - Package management
 
 ### Version Control
+
 - **Git** - Deep integration
 - **Semantic Versioning** - Automatic version bumping
 - **Conventional Commits** - Standardized commit messages
@@ -361,19 +381,25 @@ gitzone format --rollback
 ## 🐛 Troubleshooting
 
 ### Format Command Shows "Cancelled"
+
 If the format command shows cancelled even after confirming:
+
 - Check your `npmextra.json` configuration
 - Try with `--yes` flag to skip confirmation
 - Use `--verbose` for detailed output
 
 ### Docker Commands Fail
+
 Ensure Docker daemon is running:
+
 ```bash
 docker info
 ```
 
 ### Template Creation Issues
+
 Verify npm/pnpm is properly configured:
+
 ```bash
 npm config get registry
 ```
@@ -381,6 +407,7 @@ npm config get registry
 ## 📈 Performance
 
 gitzone is optimized for speed:
+
 - **Parallel processing** for format operations
 - **Smart caching** to avoid redundant work
 - **Incremental updates** for meta repositories
@@ -388,7 +415,7 @@ gitzone is optimized for speed:
 
 ## License and Legal Information
 
-This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository.
 
 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
 
@@ -403,4 +430,4 @@ Registered at District court Bremen HRB 35230 HB, Germany
 
 For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
 
-By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/readme.plan.md

@@ -3,11 +3,13 @@
 Please reread /home/philkunz/.claude/CLAUDE.md before proceeding with any implementation.
 
 ## Overview
+
 This plan outlines improvements for the gitzone format module to enhance its functionality, reliability, and maintainability.
 
 ## Phase 1: Core Improvements (High Priority) - COMPLETED ✅
 
 ### 1. Enhanced Error Handling & Recovery ✅
+
 - [x] Implement rollback mechanism for failed format operations
 - [x] Add detailed error messages with recovery suggestions
 - [x] Create a `--dry-run` flag to preview changes before applying
@@ -15,12 +17,14 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 - [x] Implement plan → action workflow as default behavior
 
 ### 2. Complete Missing Functionality ✅
+
 - [x] Implement the `ensureDependency` function in format.packagejson.ts
 - [x] Develop the copy module for file pattern-based copying
 - [x] Add dependency version constraint management
 - [x] Support workspace/monorepo configurations (via configuration)
 
 ### 3. Configuration & Flexibility ✅
+
 - [x] Extend npmextra.json gitzone configuration section
 - [x] Allow custom license exclusion/inclusion lists
 - [x] Make format steps configurable (skip/include specific modules)
@@ -28,6 +32,7 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 - [x] Add format profiles for different project types
 
 ### 4. Architecture Changes ✅
+
 - [x] Introduce a `FormatContext` class to manage state across modules
 - [x] Create abstract `BaseFormatter` class for consistent module structure
 - [x] Implement event system for inter-module communication (via context)
@@ -37,12 +42,14 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 ## Phase 2: Performance & Reporting (Medium Priority) - COMPLETED ✅
 
 ### 5. Performance Optimizations ✅
+
 - [x] Implement parallel execution for independent format modules
 - [x] Add file change detection to skip unchanged files
 - [x] Create format cache to track last formatted state
 - [x] Optimize Prettier runs by batching files
 
 ### 6. Enhanced Reporting & Visibility ✅
+
 - [x] Generate comprehensive format report showing all changes
 - [x] Add diff view for file modifications
 - [x] Create verbose logging option
@@ -51,30 +58,35 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 ## Phase 3: Advanced Features (Lower Priority) - PARTIALLY COMPLETED
 
 ### 7. Better Integration & Extensibility ⏳
+
 - [ ] Create plugin system for custom format modules
 - [ ] Add hooks for pre/post format operations
 - [ ] Support custom validation rules
 - [ ] Integrate with git hooks for pre-commit formatting
 
 ### 8. Improved Template Integration ⏳
+
 - [ ] Better error handling when smartscaf operations fail
 - [ ] Add pre/post template hooks for custom processing
 - [ ] Validate template results before proceeding with format
 - [ ] Support skipping template updates via configuration
 
 ### 9. Enhanced License Management ⏳
+
 - [ ] Make license checking configurable (partial)
 - [ ] Add license compatibility matrix
 - [x] Support license exceptions for specific packages
 - [ ] Generate license report for compliance
 
 ### 10. Better Package.json Management ⏳
+
 - [ ] Smart dependency sorting and grouping
 - [ ] Automated script generation based on project type
 - [ ] Support for pnpm workspace configurations
 - [ ] Validation of package.json schema
 
 ### 11. Quality of Life Improvements ⏳
+
 - [ ] Interactive mode for format configuration
 - [ ] Undo/redo capability for format operations
 - [ ] Format presets for common scenarios
@@ -85,28 +97,33 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 ### ✅ Completed Features
 
 1. **Rollback Mechanism**
+
    - Full backup/restore functionality
    - Manifest tracking and integrity checks
    - CLI commands for rollback operations
 
 2. **Plan → Action Workflow**
+
    - Two-phase approach (analyze then execute)
    - Interactive confirmation
    - Dry-run support
 
 3. **Configuration System**
+
    - Comprehensive npmextra.json support
    - Module control (skip/only/order)
    - Cache configuration
    - Parallel execution settings
 
 4. **Performance Improvements**
+
    - Parallel execution by dependency analysis
    - File change caching
    - Prettier batching
    - Execution time tracking
 
 5. **Reporting & Statistics**
+
    - Detailed diff views
    - Execution statistics
    - Verbose logging mode
@@ -121,6 +138,7 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 ### 🚧 Partially Completed
 
 1. **License Management**
+
    - Basic configuration support
    - Exception handling for specific packages
    - Need: compatibility matrix, compliance reports
@@ -132,11 +150,13 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 ### ⏳ Not Started
 
 1. **Plugin System**
+
    - Need to design plugin API
    - Hook system for pre/post operations
    - Custom validation rules
 
 2. **Git Integration**
+
    - Pre-commit hooks
    - Automatic formatting on commit
 
@@ -167,4 +187,4 @@ This plan outlines improvements for the gitzone format module to enhance its fun
 - ✅ Faster execution through parallel processing and caching
 - ✅ Enhanced user control through configuration
 - ✅ Better visibility through reporting and statistics
-- ✅ Improved maintainability through better architecture
+- ✅ Improved maintainability through better architecture

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/cli',
-  version: '1.16.7',
+  version: '1.16.9',
   description: 'A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.'
 }

package/ts/mod_format/classes.baseformatter.ts

@@ -2,32 +2,29 @@ import * as plugins from './mod.plugins.js';
 import { FormatContext } from './classes.formatcontext.js';
 import type { IPlannedChange } from './interfaces.format.js';
 import { Project } from '../classes.project.js';
-import { ChangeCache } from './classes.changecache.js';
 
 export abstract class BaseFormatter {
   protected context: FormatContext;
   protected project: Project;
-  protected cache: ChangeCache;
   protected stats: any; // Will be FormatStats from context
-  
+
   constructor(context: FormatContext, project: Project) {
     this.context = context;
     this.project = project;
-    this.cache = context.getChangeCache();
     this.stats = context.getFormatStats();
   }
-  
+
   abstract get name(): string;
   abstract analyze(): Promise<IPlannedChange[]>;
   abstract applyChange(change: IPlannedChange): Promise<void>;
-  
+
   async execute(changes: IPlannedChange[]): Promise<void> {
     const startTime = this.stats.moduleStartTime(this.name);
     this.stats.startModule(this.name);
-    
+
     try {
       await this.preExecute();
-      
+
       for (const change of changes) {
         try {
           await this.applyChange(change);
@@ -37,57 +34,49 @@ export abstract class BaseFormatter {
           throw error;
         }
       }
-      
+
       await this.postExecute();
     } catch (error) {
-      await this.context.rollbackOperation();
+      // Don't rollback here - let the FormatPlanner handle it
       throw error;
     } finally {
       this.stats.endModule(this.name, startTime);
     }
   }
-  
+
   protected async preExecute(): Promise<void> {
     // Override in subclasses if needed
   }
-  
+
   protected async postExecute(): Promise<void> {
     // Override in subclasses if needed
   }
-  
+
   protected async modifyFile(filepath: string, content: string): Promise<void> {
-    await this.context.trackFileChange(filepath);
-    await plugins.smartfile.memory.toFs(content, filepath);
-    await this.cache.updateFileCache(filepath);
+    // Validate filepath before writing
+    if (!filepath || filepath.trim() === '') {
+      throw new Error(`Invalid empty filepath in modifyFile`);
+    }
+
+    // Ensure we have a proper path with directory component
+    // If the path has no directory component (e.g., "package.json"), prepend "./"
+    let normalizedPath = filepath;
+    if (!plugins.path.parse(filepath).dir) {
+      normalizedPath = './' + filepath;
+    }
+
+    await plugins.smartfile.memory.toFs(content, normalizedPath);
   }
-  
+
   protected async createFile(filepath: string, content: string): Promise<void> {
     await plugins.smartfile.memory.toFs(content, filepath);
-    await this.cache.updateFileCache(filepath);
   }
-  
+
   protected async deleteFile(filepath: string): Promise<void> {
-    await this.context.trackFileChange(filepath);
     await plugins.smartfile.fs.remove(filepath);
   }
-  
+
   protected async shouldProcessFile(filepath: string): Promise<boolean> {
-    const config = new plugins.npmextra.Npmextra();
-    const useCache = config.dataFor('gitzone.format.cache.enabled', true);
-    
-    if (!useCache) {
-      return true; // Process all files if cache is disabled
-    }
-    
-    const hasChanged = await this.cache.hasFileChanged(filepath);
-    
-    // Record cache statistics
-    if (hasChanged) {
-      this.stats.recordCacheMiss();
-    } else {
-      this.stats.recordCacheHit();
-    }
-    
-    return hasChanged;
+    return true;
   }
-}
+}