Compare commits
	
		
			41 Commits
		
	
	
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| a69b613087 | |||
| 1ea186d233 | |||
| f5e7d43cf3 | |||
| d80faa044a | |||
| 64062e5c43 | |||
| bd22844280 | |||
| 366c4a0bc2 | |||
| 0d3b10bd00 | |||
| a41e3d5d2c | |||
| c45cff89de | |||
| 7bb43ad478 | |||
| 8dcaf1c631 | |||
| 422761806d | |||
| 31360240a9 | |||
| e338ee584f | |||
| 31d2e18830 | |||
| a162ddabbb | |||
| 5dfa1d72aa | |||
| 7074a19a7f | |||
| 5774fb4da2 | |||
| be45ce765d | |||
| 2a250b8823 | |||
| 9a436cb4be | |||
| 86782c39dd | |||
| fba3e9d2b0 | |||
| cc37f70185 | |||
| dbc1a1ba18 | |||
| ff57f8a322 | |||
| 968e67330d | |||
| 935ee20e83 | |||
| c205180991 | |||
| 4a53bc4abc | |||
| a86fb3bb8e | |||
| b187000ae4 | |||
| c715adfd6c | |||
| 7b9ebfdacb | |||
| 05b170cbac | |||
| b320af0b61 | |||
| 49e1ee1f39 | |||
| cef31cf1ff | |||
| 74ecdde1ac | 
							
								
								
									
										2
									
								
								.gitignore
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										2
									
								
								.gitignore
									
									
									
									
										vendored
									
									
								
							@@ -17,3 +17,5 @@ dist/
 | 
			
		||||
dist_*/
 | 
			
		||||
 | 
			
		||||
#------# custom
 | 
			
		||||
.serena
 | 
			
		||||
test-output.json
 | 
			
		||||
 
 | 
			
		||||
@@ -19,4 +19,8 @@ node_modules/
 | 
			
		||||
dist/
 | 
			
		||||
dist_*/
 | 
			
		||||
 | 
			
		||||
# AI
 | 
			
		||||
.claude/
 | 
			
		||||
.serena/
 | 
			
		||||
 | 
			
		||||
#------# custom
 | 
			
		||||
							
								
								
									
										240
									
								
								changelog.md
									
									
									
									
									
								
							
							
						
						
									
										240
									
								
								changelog.md
									
									
									
									
									
								
							@@ -1,6 +1,177 @@
 | 
			
		||||
# Changelog
 | 
			
		||||
 | 
			
		||||
## 2025-11-03 - 1.19.3 - fix(tsdoc)
 | 
			
		||||
Bump @git.zone/tsdoc to ^1.8.0 and add .claude local settings
 | 
			
		||||
 | 
			
		||||
- Upgrade dependency @git.zone/tsdoc from ^1.6.1 to ^1.8.0 in package.json
 | 
			
		||||
- Add .claude/settings.local.json for local assistant permissions/configuration
 | 
			
		||||
 | 
			
		||||
## 2025-11-03 - 1.19.2 - fix(tsdoc)
 | 
			
		||||
Bump @git.zone/tsdoc to ^1.6.1 and add .claude/settings.local.json
 | 
			
		||||
 | 
			
		||||
- Update dependency @git.zone/tsdoc from ^1.6.0 to ^1.6.1
 | 
			
		||||
- Add .claude/settings.local.json to include local Claude settings/permissions
 | 
			
		||||
 | 
			
		||||
## 2025-11-02 - 1.19.1 - fix(dependencies)
 | 
			
		||||
Bump dependencies and add local Claude settings
 | 
			
		||||
 | 
			
		||||
- Bump devDependencies: @git.zone/tsbuild -> ^2.7.1, @git.zone/tsrun -> ^1.6.2, @git.zone/tstest -> ^2.7.0
 | 
			
		||||
- Upgrade runtime dependencies: @git.zone/tsdoc -> ^1.6.0; update @push.rocks packages (smartcli ^4.0.19, smartjson ^5.2.0, smartlog ^3.1.10, smartnetwork ^4.4.0, etc.)
 | 
			
		||||
- Add .claude/settings.local.json (local project permissions/settings file)
 | 
			
		||||
 | 
			
		||||
## 2025-10-23 - 1.19.0 - feat(mod_commit)
 | 
			
		||||
Add CLI UI helpers and improve commit workflow with progress, recommendations and summary
 | 
			
		||||
 | 
			
		||||
- Introduce ts/mod_commit/mod.ui.ts: reusable CLI UI helpers (pretty headers, sections, AI recommendation box, step printer, commit summary and helpers for consistent messaging).
 | 
			
		||||
- Refactor ts/mod_commit/index.ts: use new UI functions to display AI recommendations, show step-by-step progress for baking commit info, generating changelog, staging, committing, bumping version and optional push; include commit SHA in final summary.
 | 
			
		||||
- Enhance ts/mod_commit/mod.helpers.ts: bumpProjectVersion now accepts currentStep/totalSteps to report progress and returns a consistent newVersion after handling npm/deno/both cases.
 | 
			
		||||
- Add .claude/settings.local.json: local permissions configuration for development tooling.
 | 
			
		||||
 | 
			
		||||
## 2025-10-23 - 1.18.9 - fix(mod_commit)
 | 
			
		||||
Stage and commit deno.json when bumping/syncing versions and create/update git tags
 | 
			
		||||
 | 
			
		||||
- bumpDenoVersion now creates a Smartshell instance and runs git add deno.json, git commit -m "v<newVersion>", and git tag v<newVersion> to persist the version bump
 | 
			
		||||
- syncVersionToDenoJson now stages deno.json, amends the npm version commit with --no-edit, and recreates the tag with -fa to keep package.json and deno.json in sync
 | 
			
		||||
- Added informative logger messages after creating commits and tags
 | 
			
		||||
 | 
			
		||||
## 2025-10-23 - 1.18.8 - fix(mod_commit)
 | 
			
		||||
Improve commit workflow: detect project type and current branch; add robust version bump helpers for npm/deno
 | 
			
		||||
 | 
			
		||||
- Add mod_commit/mod.helpers.ts with utilities: detectCurrentBranch(), detectProjectType(), bumpProjectVersion(), bumpDenoVersion(), bumpNpmVersion(), syncVersionToDenoJson(), and calculateNewVersion()
 | 
			
		||||
- Refactor ts/mod_commit/index.ts to use the new helpers: bumpProjectVersion(projectType, ... ) instead of a hard npm version call and push the actual current branch instead of hardcoding 'master'
 | 
			
		||||
- Support bumping versions for npm-only, deno-only, and hybrid (both) projects and synchronize versions from package.json to deno.json when applicable
 | 
			
		||||
- Improve branch detection with a fallback to 'master' and informative logging on detection failures
 | 
			
		||||
- Add local Claude settings file (.claude/settings.local.json) (editor/CI config) — no code behavior change but included in diff
 | 
			
		||||
 | 
			
		||||
## 2025-09-07 - 1.18.7 - fix(claude)
 | 
			
		||||
Add .claude local settings to whitelist dev tool permissions
 | 
			
		||||
 | 
			
		||||
- Add .claude/settings.local.json to configure allowed permissions for local AI/tooling helpers (Bash commands, WebFetch, and mcp_serena actions).
 | 
			
		||||
- Disable enableAllProjectMcpServers (set to false) to limit automatic project MCP server usage.
 | 
			
		||||
 | 
			
		||||
## 2025-09-07 - 1.18.6 - fix(deps)
 | 
			
		||||
Bump dependency versions and add local Claude settings
 | 
			
		||||
 | 
			
		||||
- Updated devDependencies: @git.zone/tsbuild ^2.6.4 → ^2.6.8, @git.zone/tstest ^2.3.4 → ^2.3.6, @push.rocks/smartfile ^11.2.5 → ^11.2.7
 | 
			
		||||
- Updated dependencies: @git.zone/tsdoc ^1.5.1 → ^1.5.2, @git.zone/tspublish ^1.10.1 → ^1.10.3, @push.rocks/smartlog ^3.1.8 → ^3.1.9, @push.rocks/smartnpm ^2.0.4 → ^2.0.6, @push.rocks/smartscaf ^4.0.17 → ^4.0.19
 | 
			
		||||
- Added .claude/settings.local.json to configure local Claude permissions/settings
 | 
			
		||||
 | 
			
		||||
## 2025-08-17 - 1.18.5 - fix(dependencies)
 | 
			
		||||
Bump smartshell and smartscaf versions; add .claude local settings
 | 
			
		||||
 | 
			
		||||
- Update @push.rocks/smartshell from ^3.2.4 to ^3.3.0 in package.json
 | 
			
		||||
- Update @push.rocks/smartscaf from ^4.0.16 to ^4.0.17 in package.json
 | 
			
		||||
- Add .claude/settings.local.json for local assistant permissions/configuration
 | 
			
		||||
 | 
			
		||||
## 2025-08-17 - 1.18.4 - fix(cli)
 | 
			
		||||
Update dependencies, add local Claude settings, and update gitignore template
 | 
			
		||||
 | 
			
		||||
- Bump several dependencies: @git.zone/tsbuild -> ^2.6.4, @git.zone/tspublish -> ^1.10.1, @git.zone/tstest -> ^2.3.4, @push.rocks/smartfile -> ^11.2.5, @push.rocks/npmextra -> ^5.3.3, @push.rocks/smartchok -> ^1.1.1, @push.rocks/smartlog -> ^3.1.8, @push.rocks/smartpath -> ^6.0.0, prettier -> ^3.6.2
 | 
			
		||||
- Add .claude/settings.local.json with local permissions configuration for AI tooling
 | 
			
		||||
- Update assets/templates/gitignore to ignore .claude/ and .serena/ directories
 | 
			
		||||
- Add pnpm onlyBuiltDependencies entries: esbuild and mongodb-memory-server
 | 
			
		||||
 | 
			
		||||
## 2025-08-16 - 1.18.3 - fix(services)
 | 
			
		||||
Simplify S3 endpoint handling in ServiceConfiguration to store host only
 | 
			
		||||
 | 
			
		||||
- S3_ENDPOINT now stores the raw host (e.g. 'localhost') instead of a full URL with protocol and port.
 | 
			
		||||
- Default .nogit/env.json creation uses the host-only S3_ENDPOINT.
 | 
			
		||||
- Sync/update logic (when syncing with Docker or reconfiguring ports) sets S3_ENDPOINT to the host only.
 | 
			
		||||
- Consumers that previously relied on S3_ENDPOINT containing protocol and port should now construct the full endpoint URL using S3_USESSL, S3_HOST and S3_PORT.
 | 
			
		||||
 | 
			
		||||
## 2025-08-16 - 1.18.1 - fix(services)
 | 
			
		||||
Improve services and commit flow: stop AiDoc, use silent docker inspect, sync ports with logging, fix config loading, and bump deps
 | 
			
		||||
 | 
			
		||||
- Ensure AiDoc is stopped after building commit recommendation to avoid resource leaks
 | 
			
		||||
- Use execSilent for `docker inspect` in DockerContainer to avoid shell noise and improve JSON parsing
 | 
			
		||||
- Sync Docker-exposed ports into service configuration with explicit notes (logs) when MongoDB / S3 ports are updated
 | 
			
		||||
- Fix synchronous config loading by removing an unnecessary await in ServiceConfiguration.loadConfig
 | 
			
		||||
- Bump dependencies: @push.rocks/smartshell -> ^3.2.4, @git.zone/tsdoc -> ^1.5.1
 | 
			
		||||
- Add pnpm.onlyBuiltDependencies for puppeteer and sharp to package.json
 | 
			
		||||
- Add local Claude settings file (.claude/settings.local.json) with development permissions
 | 
			
		||||
 | 
			
		||||
## 2025-08-16 - 1.18.0 - feat(services)
 | 
			
		||||
Add Docker port mapping sync and reconfigure workflow for local services
 | 
			
		||||
 | 
			
		||||
- Add getPortMappings to DockerContainer to extract port bindings from docker inspect output
 | 
			
		||||
- Sync existing container port mappings into .nogit/env.json when loading/creating service configuration
 | 
			
		||||
- Validate and automatically update ports only when containers are not present; preserve container ports when containers exist
 | 
			
		||||
- Recreate containers automatically if detected container port mappings differ from configuration (MongoDB and MinIO)
 | 
			
		||||
- Add reconfigure method and new CLI command to reassign ports and optionally restart services
 | 
			
		||||
- Improve status output to show configured ports and port availability information
 | 
			
		||||
- Minor helpers and imports updated (DockerContainer injected into ServiceConfiguration)
 | 
			
		||||
- Add .claude/settings.local.json (local permissions config) to repository
 | 
			
		||||
 | 
			
		||||
## 2025-08-15 - 1.17.5 - fix(services)
 | 
			
		||||
Update S3 credentials naming and add S3_ENDPOINT/S3_USESSL support for improved MinIO integration
 | 
			
		||||
 | 
			
		||||
- Replaced S3_USER/S3_PASS with S3_ACCESSKEY/S3_SECRETKEY in ServiceConfiguration
 | 
			
		||||
- Added S3_ENDPOINT field with automatic protocol selection based on S3_USESSL
 | 
			
		||||
- Introduced S3_USESSL boolean field for SSL/TLS configuration
 | 
			
		||||
- Updated ServiceManager logging to display new S3_USESSL configuration
 | 
			
		||||
- Added .claude/settings.local.json for local permission settings
 | 
			
		||||
 | 
			
		||||
## 2025-08-15 - 1.17.4 - fix(services)
 | 
			
		||||
Update S3 credentials naming and add S3_ENDPOINT/S3_USESSL support for improved MinIO integration
 | 
			
		||||
 | 
			
		||||
- Replaced S3_USER/S3_PASS with S3_ACCESSKEY/S3_SECRETKEY in ServiceConfiguration
 | 
			
		||||
- Added S3_ENDPOINT field with automatic protocol selection based on S3_USESSL
 | 
			
		||||
- Added S3_USESSL boolean field for SSL/TLS configuration support
 | 
			
		||||
- Updated ServiceManager to use new credential names in container setup and logging
 | 
			
		||||
 | 
			
		||||
## 2025-08-15 - 1.17.3 - fix(serviceconfig)
 | 
			
		||||
Update service configuration to include dynamic MongoDB connection string and add local permissions settings
 | 
			
		||||
 | 
			
		||||
- Added .claude/settings.local.json for local permissions configuration
 | 
			
		||||
- Updated ServiceConfiguration to compute and update MONGODB_URL based on current config values
 | 
			
		||||
 | 
			
		||||
## 2025-08-15 - 1.17.2 - fix(ci-test-services)
 | 
			
		||||
Update CI/CD configurations, test settings, and Docker service for MongoDB.
 | 
			
		||||
 | 
			
		||||
- Add .claude/settings.local.json with updated permission settings
 | 
			
		||||
- Introduce new GitLab CI, VSCode launch and settings, and updated test configuration files (.gitignore, .npmrc, npmextra.json, package.json, qenv.yml, readme.md)
 | 
			
		||||
- Update test scripts in test/test and test/ts to improve project validation
 | 
			
		||||
- Fix MongoDB Docker container command by adding '--bind_ip_all' for proper network binding
 | 
			
		||||
 | 
			
		||||
## 2025-08-15 - 1.17.1 - fix(services)
 | 
			
		||||
Improve services module logging and enhance MongoDB Compass integration
 | 
			
		||||
 | 
			
		||||
- Refactored services module to use centralized logger from gitzone.logging.ts
 | 
			
		||||
- Automatically display MongoDB Compass connection string when starting services or checking status
 | 
			
		||||
- Removed custom printMessage wrapper in favor of standard logger.log() calls
 | 
			
		||||
- Consistent logging across all service commands
 | 
			
		||||
 | 
			
		||||
## 2025-08-14 - 1.17.0 - feat(services)
 | 
			
		||||
Add comprehensive development services management for MongoDB and MinIO containers
 | 
			
		||||
 | 
			
		||||
- Implemented `gitzone services` command for managing local development services
 | 
			
		||||
- Added MongoDB and MinIO (S3-compatible) container orchestration
 | 
			
		||||
- Smart port assignment (20000-30000 range) to avoid conflicts between projects
 | 
			
		||||
- Project-specific container names for complete isolation
 | 
			
		||||
- Data persistence in `.nogit/` directories
 | 
			
		||||
- MongoDB Compass connection string generation with network IP detection
 | 
			
		||||
- Auto-configuration via `.nogit/env.json` with secure defaults
 | 
			
		||||
- Commands: start, stop, restart, status, config, compass, logs, remove, clean
 | 
			
		||||
- Interactive confirmations for destructive operations
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.10 - fix(format)
 | 
			
		||||
Improve concurrency control in caching and rollback modules, refine gitignore custom section handling, and enhance Prettier file processing.
 | 
			
		||||
 | 
			
		||||
- Added mutex locking in ChangeCache and RollbackManager to prevent race conditions during manifest updates
 | 
			
		||||
- Updated gitignore logic to detect and preserve custom sections
 | 
			
		||||
- Enhanced Prettier batching and file formatting for better performance
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.9 - fix(format)
 | 
			
		||||
 | 
			
		||||
Improve concurrency control in cache and rollback modules, refine gitignore custom section handling, and enhance Prettier file processing
 | 
			
		||||
 | 
			
		||||
- Added mutex locking in ChangeCache and RollbackManager to prevent race conditions during manifest updates
 | 
			
		||||
- Updated gitignore logic to detect and preserve existing custom sections from various markers
 | 
			
		||||
- Simplified Prettier formatter to process files sequentially, skip files without extensions, and log detailed status
 | 
			
		||||
- Minor refactoring in base formatter and tsconfig file updates for improved reliability
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.8 - fix(format)
 | 
			
		||||
 | 
			
		||||
Improve concurrency control in cache and rollback management with mutex locking and refine formatting details
 | 
			
		||||
 | 
			
		||||
- Added 'withMutex' functions in ChangeCache and RollbackManager to synchronize file I/O operations
 | 
			
		||||
@@ -8,6 +179,7 @@ Improve concurrency control in cache and rollback management with mutex locking
 | 
			
		||||
- Fixed minor formatting issues in commit info and package.json
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.7 - fix(core)
 | 
			
		||||
 | 
			
		||||
Improve formatting, logging, and rollback integrity in core modules
 | 
			
		||||
 | 
			
		||||
- Add .claude/settings.local.json with defined permissions for allowed commands
 | 
			
		||||
@@ -16,6 +188,7 @@ Improve formatting, logging, and rollback integrity in core modules
 | 
			
		||||
- Enhance logging messages and overall code clarity in CLI and commit modules
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.6 - fix(changecache)
 | 
			
		||||
 | 
			
		||||
Improve cache manifest validation and atomic file writes; add local settings and overrides
 | 
			
		||||
 | 
			
		||||
- Add manifest structure validation and default fallback in getManifest
 | 
			
		||||
@@ -25,6 +198,7 @@ Improve cache manifest validation and atomic file writes; add local settings and
 | 
			
		||||
- Add an empty assets/overrides.json file for future overrides
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.5 - fix(prettier)
 | 
			
		||||
 | 
			
		||||
Improve file selection in Prettier formatter, remove legacy package overrides, and update CI template indentation
 | 
			
		||||
 | 
			
		||||
- Added .claude/settings.local.json with updated permission settings for local commands
 | 
			
		||||
@@ -33,12 +207,14 @@ Improve file selection in Prettier formatter, remove legacy package overrides, a
 | 
			
		||||
- Refined Prettier formatter logic by defining include directories, root config files, and filtering duplicates instead of manual exclusion
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.4 - fix(prettier)
 | 
			
		||||
 | 
			
		||||
Improve file exclusion in the Prettier formatter to skip unnecessary files and directories.
 | 
			
		||||
 | 
			
		||||
- Added exclusion patterns for node_modules, .git, dist, .nogit, coverage, .nyc_output, vendor, bower_components, jspm_packages, and minified files.
 | 
			
		||||
- Optimized filtering logic to ensure only valid files are processed.
 | 
			
		||||
 | 
			
		||||
## 2025-08-08 - 1.16.3 - fix(changecache/prettier)
 | 
			
		||||
 | 
			
		||||
Skip directories during file processing to prevent errors in changecache and prettier formatting
 | 
			
		||||
 | 
			
		||||
- Removed unnecessary await on synchronous file reads in changecache
 | 
			
		||||
@@ -46,18 +222,21 @@ Skip directories during file processing to prevent errors in changecache and pre
 | 
			
		||||
- Filtered out directories in prettier formatter to avoid processing non-files
 | 
			
		||||
 | 
			
		||||
## 2025-08-07 - 1.16.2 - fix(format)
 | 
			
		||||
 | 
			
		||||
Fix format command confirmation prompt to correctly check user response
 | 
			
		||||
 | 
			
		||||
- Fixed bug where format command always showed "cancelled" even when user confirmed
 | 
			
		||||
- Changed response check from `response.proceed` to `response.value` for SmartInteract compatibility
 | 
			
		||||
 | 
			
		||||
## 2025-08-04 - 1.16.1 - fix(package/config)
 | 
			
		||||
 | 
			
		||||
Move smartdiff dependency to runtime and add local bash permissions settings
 | 
			
		||||
 | 
			
		||||
- Moved '@push.rocks/smartdiff' from devDependencies to dependencies in package.json
 | 
			
		||||
- Added .claude/settings.local.json with allowed bash commands (grep, mkdir, find, ls)
 | 
			
		||||
 | 
			
		||||
## 2025-05-19 - 1.16.0 - feat(format)
 | 
			
		||||
 | 
			
		||||
Enhance format module with rollback, diff reporting, and improved parallel execution
 | 
			
		||||
 | 
			
		||||
- Implemented rollback functionality with backup management and automatic rollback on error
 | 
			
		||||
@@ -68,12 +247,14 @@ Enhance format module with rollback, diff reporting, and improved parallel execu
 | 
			
		||||
- Updated package.json to include new dependency '@push.rocks/smartdiff'
 | 
			
		||||
 | 
			
		||||
## 2025-05-14 - 1.15.5 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc to ^1.5.0 and @types/node to ^22.15.18
 | 
			
		||||
 | 
			
		||||
- Bumped @git.zone/tsdoc from ^1.4.5 to ^1.5.0
 | 
			
		||||
- Bumped @types/node from ^22.15.17 to ^22.15.18
 | 
			
		||||
 | 
			
		||||
## 2025-05-13 - 1.15.4 - fix(package.json)
 | 
			
		||||
 | 
			
		||||
Update dependency versions: bump @git.zone/tsdoc, @push.rocks/lik, @push.rocks/smartlog, and @types/node to their latest releases
 | 
			
		||||
 | 
			
		||||
- Upgrade @git.zone/tsdoc from ^1.4.4 to ^1.4.5
 | 
			
		||||
@@ -82,6 +263,7 @@ Update dependency versions: bump @git.zone/tsdoc, @push.rocks/lik, @push.rocks/s
 | 
			
		||||
- Upgrade @types/node from ^22.14.1 to ^22.15.17
 | 
			
		||||
 | 
			
		||||
## 2025-04-15 - 1.15.3 - fix(deps)
 | 
			
		||||
 | 
			
		||||
update dependency versions and improve website template variable handling
 | 
			
		||||
 | 
			
		||||
- Bumped @git.zone/tsbuild from ^2.2.1 to ^2.3.2 and @types/node to ^22.14.1
 | 
			
		||||
@@ -89,56 +271,65 @@ update dependency versions and improve website template variable handling
 | 
			
		||||
- Refactored website template update to correctly supply variables with added logging
 | 
			
		||||
 | 
			
		||||
## 2025-04-15 - 1.15.2 - fix(website_update)
 | 
			
		||||
 | 
			
		||||
Await supplyVariables call in website update template
 | 
			
		||||
 | 
			
		||||
- Changed website template update to properly await the supplyVariables method
 | 
			
		||||
- Ensured asynchronous consistency in updating website template variables
 | 
			
		||||
 | 
			
		||||
## 2025-04-15 - 1.15.1 - fix(cli)
 | 
			
		||||
 | 
			
		||||
Refresh internal CLI tooling and configuration for consistency.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## 2025-04-15 - 1.15.0 - feat(config/template)
 | 
			
		||||
 | 
			
		||||
Add assetbrokerUrl and legalUrl fields to module config and update website template to supply these values
 | 
			
		||||
 | 
			
		||||
- Added assetbrokerUrl and legalUrl properties in ts/classes.gitzoneconfig.ts
 | 
			
		||||
- Updated ts/mod_format/format.templates.ts to pass assetbrokerUrl and legalUrl to website template
 | 
			
		||||
 | 
			
		||||
## 2025-04-15 - 1.14.1 - fix(package.json)
 | 
			
		||||
 | 
			
		||||
Add packageManager field to specify pnpm version for consistent package management
 | 
			
		||||
 | 
			
		||||
- Inserted packageManager property in package.json with pnpm version info to ensure reproducible dependency installs
 | 
			
		||||
 | 
			
		||||
## 2025-04-15 - 1.14.0 - feat(tsconfig_update)
 | 
			
		||||
 | 
			
		||||
Add runafter directive to trigger gitzone format after tsconfig update
 | 
			
		||||
 | 
			
		||||
- Added runafter configuration in assets/templates/tsconfig_update/.smartscaf.yml to automate formatting task
 | 
			
		||||
 | 
			
		||||
## 2025-03-07 - 1.13.1 - fix(cli)
 | 
			
		||||
 | 
			
		||||
Improve commit message logging
 | 
			
		||||
 | 
			
		||||
- Updated logging to display recommended next commit details.
 | 
			
		||||
- Enabled interactive prompt for choosing commit type and scope.
 | 
			
		||||
 | 
			
		||||
## 2025-02-28 - 1.13.0 - feat(templates)
 | 
			
		||||
 | 
			
		||||
Updated and added new TypeScript template files for npm projects
 | 
			
		||||
 | 
			
		||||
- Added new paths.ts and plugins.ts template files for npm projects.
 | 
			
		||||
- Removed outdated some.plugins.ts template file.
 | 
			
		||||
 | 
			
		||||
## 2025-02-25 - 1.12.8 - fix(metadata)
 | 
			
		||||
 | 
			
		||||
Updated package and npmextra json description and keywords for enhanced development workflow clarity
 | 
			
		||||
 | 
			
		||||
- Updated the description in package.json to focus on project setup and management.
 | 
			
		||||
- Aligned the keywords in both package.json and npmextra.json to include more relevant terms such as gitzone utilities, template management, and CI/CD.
 | 
			
		||||
 | 
			
		||||
## 2025-02-25 - 1.12.7 - fix(meta)
 | 
			
		||||
 | 
			
		||||
Fix issues in project metadata and configuration.
 | 
			
		||||
 | 
			
		||||
- Updated package metadata to ensure accurate project description and licensing.
 | 
			
		||||
- Ensured npm access level configuration consistency within npmextra.json.
 | 
			
		||||
 | 
			
		||||
## 2025-02-25 - 1.12.7 - fix(ci)
 | 
			
		||||
 | 
			
		||||
Updated dependencies and added CI/CD workflows.
 | 
			
		||||
 | 
			
		||||
- Updated several dependencies in package.json for compatibility and security.
 | 
			
		||||
@@ -147,6 +338,7 @@ Updated dependencies and added CI/CD workflows.
 | 
			
		||||
- Ensured consistent formatting with Prettier and TypeScript configurations.
 | 
			
		||||
 | 
			
		||||
## 2025-01-29 - 1.12.6 - fix(project)
 | 
			
		||||
 | 
			
		||||
Minor fixes and cleanup
 | 
			
		||||
 | 
			
		||||
- Removed outdated pages/ directory entry in .gitignore.
 | 
			
		||||
@@ -155,6 +347,7 @@ Minor fixes and cleanup
 | 
			
		||||
- Fixed formatting issues across various TypeScript files.
 | 
			
		||||
 | 
			
		||||
## 2025-01-29 - 1.12.5 - fix(cli)
 | 
			
		||||
 | 
			
		||||
Initial implementation of CLI utility with project management features
 | 
			
		||||
 | 
			
		||||
- Integration of various plugins for logging, command-line interactions, and project management.
 | 
			
		||||
@@ -162,34 +355,40 @@ Initial implementation of CLI utility with project management features
 | 
			
		||||
- Implement commands for packaging, versioning, and deprecating npm packages.
 | 
			
		||||
 | 
			
		||||
## 2025-01-29 - 1.12.2 - fix(format)
 | 
			
		||||
 | 
			
		||||
Add overrides for peek-readable in package.json formatting
 | 
			
		||||
 | 
			
		||||
- Added a URL correction in the packageJson repository information.
 | 
			
		||||
- Introduced support for pnpm overrides by including an `overrides.json` file.
 | 
			
		||||
 | 
			
		||||
## 2025-01-18 - 1.12.1 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update various package dependencies and Dockerfile base image
 | 
			
		||||
 | 
			
		||||
- Updated Dockerfile base image from 'alpinenpmci' to 'alpine_npmci'.
 | 
			
		||||
- Upgraded @git.zone/tsbuild, @git.zone/tsrun, @git.zone/tsdoc, and other dependencies to their latest versions.
 | 
			
		||||
 | 
			
		||||
## 2025-01-17 - 1.12.0 - feat(build)
 | 
			
		||||
 | 
			
		||||
Update TypeScript configuration to support emit decorator metadata
 | 
			
		||||
 | 
			
		||||
- Added emitDecoratorMetadata to the tsconfig.json template in assets/templates/tsconfig_update.
 | 
			
		||||
 | 
			
		||||
## 2025-01-08 - 1.11.0 - feat(cli)
 | 
			
		||||
 | 
			
		||||
Add Docker command for cleaning up Docker system and extend deprecation command for multiple registries
 | 
			
		||||
 | 
			
		||||
- Added a new command 'docker' to handle Docker system cleanup operations.
 | 
			
		||||
- Improved the 'deprecate' command to support deprecating packages across multiple npm registry URLs.
 | 
			
		||||
 | 
			
		||||
## 2025-01-01 - 1.10.10 - fix(templates)
 | 
			
		||||
 | 
			
		||||
Corrected typo in template file comment
 | 
			
		||||
 | 
			
		||||
- Fixed repeated comment in the template file for services under 'assets/templates/service/ts/some.plugins.ts'.
 | 
			
		||||
 | 
			
		||||
## 2025-01-01 - 1.10.9 - fix(templates)
 | 
			
		||||
 | 
			
		||||
Correct template file paths and organization for service projects
 | 
			
		||||
 | 
			
		||||
- Moved 'some.classes.some.ts' to 'classes.some.ts'
 | 
			
		||||
@@ -197,60 +396,70 @@ Correct template file paths and organization for service projects
 | 
			
		||||
- Resolved incorrect import paths in service templates
 | 
			
		||||
 | 
			
		||||
## 2025-01-01 - 1.10.8 - fix(assets/templates)
 | 
			
		||||
 | 
			
		||||
Update CI template configurations to use module.githost
 | 
			
		||||
 | 
			
		||||
- Replaced occurrences of {{git.host}} with {{module.githost}} in CI workflow files
 | 
			
		||||
- Updated package dependencies for service template
 | 
			
		||||
 | 
			
		||||
## 2024-12-26 - 1.10.7 - fix(assets)
 | 
			
		||||
 | 
			
		||||
Correct URLs in templates and fix TypeScript declaration
 | 
			
		||||
 | 
			
		||||
- Updated incorrect URLs in Dockerfile templates to 'host.today'.
 | 
			
		||||
- Fixed type declaration for 'TemplateResult' in header.ts file.
 | 
			
		||||
 | 
			
		||||
## 2024-12-08 - 1.10.6 - fix(ci)
 | 
			
		||||
 | 
			
		||||
Corrected Docker image URL in CI templates
 | 
			
		||||
 | 
			
		||||
- Updated Docker image URL from 'code.foss.global/hosttoday' to 'code.foss.global/host.today' in default_nottags.yaml and default_tags.yaml.
 | 
			
		||||
- Adjusted gitignore template to include a custom section delineation.
 | 
			
		||||
 | 
			
		||||
## 2024-12-02 - 1.10.5 - fix(assets)
 | 
			
		||||
 | 
			
		||||
Update .gitignore template to remove pages directory
 | 
			
		||||
 | 
			
		||||
- Removed 'pages/' from the ignored directories in the .gitignore template.
 | 
			
		||||
 | 
			
		||||
## 2024-11-05 - 1.10.4 - fix(mod_format)
 | 
			
		||||
 | 
			
		||||
Correct file extension for TypeScript path configuration
 | 
			
		||||
 | 
			
		||||
- Fixed the TypeScript configuration to use correct file extensions for module subdirectories.
 | 
			
		||||
 | 
			
		||||
## 2024-10-27 - 1.10.3 - fix(mod_format)
 | 
			
		||||
 | 
			
		||||
Reorder TypeScript formatting steps in mod_format module
 | 
			
		||||
 | 
			
		||||
- Moved TypeScript configuration formatting earlier in the sequence for better logical consistency.
 | 
			
		||||
 | 
			
		||||
## 2024-10-27 - 1.10.2 - fix(format)
 | 
			
		||||
 | 
			
		||||
Add logging for tsconfig.json formatting
 | 
			
		||||
 | 
			
		||||
- Added an info log message for tsconfig.json formatting in format.tsconfig.ts.
 | 
			
		||||
 | 
			
		||||
## 2024-10-27 - 1.10.1 - fix(format)
 | 
			
		||||
 | 
			
		||||
Fixed async issue in tsconfig module lookup and corrected property access
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## 2024-10-27 - 1.10.0 - feat(mod_format)
 | 
			
		||||
 | 
			
		||||
Add support for tsconfig.json formatting
 | 
			
		||||
 | 
			
		||||
- Added a new script to format tsconfig.json.
 | 
			
		||||
- Updated package.json to include `@git.zone/tspublish` as a dependency.
 | 
			
		||||
 | 
			
		||||
## 2024-10-23 - 1.9.126 - fix(format)
 | 
			
		||||
 | 
			
		||||
Remove redundant package.json property checks
 | 
			
		||||
 | 
			
		||||
- Removed property checks for `main`, `typings`, and `browserslist` from format.packagejson.ts
 | 
			
		||||
- This change streamlines the formatting process by removing unnecessary exits
 | 
			
		||||
 | 
			
		||||
## 2024-09-29 - 1.9.125 - fix(cli)
 | 
			
		||||
 | 
			
		||||
Fix package version configuration and formatting issues
 | 
			
		||||
 | 
			
		||||
- Updated metadata fields in package.json (repository URL, bugs URL, and homepage).
 | 
			
		||||
@@ -258,15 +467,17 @@ Fix package version configuration and formatting issues
 | 
			
		||||
- Added missing Prettier default TypeScript and Markdown configurations.
 | 
			
		||||
 | 
			
		||||
## 2024-09-27 - 1.9.124 - fix(cli)
 | 
			
		||||
 | 
			
		||||
Ensured proper existence and initialization of readme files
 | 
			
		||||
 | 
			
		||||
- Ensured readme.md and readme.hints.md files are created and initialized if they do not exist.
 | 
			
		||||
 | 
			
		||||
## 2024-09-27 - 1.9.123 - fix(core)
 | 
			
		||||
 | 
			
		||||
No changes detected
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## 2024-09-27 - 1.9.123 - fix(core)
 | 
			
		||||
 | 
			
		||||
Update dependencies and improve build configurations
 | 
			
		||||
 | 
			
		||||
- Updated several dependencies in package.json for better compatibility
 | 
			
		||||
@@ -277,88 +488,111 @@ Update dependencies and improve build configurations
 | 
			
		||||
- Provided initial structure for readme and readme hints
 | 
			
		||||
 | 
			
		||||
## 2024-06-24 - 1.9.122 - fix(mod_commit)
 | 
			
		||||
 | 
			
		||||
Update package.json dependencies: @git.zone/tsdoc and @push.rocks/smartpromise to latest versions.
 | 
			
		||||
 | 
			
		||||
- - Updated @git.zone/tsdoc to ^1.3.12
 | 
			
		||||
- - Updated @push.rocks/smartfile to ^11.0.21
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.121 - fix(mod_commit)
 | 
			
		||||
 | 
			
		||||
Fix changelog template rendering by removing extra new line when no version details are provided.
 | 
			
		||||
 | 
			
		||||
- Update package.json dependencies: @git.zone/tsdoc and @push.rocks/smartpromise to latest versions.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.120 - fix(mod_commit)
 | 
			
		||||
 | 
			
		||||
Handle edge case for empty version details in changelog formatting
 | 
			
		||||
 | 
			
		||||
- Added check for the length of the recommendedNextVersionDetails array
 | 
			
		||||
- Ensure no extra newline in changelog if there are no version details
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.119 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc to v1.3.8
 | 
			
		||||
 | 
			
		||||
- Updated @git.zone/tsdoc from v1.3.7 to v1.3.8 in package.json
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.118 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc to version 1.3.7
 | 
			
		||||
 | 
			
		||||
- Bump @git.zone/tsdoc from 1.3.6 to 1.3.7 in both package.json and pnpm-lock.yaml
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.117 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc dependency to v1.3.6
 | 
			
		||||
 | 
			
		||||
- Updated @git.zone/tsdoc version from 1.3.5 to 1.3.6 in package.json
 | 
			
		||||
- Updated pnpm-lock.yaml to reflect the new version of @git.zone/tsdoc
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.116 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc to version 1.3.5
 | 
			
		||||
 | 
			
		||||
- Updated the @git.zone/tsdoc dependency in package.json and pnpm-lock.yaml from version 1.3.4 to 1.3.5
 | 
			
		||||
- Removed the outdated changelog.md file.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.114 - fix(format)
 | 
			
		||||
 | 
			
		||||
Fixed formatting issues across multiple TypeScript files.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.113 - fix(mod_commit)
 | 
			
		||||
 | 
			
		||||
Remove extra new lines in changelog.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.112 - fix(core)
 | 
			
		||||
 | 
			
		||||
Update changelog formatting and remove outdated entries.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.111 - fix(changelog)
 | 
			
		||||
 | 
			
		||||
Remove outdated changelog entries and update formatting.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.110 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc to version 1.3.4.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.109 - fix(changelog)
 | 
			
		||||
 | 
			
		||||
Remove outdated entries and adjust formatting in changelog.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.108 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Update @git.zone/tsdoc dependency to version 1.3.2.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.107 - fix(changelog)
 | 
			
		||||
 | 
			
		||||
Remove placeholder entries and adjust formatting in changelog.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.106 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Updated @git.zone/tsdoc from version 1.3.0 to 1.3.1.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.105 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Updated @git.zone/tsdoc dependency from 1.2.2 to 1.3.0 in package.json and pnpm-lock.yaml.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.104 - fix(changelog)
 | 
			
		||||
 | 
			
		||||
Remove placeholder entries and adjust formatting in changelog.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.103 - fix(changelog)
 | 
			
		||||
 | 
			
		||||
Fix changelog to remove placeholder entries and adjust formatting.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.102 - fix(logging)
 | 
			
		||||
 | 
			
		||||
Optimize logger instantiation and configuration.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.101 - fix(metadata)
 | 
			
		||||
 | 
			
		||||
Ensure accurate project metadata in package.json.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.100 - fix(dependencies)
 | 
			
		||||
 | 
			
		||||
Updated @git.zone/tsdoc dependency version to ^1.2.2 in package.json and pnpm-lock.yaml.
 | 
			
		||||
 | 
			
		||||
## 2024-06-23 - 1.9.99 - fix(mod_commit)
 | 
			
		||||
 | 
			
		||||
Fix variable reassignment issue in changelog writing step.
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										47
									
								
								package.json
									
									
									
									
									
								
							
							
						
						
									
										47
									
								
								package.json
									
									
									
									
									
								
							@@ -1,7 +1,7 @@
 | 
			
		||||
{
 | 
			
		||||
  "name": "@git.zone/cli",
 | 
			
		||||
  "private": false,
 | 
			
		||||
  "version": "1.16.8",
 | 
			
		||||
  "version": "1.19.3",
 | 
			
		||||
  "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.",
 | 
			
		||||
  "main": "dist_ts/index.ts",
 | 
			
		||||
  "typings": "dist_ts/index.d.ts",
 | 
			
		||||
@@ -57,44 +57,45 @@
 | 
			
		||||
  },
 | 
			
		||||
  "homepage": "https://gitlab.com/gitzone/private/gitzone#readme",
 | 
			
		||||
  "devDependencies": {
 | 
			
		||||
    "@git.zone/tsbuild": "^2.3.2",
 | 
			
		||||
    "@git.zone/tsrun": "^1.3.3",
 | 
			
		||||
    "@git.zone/tstest": "^1.0.96",
 | 
			
		||||
    "@git.zone/tsbuild": "^2.7.1",
 | 
			
		||||
    "@git.zone/tsrun": "^1.6.2",
 | 
			
		||||
    "@git.zone/tstest": "^2.7.0",
 | 
			
		||||
    "@push.rocks/smartdelay": "^3.0.5",
 | 
			
		||||
    "@push.rocks/smartfile": "^11.2.7",
 | 
			
		||||
    "@push.rocks/smartinteract": "^2.0.16",
 | 
			
		||||
    "@push.rocks/smartnetwork": "^4.4.0",
 | 
			
		||||
    "@push.rocks/smartshell": "^3.3.0",
 | 
			
		||||
    "@types/node": "^22.15.18"
 | 
			
		||||
  },
 | 
			
		||||
  "dependencies": {
 | 
			
		||||
    "@git.zone/tsdoc": "^1.5.0",
 | 
			
		||||
    "@git.zone/tspublish": "^1.9.1",
 | 
			
		||||
    "@git.zone/tsdoc": "^1.8.0",
 | 
			
		||||
    "@git.zone/tspublish": "^1.10.3",
 | 
			
		||||
    "@push.rocks/commitinfo": "^1.0.12",
 | 
			
		||||
    "@push.rocks/early": "^4.0.4",
 | 
			
		||||
    "@push.rocks/gulp-function": "^3.0.7",
 | 
			
		||||
    "@push.rocks/lik": "^6.2.2",
 | 
			
		||||
    "@push.rocks/npmextra": "^5.1.2",
 | 
			
		||||
    "@push.rocks/npmextra": "^5.3.3",
 | 
			
		||||
    "@push.rocks/projectinfo": "^5.0.2",
 | 
			
		||||
    "@push.rocks/smartchok": "^1.0.34",
 | 
			
		||||
    "@push.rocks/smartcli": "^4.0.11",
 | 
			
		||||
    "@push.rocks/smartdelay": "^3.0.5",
 | 
			
		||||
    "@push.rocks/smartchok": "^1.1.1",
 | 
			
		||||
    "@push.rocks/smartcli": "^4.0.19",
 | 
			
		||||
    "@push.rocks/smartdiff": "^1.0.3",
 | 
			
		||||
    "@push.rocks/smartfile": "^11.2.0",
 | 
			
		||||
    "@push.rocks/smartgulp": "^3.0.4",
 | 
			
		||||
    "@push.rocks/smartinteract": "^2.0.15",
 | 
			
		||||
    "@push.rocks/smartjson": "^5.0.20",
 | 
			
		||||
    "@push.rocks/smartjson": "^5.2.0",
 | 
			
		||||
    "@push.rocks/smartlegal": "^1.0.27",
 | 
			
		||||
    "@push.rocks/smartlog": "^3.0.9",
 | 
			
		||||
    "@push.rocks/smartlog": "^3.1.10",
 | 
			
		||||
    "@push.rocks/smartlog-destination-local": "^9.0.2",
 | 
			
		||||
    "@push.rocks/smartmustache": "^3.0.2",
 | 
			
		||||
    "@push.rocks/smartnpm": "^2.0.4",
 | 
			
		||||
    "@push.rocks/smartnpm": "^2.0.6",
 | 
			
		||||
    "@push.rocks/smartobject": "^1.0.12",
 | 
			
		||||
    "@push.rocks/smartopen": "^2.0.0",
 | 
			
		||||
    "@push.rocks/smartpath": "^5.0.18",
 | 
			
		||||
    "@push.rocks/smartpath": "^6.0.0",
 | 
			
		||||
    "@push.rocks/smartpromise": "^4.2.3",
 | 
			
		||||
    "@push.rocks/smartscaf": "^4.0.16",
 | 
			
		||||
    "@push.rocks/smartshell": "^3.2.3",
 | 
			
		||||
    "@push.rocks/smartscaf": "^4.0.19",
 | 
			
		||||
    "@push.rocks/smartstream": "^3.2.5",
 | 
			
		||||
    "@push.rocks/smartunique": "^3.0.9",
 | 
			
		||||
    "@push.rocks/smartupdate": "^2.0.6",
 | 
			
		||||
    "@types/through2": "^2.0.41",
 | 
			
		||||
    "prettier": "^3.5.3",
 | 
			
		||||
    "prettier": "^3.6.2",
 | 
			
		||||
    "through2": "^4.0.2"
 | 
			
		||||
  },
 | 
			
		||||
  "files": [
 | 
			
		||||
@@ -113,7 +114,13 @@
 | 
			
		||||
    "last 1 chrome versions"
 | 
			
		||||
  ],
 | 
			
		||||
  "pnpm": {
 | 
			
		||||
    "overrides": {}
 | 
			
		||||
    "overrides": {},
 | 
			
		||||
    "onlyBuiltDependencies": [
 | 
			
		||||
      "esbuild",
 | 
			
		||||
      "mongodb-memory-server",
 | 
			
		||||
      "puppeteer",
 | 
			
		||||
      "sharp"
 | 
			
		||||
    ]
 | 
			
		||||
  },
 | 
			
		||||
  "packageManager": "pnpm@10.7.0+sha512.6b865ad4b62a1d9842b61d674a393903b871d9244954f652b8842c2b553c72176b278f64c463e52d40fff8aba385c235c8c9ecf5cc7de4fd78b8bb6d49633ab6"
 | 
			
		||||
}
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										8733
									
								
								pnpm-lock.yaml
									
									
									
										generated
									
									
									
								
							
							
						
						
									
										8733
									
								
								pnpm-lock.yaml
									
									
									
										generated
									
									
									
								
							
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							@@ -1,10 +1,11 @@
 | 
			
		||||
# Gitzone CLI - Development Hints
 | 
			
		||||
 | 
			
		||||
* the cli of the git.zone project.
 | 
			
		||||
- the cli of the git.zone project.
 | 
			
		||||
 | 
			
		||||
## Project Overview
 | 
			
		||||
 | 
			
		||||
Gitzone CLI (`@git.zone/cli`) is a comprehensive toolbelt for streamlining local development cycles. It provides utilities for:
 | 
			
		||||
 | 
			
		||||
- Project initialization and templating (via smartscaf)
 | 
			
		||||
- Code formatting and standardization
 | 
			
		||||
- Version control and commit management
 | 
			
		||||
@@ -14,12 +15,14 @@ Gitzone CLI (`@git.zone/cli`) is a comprehensive toolbelt for streamlining local
 | 
			
		||||
## Architecture
 | 
			
		||||
 | 
			
		||||
### Core Structure
 | 
			
		||||
 | 
			
		||||
- Main CLI entry: `cli.ts` / `cli.child.ts`
 | 
			
		||||
- Modular architecture with separate modules in `ts/mod_*` directories
 | 
			
		||||
- Each module handles specific functionality (format, commit, docker, etc.)
 | 
			
		||||
- Extensive use of plugins pattern via `plugins.ts` files
 | 
			
		||||
 | 
			
		||||
### Configuration Management
 | 
			
		||||
 | 
			
		||||
- Uses `npmextra.json` for all tool configuration
 | 
			
		||||
- Configuration stored under `gitzone` key in npmextra
 | 
			
		||||
- No separate `.gitzonerc` file - everything in npmextra.json
 | 
			
		||||
@@ -30,6 +33,7 @@ Gitzone CLI (`@git.zone/cli`) is a comprehensive toolbelt for streamlining local
 | 
			
		||||
The format module is responsible for project standardization:
 | 
			
		||||
 | 
			
		||||
#### Current Modules:
 | 
			
		||||
 | 
			
		||||
1. **cleanup** - Removes obsolete files (yarn.lock, tslint.json, etc.)
 | 
			
		||||
2. **copy** - File copying with glob patterns (fully implemented)
 | 
			
		||||
3. **gitignore** - Creates/updates .gitignore from templates
 | 
			
		||||
@@ -42,6 +46,7 @@ The format module is responsible for project standardization:
 | 
			
		||||
10. **tsconfig** - Formats TypeScript configuration
 | 
			
		||||
 | 
			
		||||
#### Execution Order (Dependency-Based):
 | 
			
		||||
 | 
			
		||||
- Modules are now executed in parallel groups based on dependencies
 | 
			
		||||
- Independent modules run concurrently for better performance
 | 
			
		||||
- Dependency analyzer ensures correct execution order
 | 
			
		||||
@@ -182,7 +187,7 @@ gitzone format --clean-backups
 | 
			
		||||
 | 
			
		||||
## API Changes
 | 
			
		||||
 | 
			
		||||
- smartfile API updated to use fs.* and memory.* namespaces
 | 
			
		||||
- smartfile API updated to use fs._ and memory._ namespaces
 | 
			
		||||
- smartnpm requires instance creation: `new NpmRegistry()`
 | 
			
		||||
- All file operations now use updated APIs
 | 
			
		||||
- Type imports use `import type` for proper verbatim module syntax
 | 
			
		||||
							
								
								
									
										164
									
								
								readme.md
									
									
									
									
									
								
							
							
						
						
									
										164
									
								
								readme.md
									
									
									
									
									
								
							@@ -7,7 +7,7 @@
 | 
			
		||||
 | 
			
		||||
## 🎯 What is gitzone?
 | 
			
		||||
 | 
			
		||||
gitzone is a powerful command-line interface that supercharges your development workflow with automated project management, intelligent code formatting, and seamless version control. Whether you're bootstrapping a new TypeScript project, maintaining code quality, or managing complex multi-repository setups, gitzone has got you covered.
 | 
			
		||||
gitzone is a powerful command-line interface that supercharges your development workflow with automated project management, intelligent code formatting, seamless version control, and development service orchestration. Whether you're bootstrapping a new TypeScript project, maintaining code quality, managing complex multi-repository setups, or spinning up local development databases, gitzone has got you covered.
 | 
			
		||||
 | 
			
		||||
## 🏃♂️ Quick Start
 | 
			
		||||
 | 
			
		||||
@@ -23,7 +23,7 @@ pnpm add -g @git.zone/cli
 | 
			
		||||
 | 
			
		||||
Once installed, you can use either `gitzone` or the shorter `gzone` command from anywhere in your terminal.
 | 
			
		||||
 | 
			
		||||
### Your First Command
 | 
			
		||||
### Your First Commands
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# Create a new TypeScript npm package
 | 
			
		||||
@@ -32,12 +32,66 @@ gitzone template npm
 | 
			
		||||
# Format your entire codebase
 | 
			
		||||
gitzone format
 | 
			
		||||
 | 
			
		||||
# Start local MongoDB and MinIO services
 | 
			
		||||
gitzone services start
 | 
			
		||||
 | 
			
		||||
# Create a semantic commit
 | 
			
		||||
gitzone commit
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## 🛠️ Core Features
 | 
			
		||||
 | 
			
		||||
### 🐳 Development Services Management (NEW!)
 | 
			
		||||
 | 
			
		||||
Effortlessly manage local MongoDB and MinIO (S3-compatible) services for your development environment:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
gitzone services [command]
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
**Available commands:**
 | 
			
		||||
 | 
			
		||||
- **`start [service]`** - Start services (mongo|s3|all)
 | 
			
		||||
- **`stop [service]`** - Stop services (mongo|s3|all)
 | 
			
		||||
- **`restart [service]`** - Restart services
 | 
			
		||||
- **`status`** - Show current service status
 | 
			
		||||
- **`config`** - Display configuration details
 | 
			
		||||
- **`compass`** - Get MongoDB Compass connection string with network IP
 | 
			
		||||
- **`logs [service] [lines]`** - View service logs
 | 
			
		||||
- **`remove`** - Remove containers (preserves data)
 | 
			
		||||
- **`clean`** - Remove containers AND data (⚠️ destructive)
 | 
			
		||||
 | 
			
		||||
**Key features:**
 | 
			
		||||
 | 
			
		||||
- 🎲 **Smart port assignment** - Automatically assigns random ports (20000-30000) to avoid conflicts
 | 
			
		||||
- 📦 **Project isolation** - Each project gets its own containers with unique names
 | 
			
		||||
- 💾 **Data persistence** - Data stored in `.nogit/` directories survives container restarts
 | 
			
		||||
- 🔗 **MongoDB Compass support** - Instantly get connection strings for GUI access
 | 
			
		||||
- 🌐 **Network IP detection** - Automatically detects your local network IP for remote connections
 | 
			
		||||
- ⚙️ **Auto-configuration** - Creates `.nogit/env.json` with smart defaults
 | 
			
		||||
 | 
			
		||||
**Example workflow:**
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# Start all services for your project
 | 
			
		||||
gitzone services start
 | 
			
		||||
 | 
			
		||||
# Check what's running
 | 
			
		||||
gitzone services status
 | 
			
		||||
 | 
			
		||||
# Get MongoDB Compass connection string
 | 
			
		||||
gitzone services compass
 | 
			
		||||
# Output: mongodb://defaultadmin:defaultpass@192.168.1.100:27018/myproject?authSource=admin
 | 
			
		||||
 | 
			
		||||
# View MongoDB logs
 | 
			
		||||
gitzone services logs mongo 50
 | 
			
		||||
 | 
			
		||||
# Stop services when done
 | 
			
		||||
gitzone services stop
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The services are configured via `.nogit/env.json` which is automatically created with secure defaults and random ports for each project.
 | 
			
		||||
 | 
			
		||||
### 📦 Project Templates
 | 
			
		||||
 | 
			
		||||
Instantly scaffold production-ready projects with best practices built-in:
 | 
			
		||||
@@ -47,12 +101,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
 | 
			
		||||
- **`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 +137,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 +145,7 @@ gitzone format --verbose
 | 
			
		||||
- 🎯 **Module-specific formatting** - Target specific formatters
 | 
			
		||||
 | 
			
		||||
**Rollback capabilities:**
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# List all available backups
 | 
			
		||||
gitzone format --list-backups
 | 
			
		||||
@@ -103,6 +161,7 @@ gitzone format --clean-backups
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
**Formatters included:**
 | 
			
		||||
 | 
			
		||||
- **Prettier** - JavaScript/TypeScript code formatting
 | 
			
		||||
- **License** - Ensure proper licensing
 | 
			
		||||
- **Package.json** - Standardize package configurations
 | 
			
		||||
@@ -121,6 +180,7 @@ gitzone commit
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Features:
 | 
			
		||||
 | 
			
		||||
- 📝 Interactive commit message builder
 | 
			
		||||
- 🏷️ Automatic version bumping (major/minor/patch)
 | 
			
		||||
- 📜 Changelog generation
 | 
			
		||||
@@ -128,6 +188,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 +214,7 @@ gitzone meta remove [name]
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Perfect for:
 | 
			
		||||
 | 
			
		||||
- Monorepo management
 | 
			
		||||
- Multi-package projects
 | 
			
		||||
- Coordinated deployments
 | 
			
		||||
@@ -168,6 +230,7 @@ gitzone docker prune
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
This command removes:
 | 
			
		||||
 | 
			
		||||
- Stopped containers
 | 
			
		||||
- Unused images
 | 
			
		||||
- Dangling volumes
 | 
			
		||||
@@ -196,6 +259,7 @@ gitzone deprecate
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Interactive wizard for:
 | 
			
		||||
 | 
			
		||||
- Setting deprecation notices
 | 
			
		||||
- Guiding users to replacements
 | 
			
		||||
- Updating registry metadata
 | 
			
		||||
@@ -210,6 +274,7 @@ gitzone start
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Automatically:
 | 
			
		||||
 | 
			
		||||
- Checks out master branch
 | 
			
		||||
- Pulls latest changes
 | 
			
		||||
- Installs dependencies
 | 
			
		||||
@@ -266,44 +331,58 @@ 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`
 | 
			
		||||
2. Set up local services: `gitzone services start`
 | 
			
		||||
3. Customize the generated structure
 | 
			
		||||
4. Run initial format: `gitzone format`
 | 
			
		||||
5. 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`
 | 
			
		||||
4. Set up services: `gitzone services start`
 | 
			
		||||
5. 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
 | 
			
		||||
4. Standardize commit conventions
 | 
			
		||||
2. Share `.nogit/env.json` template for consistent service setup
 | 
			
		||||
3. Use `--save-plan` for reviewable format changes
 | 
			
		||||
4. Enable rollback for safety
 | 
			
		||||
5. Standardize commit conventions
 | 
			
		||||
 | 
			
		||||
## 🎯 Common Workflows
 | 
			
		||||
 | 
			
		||||
### Clean Development Cycle
 | 
			
		||||
### Full-Stack Development Cycle
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# 1. Start fresh
 | 
			
		||||
gitzone start
 | 
			
		||||
 | 
			
		||||
# 2. Make changes
 | 
			
		||||
# 2. Spin up databases and services
 | 
			
		||||
gitzone services start
 | 
			
		||||
 | 
			
		||||
# 3. Make changes
 | 
			
		||||
# ... your development work ...
 | 
			
		||||
 | 
			
		||||
# 3. Format code
 | 
			
		||||
# 4. Check service logs if needed
 | 
			
		||||
gitzone services logs mongo
 | 
			
		||||
 | 
			
		||||
# 5. Format code
 | 
			
		||||
gitzone format
 | 
			
		||||
 | 
			
		||||
# 4. Commit with semantic versioning
 | 
			
		||||
# 6. Commit with semantic versioning
 | 
			
		||||
gitzone commit
 | 
			
		||||
 | 
			
		||||
# 5. Deploy (if CI/CD configured)
 | 
			
		||||
# Automatic via git push
 | 
			
		||||
# 7. Stop services when done
 | 
			
		||||
gitzone services stop
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Multi-Repository Management
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# 1. Set up meta repository
 | 
			
		||||
gitzone meta init
 | 
			
		||||
@@ -318,6 +397,7 @@ gitzone meta update
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Safe Formatting with Rollback
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# 1. Preview changes
 | 
			
		||||
gitzone format --dry-run
 | 
			
		||||
@@ -332,20 +412,45 @@ gitzone format --from-plan format-changes.json
 | 
			
		||||
gitzone format --rollback
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Database-Driven Development
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# 1. Start MongoDB and MinIO
 | 
			
		||||
gitzone services start
 | 
			
		||||
 | 
			
		||||
# 2. Get connection string for your app
 | 
			
		||||
gitzone services config
 | 
			
		||||
 | 
			
		||||
# 3. Connect with MongoDB Compass
 | 
			
		||||
gitzone services compass
 | 
			
		||||
 | 
			
		||||
# 4. Monitor services
 | 
			
		||||
gitzone services status
 | 
			
		||||
 | 
			
		||||
# 5. Clean everything when done
 | 
			
		||||
gitzone services clean  # ⚠️ Warning: deletes data
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## 🔌 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
 | 
			
		||||
- **MongoDB** - Local database service
 | 
			
		||||
- **MinIO** - S3-compatible object storage
 | 
			
		||||
- **MongoDB Compass** - Database GUI integration
 | 
			
		||||
 | 
			
		||||
### Version Control
 | 
			
		||||
 | 
			
		||||
- **Git** - Deep integration
 | 
			
		||||
- **Semantic Versioning** - Automatic version bumping
 | 
			
		||||
- **Conventional Commits** - Standardized commit messages
 | 
			
		||||
@@ -357,34 +462,63 @@ gitzone format --rollback
 | 
			
		||||
3. **Leverage templates**: Start projects right with proven structures
 | 
			
		||||
4. **Enable caching**: Dramatically speeds up formatting operations
 | 
			
		||||
5. **Save format plans**: Review changes before applying in production
 | 
			
		||||
6. **Port management**: Let services auto-assign ports to avoid conflicts
 | 
			
		||||
7. **Use MongoDB Compass**: `gitzone services compass` for visual DB management
 | 
			
		||||
 | 
			
		||||
## 🐛 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
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Services Won't Start
 | 
			
		||||
 | 
			
		||||
Check for port conflicts:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
# Services auto-assign ports, but you can check the config
 | 
			
		||||
cat .nogit/env.json
 | 
			
		||||
 | 
			
		||||
# Verify Docker is running
 | 
			
		||||
docker ps
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Template Creation Issues
 | 
			
		||||
 | 
			
		||||
Verify npm/pnpm is properly configured:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
npm config get registry
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### MongoDB Connection Issues
 | 
			
		||||
 | 
			
		||||
- Ensure services are running: `gitzone services status`
 | 
			
		||||
- Check firewall settings for the assigned ports
 | 
			
		||||
- Use `gitzone services compass` for the correct connection string
 | 
			
		||||
 | 
			
		||||
## 📈 Performance
 | 
			
		||||
 | 
			
		||||
gitzone is optimized for speed:
 | 
			
		||||
 | 
			
		||||
- **Parallel processing** for format operations
 | 
			
		||||
- **Smart caching** to avoid redundant work
 | 
			
		||||
- **Incremental updates** for meta repositories
 | 
			
		||||
- **Minimal dependencies** for fast installation
 | 
			
		||||
- **Isolated services** prevent resource conflicts
 | 
			
		||||
- **Auto port assignment** eliminates manual configuration
 | 
			
		||||
 | 
			
		||||
## License and Legal Information
 | 
			
		||||
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										257
									
								
								readme.plan.md
									
									
									
									
									
								
							
							
						
						
									
										257
									
								
								readme.plan.md
									
									
									
									
									
								
							@@ -1,170 +1,121 @@
 | 
			
		||||
# Gitzone Format Module Improvement Plan
 | 
			
		||||
 | 
			
		||||
Please reread /home/philkunz/.claude/CLAUDE.md before proceeding with any implementation.
 | 
			
		||||
# GitZone Services Command Implementation Plan
 | 
			
		||||
 | 
			
		||||
## Overview
 | 
			
		||||
This plan outlines improvements for the gitzone format module to enhance its functionality, reliability, and maintainability.
 | 
			
		||||
Implement the `gitzone services` command to manage MongoDB and MinIO containers for development projects.
 | 
			
		||||
 | 
			
		||||
## Phase 1: Core Improvements (High Priority) - COMPLETED ✅
 | 
			
		||||
## Tasks
 | 
			
		||||
 | 
			
		||||
### 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
 | 
			
		||||
- [x] Add transaction-like behavior: all-or-nothing formatting
 | 
			
		||||
- [x] Implement plan → action workflow as default behavior
 | 
			
		||||
### Module Structure Setup
 | 
			
		||||
- [x] Create `ts/mod_services/` directory
 | 
			
		||||
- [x] Create `mod.plugins.ts` with required imports
 | 
			
		||||
- [x] Create `helpers.ts` with utility functions
 | 
			
		||||
- [x] Create `classes.serviceconfiguration.ts` for config handling
 | 
			
		||||
- [x] Create `classes.dockercontainer.ts` for Docker operations
 | 
			
		||||
- [x] Create `classes.servicemanager.ts` for service management
 | 
			
		||||
- [x] Create `index.ts` with main command logic
 | 
			
		||||
 | 
			
		||||
### 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)
 | 
			
		||||
### Core Functionality
 | 
			
		||||
- [x] Implement ServiceConfiguration class
 | 
			
		||||
  - [x] Load/create `.nogit/env.json` configuration
 | 
			
		||||
  - [x] Generate random available ports (20000-30000 range)
 | 
			
		||||
  - [x] Preserve existing custom values
 | 
			
		||||
  - [x] Provide default values for missing fields
 | 
			
		||||
 | 
			
		||||
### 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)
 | 
			
		||||
- [x] Support custom template directories (via configuration)
 | 
			
		||||
- [x] Add format profiles for different project types
 | 
			
		||||
- [x] Implement DockerContainer class
 | 
			
		||||
  - [x] Check container status
 | 
			
		||||
  - [x] Start/stop/restart containers
 | 
			
		||||
  - [x] Execute Docker commands
 | 
			
		||||
  - [x] Handle container logs
 | 
			
		||||
  - [x] Manage volumes and port bindings
 | 
			
		||||
 | 
			
		||||
### 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)
 | 
			
		||||
- [x] Add validation layer before format execution
 | 
			
		||||
- [x] Implement `FormatPlanner` class for plan → action workflow
 | 
			
		||||
- [x] Implement ServiceManager class
 | 
			
		||||
  - [x] Manage MongoDB containers
 | 
			
		||||
  - [x] Manage MinIO containers
 | 
			
		||||
  - [x] Handle container lifecycle
 | 
			
		||||
  - [x] Generate project-specific container names
 | 
			
		||||
  - [x] Manage data directories in `.nogit/`
 | 
			
		||||
  - [x] Generate MongoDB Compass connection strings
 | 
			
		||||
 | 
			
		||||
## Phase 2: Performance & Reporting (Medium Priority) - COMPLETED ✅
 | 
			
		||||
### Commands Implementation
 | 
			
		||||
- [x] `start` command - Start services (mongo|s3|all)
 | 
			
		||||
- [x] `stop` command - Stop services (mongo|s3|all)
 | 
			
		||||
- [x] `restart` command - Restart services (mongo|s3|all)
 | 
			
		||||
- [x] `status` command - Show service status
 | 
			
		||||
- [x] `config` command - Show current configuration
 | 
			
		||||
- [x] `compass` command - Show MongoDB Compass connection string
 | 
			
		||||
- [x] `logs` command - Show service logs with line count
 | 
			
		||||
- [x] `remove` command - Remove containers (preserve data)
 | 
			
		||||
- [x] `clean` command - Remove containers and data
 | 
			
		||||
 | 
			
		||||
### 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
 | 
			
		||||
### Integration
 | 
			
		||||
- [x] Add `@push.rocks/smartshell` to main plugins.ts
 | 
			
		||||
- [x] Add `@push.rocks/smartnetwork` to main plugins.ts
 | 
			
		||||
- [x] Add `@push.rocks/smartinteraction` to main plugins.ts
 | 
			
		||||
- [x] Register services command in `gitzone.cli.ts`
 | 
			
		||||
 | 
			
		||||
### 6. Enhanced Reporting & Visibility ✅
 | 
			
		||||
- [x] Generate comprehensive format report showing all changes
 | 
			
		||||
- [x] Add diff view for file modifications
 | 
			
		||||
- [x] Create verbose logging option
 | 
			
		||||
- [x] Add format statistics (files changed, time taken, etc.)
 | 
			
		||||
### Features
 | 
			
		||||
- [x] Auto-configuration with smart defaults
 | 
			
		||||
- [x] Random port assignment to avoid conflicts
 | 
			
		||||
- [x] Project isolation with unique container names
 | 
			
		||||
- [x] Data persistence in `.nogit/` directories
 | 
			
		||||
- [x] Status display (running/stopped/not installed)
 | 
			
		||||
- [x] Interactive confirmations for destructive operations
 | 
			
		||||
- [x] Colored console output
 | 
			
		||||
- [x] MinIO bucket auto-creation
 | 
			
		||||
- [x] MongoDB Compass connection string with network IP
 | 
			
		||||
 | 
			
		||||
## Phase 3: Advanced Features (Lower Priority) - PARTIALLY COMPLETED
 | 
			
		||||
### Testing
 | 
			
		||||
- [ ] Test service start/stop operations
 | 
			
		||||
- [ ] Test configuration creation and updates
 | 
			
		||||
- [ ] Test port collision handling
 | 
			
		||||
- [ ] Test data persistence
 | 
			
		||||
- [ ] Test MongoDB Compass connection string generation
 | 
			
		||||
- [ ] Test all command variations
 | 
			
		||||
 | 
			
		||||
### 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
 | 
			
		||||
## Configuration Format
 | 
			
		||||
```json
 | 
			
		||||
{
 | 
			
		||||
  "PROJECT_NAME": "derived-from-package-name",
 | 
			
		||||
  "MONGODB_HOST": "localhost",
 | 
			
		||||
  "MONGODB_NAME": "project-name",
 | 
			
		||||
  "MONGODB_PORT": "random-port",
 | 
			
		||||
  "MONGODB_USER": "defaultadmin",
 | 
			
		||||
  "MONGODB_PASS": "defaultpass",
 | 
			
		||||
  "S3_HOST": "localhost",
 | 
			
		||||
  "S3_PORT": "random-port",
 | 
			
		||||
  "S3_CONSOLE_PORT": "s3-port+1",
 | 
			
		||||
  "S3_USER": "defaultadmin",
 | 
			
		||||
  "S3_PASS": "defaultpass",
 | 
			
		||||
  "S3_BUCKET": "project-name-documents"
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### 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
 | 
			
		||||
## Command Examples
 | 
			
		||||
```bash
 | 
			
		||||
gitzone services start          # Start all services
 | 
			
		||||
gitzone services start mongo    # Start only MongoDB
 | 
			
		||||
gitzone services stop           # Stop all services
 | 
			
		||||
gitzone services status         # Check service status
 | 
			
		||||
gitzone services config         # Show configuration
 | 
			
		||||
gitzone services compass        # Show MongoDB Compass connection string
 | 
			
		||||
gitzone services logs mongo 50  # Show last 50 lines of MongoDB logs
 | 
			
		||||
gitzone services remove         # Remove containers (preserve data)
 | 
			
		||||
gitzone services clean          # Remove containers and data
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### 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
 | 
			
		||||
## Progress Notes
 | 
			
		||||
Implementation started: 2025-08-14
 | 
			
		||||
Implementation completed: 2025-08-14
 | 
			
		||||
 | 
			
		||||
### 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
 | 
			
		||||
## Summary
 | 
			
		||||
Successfully implemented the `gitzone services` command in TypeScript, providing a complete replacement for the `services.sh` shell script. The implementation includes:
 | 
			
		||||
 | 
			
		||||
### 11. Quality of Life Improvements ⏳
 | 
			
		||||
- [ ] Interactive mode for format configuration
 | 
			
		||||
- [ ] Undo/redo capability for format operations
 | 
			
		||||
- [ ] Format presets for common scenarios
 | 
			
		||||
- [x] Better progress indicators and user feedback
 | 
			
		||||
1. **Complete Docker service management** for MongoDB and MinIO containers
 | 
			
		||||
2. **Smart configuration management** with automatic port assignment and conflict avoidance
 | 
			
		||||
3. **MongoDB Compass support** with network IP detection for remote connections
 | 
			
		||||
4. **Project isolation** using project-specific container names
 | 
			
		||||
5. **Data persistence** in `.nogit/` directories
 | 
			
		||||
6. **Interactive confirmations** for destructive operations
 | 
			
		||||
7. **Comprehensive command set** including start, stop, restart, status, config, compass, logs, remove, and clean commands
 | 
			
		||||
 | 
			
		||||
## Implementation Status
 | 
			
		||||
 | 
			
		||||
### ✅ 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
 | 
			
		||||
   - Save reports to file
 | 
			
		||||
 | 
			
		||||
6. **Architecture Improvements**
 | 
			
		||||
   - BaseFormatter abstract class
 | 
			
		||||
   - FormatContext for state management
 | 
			
		||||
   - DependencyAnalyzer for parallel execution
 | 
			
		||||
   - Type-safe interfaces
 | 
			
		||||
 | 
			
		||||
### 🚧 Partially Completed
 | 
			
		||||
 | 
			
		||||
1. **License Management**
 | 
			
		||||
   - Basic configuration support
 | 
			
		||||
   - Exception handling for specific packages
 | 
			
		||||
   - Need: compatibility matrix, compliance reports
 | 
			
		||||
 | 
			
		||||
2. **Package.json Management**
 | 
			
		||||
   - Basic ensureDependency implementation
 | 
			
		||||
   - Need: smart sorting, script generation, validation
 | 
			
		||||
 | 
			
		||||
### ⏳ 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
 | 
			
		||||
 | 
			
		||||
3. **Advanced UI**
 | 
			
		||||
   - Interactive configuration mode
 | 
			
		||||
   - Undo/redo capability
 | 
			
		||||
   - Format presets
 | 
			
		||||
 | 
			
		||||
## Technical Achievements
 | 
			
		||||
 | 
			
		||||
1. **Type Safety**: All new code uses TypeScript interfaces and types
 | 
			
		||||
2. **Error Handling**: Comprehensive try-catch blocks with rollback
 | 
			
		||||
3. **API Compatibility**: Updated to use latest smartfile/smartnpm APIs
 | 
			
		||||
4. **Testing**: Ready for comprehensive test suite
 | 
			
		||||
5. **Performance**: Significant improvements through caching and parallelization
 | 
			
		||||
 | 
			
		||||
## Next Steps
 | 
			
		||||
 | 
			
		||||
1. Write comprehensive tests for all new functionality
 | 
			
		||||
2. Create user documentation for new features
 | 
			
		||||
3. Consider plugin API design for extensibility
 | 
			
		||||
4. Implement remaining Phase 3 features based on user feedback
 | 
			
		||||
5. Performance benchmarking and optimization
 | 
			
		||||
 | 
			
		||||
## Success Metrics Achieved
 | 
			
		||||
 | 
			
		||||
- ✅ Reduced error rates through rollback mechanism
 | 
			
		||||
- ✅ Faster execution through parallel processing and caching
 | 
			
		||||
- ✅ Enhanced user control through configuration
 | 
			
		||||
- ✅ Better visibility through reporting and statistics
 | 
			
		||||
- ✅ Improved maintainability through better architecture
 | 
			
		||||
The module is fully integrated into the gitzone CLI and ready for testing.
 | 
			
		||||
							
								
								
									
										1
									
								
								test
									
									
									
									
									
										Submodule
									
								
							
							
								
								
								
								
								
							
						
						
									
										1
									
								
								test
									
									
									
									
									
										Submodule
									
								
							 Submodule test added at 0b89443584
									
								
							@@ -3,6 +3,6 @@
 | 
			
		||||
 */
 | 
			
		||||
export const commitinfo = {
 | 
			
		||||
  name: '@git.zone/cli',
 | 
			
		||||
  version: '1.16.8',
 | 
			
		||||
  version: '1.19.3',
 | 
			
		||||
  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.'
 | 
			
		||||
}
 | 
			
		||||
 
 | 
			
		||||
@@ -131,6 +131,14 @@ export let run = async () => {
 | 
			
		||||
    modHelpers.run(argvArg);
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  /**
 | 
			
		||||
   * manage development services (MongoDB, S3/MinIO)
 | 
			
		||||
   */
 | 
			
		||||
  gitzoneSmartcli.addCommand('services').subscribe(async (argvArg) => {
 | 
			
		||||
    const modServices = await import('./mod_services/index.js');
 | 
			
		||||
    await modServices.run(argvArg);
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  // start parsing of the cli
 | 
			
		||||
  gitzoneSmartcli.startParse();
 | 
			
		||||
  return await done.promise;
 | 
			
		||||
 
 | 
			
		||||
@@ -3,6 +3,8 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as paths from '../paths.js';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
import * as helpers from './mod.helpers.js';
 | 
			
		||||
import * as ui from './mod.ui.js';
 | 
			
		||||
 | 
			
		||||
export const run = async (argvArg: any) => {
 | 
			
		||||
  if (argvArg.format) {
 | 
			
		||||
@@ -10,22 +12,21 @@ export const run = async (argvArg: any) => {
 | 
			
		||||
    await formatMod.run();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  logger.log('info', `gathering facts...`);
 | 
			
		||||
  ui.printHeader('🔍 Analyzing repository changes...');
 | 
			
		||||
 | 
			
		||||
  const aidoc = new plugins.tsdoc.AiDoc();
 | 
			
		||||
  await aidoc.start();
 | 
			
		||||
 | 
			
		||||
  const nextCommitObject = await aidoc.buildNextCommitObject(paths.cwd);
 | 
			
		||||
 | 
			
		||||
  logger.log(
 | 
			
		||||
    'info',
 | 
			
		||||
    `---------
 | 
			
		||||
    Next recommended commit would be:
 | 
			
		||||
    ===========
 | 
			
		||||
    -> ${nextCommitObject.recommendedNextVersion}:
 | 
			
		||||
    -> ${nextCommitObject.recommendedNextVersionLevel}(${nextCommitObject.recommendedNextVersionScope}): ${nextCommitObject.recommendedNextVersionMessage}
 | 
			
		||||
    ===========
 | 
			
		||||
  `,
 | 
			
		||||
  );
 | 
			
		||||
  await aidoc.stop();
 | 
			
		||||
 | 
			
		||||
  ui.printRecommendation({
 | 
			
		||||
    recommendedNextVersion: nextCommitObject.recommendedNextVersion,
 | 
			
		||||
    recommendedNextVersionLevel: nextCommitObject.recommendedNextVersionLevel,
 | 
			
		||||
    recommendedNextVersionScope: nextCommitObject.recommendedNextVersionScope,
 | 
			
		||||
    recommendedNextVersionMessage: nextCommitObject.recommendedNextVersionMessage,
 | 
			
		||||
  });
 | 
			
		||||
  const commitInteract = new plugins.smartinteract.SmartInteract();
 | 
			
		||||
  commitInteract.addQuestions([
 | 
			
		||||
    {
 | 
			
		||||
@@ -67,20 +68,30 @@ export const run = async (argvArg: any) => {
 | 
			
		||||
    }
 | 
			
		||||
  })();
 | 
			
		||||
 | 
			
		||||
  logger.log('info', `OK! Creating commit with message '${commitString}'`);
 | 
			
		||||
  ui.printHeader('✨ Creating Semantic Commit');
 | 
			
		||||
  ui.printCommitMessage(commitString);
 | 
			
		||||
  const smartshellInstance = new plugins.smartshell.Smartshell({
 | 
			
		||||
    executor: 'bash',
 | 
			
		||||
    sourceFilePaths: [],
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  logger.log('info', `Baking commitinfo into code ...`);
 | 
			
		||||
  // Determine total steps (6 if pushing, 5 if not)
 | 
			
		||||
  const totalSteps = answerBucket.getAnswerFor('pushToOrigin') && !(process.env.CI === 'true') ? 6 : 5;
 | 
			
		||||
  let currentStep = 0;
 | 
			
		||||
 | 
			
		||||
  // Step 1: Baking commitinfo
 | 
			
		||||
  currentStep++;
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '🔧 Baking commit info into code', 'in-progress');
 | 
			
		||||
  const commitInfo = new plugins.commitinfo.CommitInfo(
 | 
			
		||||
    paths.cwd,
 | 
			
		||||
    commitVersionType,
 | 
			
		||||
  );
 | 
			
		||||
  await commitInfo.writeIntoPotentialDirs();
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '🔧 Baking commit info into code', 'done');
 | 
			
		||||
 | 
			
		||||
  logger.log('info', `Writing changelog.md ...`);
 | 
			
		||||
  // Step 2: Writing changelog
 | 
			
		||||
  currentStep++;
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '📄 Generating changelog.md', 'in-progress');
 | 
			
		||||
  let changelog = nextCommitObject.changelog;
 | 
			
		||||
  changelog = changelog.replaceAll(
 | 
			
		||||
    '{{nextVersion}}',
 | 
			
		||||
@@ -107,17 +118,54 @@ export const run = async (argvArg: any) => {
 | 
			
		||||
    changelog,
 | 
			
		||||
    plugins.path.join(paths.cwd, `changelog.md`),
 | 
			
		||||
  );
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '📄 Generating changelog.md', 'done');
 | 
			
		||||
 | 
			
		||||
  logger.log('info', `Staging files for commit:`);
 | 
			
		||||
  // Step 3: Staging files
 | 
			
		||||
  currentStep++;
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '📦 Staging files', 'in-progress');
 | 
			
		||||
  await smartshellInstance.exec(`git add -A`);
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '📦 Staging files', 'done');
 | 
			
		||||
 | 
			
		||||
  // Step 4: Creating commit
 | 
			
		||||
  currentStep++;
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '💾 Creating git commit', 'in-progress');
 | 
			
		||||
  await smartshellInstance.exec(`git commit -m "${commitString}"`);
 | 
			
		||||
  await smartshellInstance.exec(`npm version ${commitVersionType}`);
 | 
			
		||||
  ui.printStep(currentStep, totalSteps, '💾 Creating git commit', 'done');
 | 
			
		||||
 | 
			
		||||
  // Step 5: Bumping version
 | 
			
		||||
  currentStep++;
 | 
			
		||||
  const projectType = await helpers.detectProjectType();
 | 
			
		||||
  const newVersion = await helpers.bumpProjectVersion(projectType, commitVersionType, currentStep, totalSteps);
 | 
			
		||||
 | 
			
		||||
  // Step 6: Push to remote (optional)
 | 
			
		||||
  const currentBranch = await helpers.detectCurrentBranch();
 | 
			
		||||
  if (
 | 
			
		||||
    answerBucket.getAnswerFor('pushToOrigin') &&
 | 
			
		||||
    !(process.env.CI === 'true')
 | 
			
		||||
  ) {
 | 
			
		||||
    await smartshellInstance.exec(`git push origin master --follow-tags`);
 | 
			
		||||
    currentStep++;
 | 
			
		||||
    ui.printStep(currentStep, totalSteps, `🚀 Pushing to origin/${currentBranch}`, 'in-progress');
 | 
			
		||||
    await smartshellInstance.exec(`git push origin ${currentBranch} --follow-tags`);
 | 
			
		||||
    ui.printStep(currentStep, totalSteps, `🚀 Pushing to origin/${currentBranch}`, 'done');
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  console.log(''); // Add spacing before summary
 | 
			
		||||
 | 
			
		||||
  // Get commit SHA for summary
 | 
			
		||||
  const commitShaResult = await smartshellInstance.exec('git rev-parse --short HEAD');
 | 
			
		||||
  const commitSha = commitShaResult.stdout.trim();
 | 
			
		||||
 | 
			
		||||
  // Print final summary
 | 
			
		||||
  ui.printSummary({
 | 
			
		||||
    projectType,
 | 
			
		||||
    branch: currentBranch,
 | 
			
		||||
    commitType: answerBucket.getAnswerFor('commitType'),
 | 
			
		||||
    commitScope: answerBucket.getAnswerFor('commitScope'),
 | 
			
		||||
    commitMessage: answerBucket.getAnswerFor('commitDescription'),
 | 
			
		||||
    newVersion: newVersion,
 | 
			
		||||
    commitSha: commitSha,
 | 
			
		||||
    pushed: answerBucket.getAnswerFor('pushToOrigin') && !(process.env.CI === 'true'),
 | 
			
		||||
  });
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
const createCommitStringFromAnswerBucket = (
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										256
									
								
								ts/mod_commit/mod.helpers.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										256
									
								
								ts/mod_commit/mod.helpers.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,256 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as paths from '../paths.js';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
import * as ui from './mod.ui.js';
 | 
			
		||||
 | 
			
		||||
export type ProjectType = 'npm' | 'deno' | 'both' | 'none';
 | 
			
		||||
export type VersionType = 'patch' | 'minor' | 'major';
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Detects the current git branch
 | 
			
		||||
 * @returns The current branch name, defaults to 'master' if detection fails
 | 
			
		||||
 */
 | 
			
		||||
export async function detectCurrentBranch(): Promise<string> {
 | 
			
		||||
  try {
 | 
			
		||||
    const smartshellInstance = new plugins.smartshell.Smartshell({
 | 
			
		||||
      executor: 'bash',
 | 
			
		||||
      sourceFilePaths: [],
 | 
			
		||||
    });
 | 
			
		||||
    const result = await smartshellInstance.exec('git branch --show-current');
 | 
			
		||||
    const branchName = result.stdout.trim();
 | 
			
		||||
 | 
			
		||||
    if (!branchName) {
 | 
			
		||||
      logger.log('warn', 'Could not detect current branch, falling back to "master"');
 | 
			
		||||
      return 'master';
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    logger.log('info', `Detected current branch: ${branchName}`);
 | 
			
		||||
    return branchName;
 | 
			
		||||
  } catch (error) {
 | 
			
		||||
    logger.log('warn', `Failed to detect branch: ${error.message}, falling back to "master"`);
 | 
			
		||||
    return 'master';
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Detects the project type based on presence of package.json and/or deno.json
 | 
			
		||||
 * @returns The project type
 | 
			
		||||
 */
 | 
			
		||||
export async function detectProjectType(): Promise<ProjectType> {
 | 
			
		||||
  const packageJsonPath = plugins.path.join(paths.cwd, 'package.json');
 | 
			
		||||
  const denoJsonPath = plugins.path.join(paths.cwd, 'deno.json');
 | 
			
		||||
 | 
			
		||||
  const hasPackageJson = await plugins.smartfile.fs.fileExists(packageJsonPath);
 | 
			
		||||
  const hasDenoJson = await plugins.smartfile.fs.fileExists(denoJsonPath);
 | 
			
		||||
 | 
			
		||||
  if (hasPackageJson && hasDenoJson) {
 | 
			
		||||
    logger.log('info', 'Detected dual project (npm + deno)');
 | 
			
		||||
    return 'both';
 | 
			
		||||
  } else if (hasPackageJson) {
 | 
			
		||||
    logger.log('info', 'Detected npm project');
 | 
			
		||||
    return 'npm';
 | 
			
		||||
  } else if (hasDenoJson) {
 | 
			
		||||
    logger.log('info', 'Detected deno project');
 | 
			
		||||
    return 'deno';
 | 
			
		||||
  } else {
 | 
			
		||||
    throw new Error('No package.json or deno.json found in current directory');
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Parses a semantic version string and bumps it according to the version type
 | 
			
		||||
 * @param currentVersion Current version string (e.g., "1.2.3")
 | 
			
		||||
 * @param versionType Type of version bump
 | 
			
		||||
 * @returns New version string
 | 
			
		||||
 */
 | 
			
		||||
function calculateNewVersion(currentVersion: string, versionType: VersionType): string {
 | 
			
		||||
  const versionMatch = currentVersion.match(/^(\d+)\.(\d+)\.(\d+)/);
 | 
			
		||||
 | 
			
		||||
  if (!versionMatch) {
 | 
			
		||||
    throw new Error(`Invalid version format: ${currentVersion}`);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  let [, major, minor, patch] = versionMatch.map(Number);
 | 
			
		||||
 | 
			
		||||
  switch (versionType) {
 | 
			
		||||
    case 'major':
 | 
			
		||||
      major += 1;
 | 
			
		||||
      minor = 0;
 | 
			
		||||
      patch = 0;
 | 
			
		||||
      break;
 | 
			
		||||
    case 'minor':
 | 
			
		||||
      minor += 1;
 | 
			
		||||
      patch = 0;
 | 
			
		||||
      break;
 | 
			
		||||
    case 'patch':
 | 
			
		||||
      patch += 1;
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return `${major}.${minor}.${patch}`;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Bumps the version in deno.json, commits the change, and creates a tag
 | 
			
		||||
 * @param versionType Type of version bump
 | 
			
		||||
 * @returns The new version string
 | 
			
		||||
 */
 | 
			
		||||
export async function bumpDenoVersion(versionType: VersionType): Promise<string> {
 | 
			
		||||
  const denoJsonPath = plugins.path.join(paths.cwd, 'deno.json');
 | 
			
		||||
  const smartshellInstance = new plugins.smartshell.Smartshell({
 | 
			
		||||
    executor: 'bash',
 | 
			
		||||
    sourceFilePaths: [],
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  try {
 | 
			
		||||
    // Read deno.json
 | 
			
		||||
    const denoConfig = plugins.smartfile.fs.toObjectSync(
 | 
			
		||||
      denoJsonPath
 | 
			
		||||
    ) as { version?: string };
 | 
			
		||||
 | 
			
		||||
    if (!denoConfig.version) {
 | 
			
		||||
      throw new Error('deno.json does not contain a version field');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    const currentVersion = denoConfig.version;
 | 
			
		||||
    const newVersion = calculateNewVersion(currentVersion, versionType);
 | 
			
		||||
 | 
			
		||||
    logger.log('info', `Bumping deno.json version: ${currentVersion} → ${newVersion}`);
 | 
			
		||||
 | 
			
		||||
    // Update version
 | 
			
		||||
    denoConfig.version = newVersion;
 | 
			
		||||
 | 
			
		||||
    // Write back to disk
 | 
			
		||||
    await plugins.smartfile.memory.toFs(
 | 
			
		||||
      JSON.stringify(denoConfig, null, 2) + '\n',
 | 
			
		||||
      denoJsonPath
 | 
			
		||||
    );
 | 
			
		||||
 | 
			
		||||
    // Stage the deno.json file
 | 
			
		||||
    await smartshellInstance.exec('git add deno.json');
 | 
			
		||||
 | 
			
		||||
    // Commit the version bump
 | 
			
		||||
    await smartshellInstance.exec(`git commit -m "v${newVersion}"`);
 | 
			
		||||
 | 
			
		||||
    // Create the version tag
 | 
			
		||||
    await smartshellInstance.exec(`git tag v${newVersion} -m "v${newVersion}"`);
 | 
			
		||||
 | 
			
		||||
    logger.log('info', `Created commit and tag v${newVersion}`);
 | 
			
		||||
 | 
			
		||||
    return newVersion;
 | 
			
		||||
  } catch (error) {
 | 
			
		||||
    throw new Error(`Failed to bump deno.json version: ${error.message}`);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Bumps the version in package.json using npm version command
 | 
			
		||||
 * @param versionType Type of version bump
 | 
			
		||||
 * @returns The new version string
 | 
			
		||||
 */
 | 
			
		||||
async function bumpNpmVersion(versionType: VersionType): Promise<string> {
 | 
			
		||||
  const smartshellInstance = new plugins.smartshell.Smartshell({
 | 
			
		||||
    executor: 'bash',
 | 
			
		||||
    sourceFilePaths: [],
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  logger.log('info', `Bumping package.json version using npm version ${versionType}`);
 | 
			
		||||
  const result = await smartshellInstance.exec(`npm version ${versionType}`);
 | 
			
		||||
 | 
			
		||||
  // npm version returns the new version with a 'v' prefix, e.g., "v1.2.3"
 | 
			
		||||
  const newVersion = result.stdout.trim().replace(/^v/, '');
 | 
			
		||||
  return newVersion;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Syncs the version from package.json to deno.json and amends the npm commit
 | 
			
		||||
 * @param version The version to sync
 | 
			
		||||
 */
 | 
			
		||||
async function syncVersionToDenoJson(version: string): Promise<void> {
 | 
			
		||||
  const denoJsonPath = plugins.path.join(paths.cwd, 'deno.json');
 | 
			
		||||
  const smartshellInstance = new plugins.smartshell.Smartshell({
 | 
			
		||||
    executor: 'bash',
 | 
			
		||||
    sourceFilePaths: [],
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  try {
 | 
			
		||||
    const denoConfig = plugins.smartfile.fs.toObjectSync(
 | 
			
		||||
      denoJsonPath
 | 
			
		||||
    ) as { version?: string };
 | 
			
		||||
 | 
			
		||||
    logger.log('info', `Syncing version to deno.json: ${version}`);
 | 
			
		||||
    denoConfig.version = version;
 | 
			
		||||
 | 
			
		||||
    await plugins.smartfile.memory.toFs(
 | 
			
		||||
      JSON.stringify(denoConfig, null, 2) + '\n',
 | 
			
		||||
      denoJsonPath
 | 
			
		||||
    );
 | 
			
		||||
 | 
			
		||||
    // Stage the deno.json file
 | 
			
		||||
    await smartshellInstance.exec('git add deno.json');
 | 
			
		||||
 | 
			
		||||
    // Amend the npm version commit to include deno.json
 | 
			
		||||
    await smartshellInstance.exec('git commit --amend --no-edit');
 | 
			
		||||
 | 
			
		||||
    // Re-create the tag with force to update it
 | 
			
		||||
    await smartshellInstance.exec(`git tag -fa v${version} -m "v${version}"`);
 | 
			
		||||
 | 
			
		||||
    logger.log('info', `Amended commit to include deno.json and updated tag v${version}`);
 | 
			
		||||
  } catch (error) {
 | 
			
		||||
    throw new Error(`Failed to sync version to deno.json: ${error.message}`);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Bumps the project version based on project type
 | 
			
		||||
 * @param projectType The detected project type
 | 
			
		||||
 * @param versionType The type of version bump
 | 
			
		||||
 * @param currentStep The current step number for progress display
 | 
			
		||||
 * @param totalSteps The total number of steps for progress display
 | 
			
		||||
 * @returns The new version string
 | 
			
		||||
 */
 | 
			
		||||
export async function bumpProjectVersion(
 | 
			
		||||
  projectType: ProjectType,
 | 
			
		||||
  versionType: VersionType,
 | 
			
		||||
  currentStep?: number,
 | 
			
		||||
  totalSteps?: number
 | 
			
		||||
): Promise<string> {
 | 
			
		||||
  const projectEmoji = projectType === 'npm' ? '📦' : projectType === 'deno' ? '🦕' : '🔀';
 | 
			
		||||
  const description = `🏷️  Bumping version (${projectEmoji} ${projectType})`;
 | 
			
		||||
 | 
			
		||||
  if (currentStep && totalSteps) {
 | 
			
		||||
    ui.printStep(currentStep, totalSteps, description, 'in-progress');
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  let newVersion: string;
 | 
			
		||||
 | 
			
		||||
  switch (projectType) {
 | 
			
		||||
    case 'npm':
 | 
			
		||||
      newVersion = await bumpNpmVersion(versionType);
 | 
			
		||||
      break;
 | 
			
		||||
 | 
			
		||||
    case 'deno':
 | 
			
		||||
      newVersion = await bumpDenoVersion(versionType);
 | 
			
		||||
      break;
 | 
			
		||||
 | 
			
		||||
    case 'both': {
 | 
			
		||||
      // Bump npm version first (it handles git tags)
 | 
			
		||||
      newVersion = await bumpNpmVersion(versionType);
 | 
			
		||||
      // Then sync to deno.json
 | 
			
		||||
      await syncVersionToDenoJson(newVersion);
 | 
			
		||||
      break;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    case 'none':
 | 
			
		||||
      throw new Error('Cannot bump version: no package.json or deno.json found');
 | 
			
		||||
 | 
			
		||||
    default:
 | 
			
		||||
      throw new Error(`Unknown project type: ${projectType}`);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if (currentStep && totalSteps) {
 | 
			
		||||
    ui.printStep(currentStep, totalSteps, description, 'done');
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return newVersion;
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										196
									
								
								ts/mod_commit/mod.ui.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										196
									
								
								ts/mod_commit/mod.ui.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,196 @@
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * UI helper module for beautiful CLI output
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
interface ICommitSummary {
 | 
			
		||||
  projectType: string;
 | 
			
		||||
  branch: string;
 | 
			
		||||
  commitType: string;
 | 
			
		||||
  commitScope: string;
 | 
			
		||||
  commitMessage: string;
 | 
			
		||||
  newVersion: string;
 | 
			
		||||
  commitSha?: string;
 | 
			
		||||
  pushed: boolean;
 | 
			
		||||
  repoUrl?: string;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
interface IRecommendation {
 | 
			
		||||
  recommendedNextVersion: string;
 | 
			
		||||
  recommendedNextVersionLevel: string;
 | 
			
		||||
  recommendedNextVersionScope: string;
 | 
			
		||||
  recommendedNextVersionMessage: string;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print a header with a box around it
 | 
			
		||||
 */
 | 
			
		||||
export function printHeader(title: string): void {
 | 
			
		||||
  const width = 57;
 | 
			
		||||
  const padding = Math.max(0, width - title.length - 2);
 | 
			
		||||
  const leftPad = Math.floor(padding / 2);
 | 
			
		||||
  const rightPad = padding - leftPad;
 | 
			
		||||
 | 
			
		||||
  console.log('');
 | 
			
		||||
  console.log('╭─' + '─'.repeat(width) + '─╮');
 | 
			
		||||
  console.log('│  ' + title + ' '.repeat(rightPad + leftPad) + '  │');
 | 
			
		||||
  console.log('╰─' + '─'.repeat(width) + '─╯');
 | 
			
		||||
  console.log('');
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print a section with a border
 | 
			
		||||
 */
 | 
			
		||||
export function printSection(title: string, lines: string[]): void {
 | 
			
		||||
  const width = 59;
 | 
			
		||||
 | 
			
		||||
  console.log('┌─ ' + title + ' ' + '─'.repeat(Math.max(0, width - title.length - 3)) + '┐');
 | 
			
		||||
  console.log('│' + ' '.repeat(width) + '│');
 | 
			
		||||
 | 
			
		||||
  for (const line of lines) {
 | 
			
		||||
    const padding = width - line.length;
 | 
			
		||||
    console.log('│  ' + line + ' '.repeat(Math.max(0, padding - 2)) + '│');
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  console.log('│' + ' '.repeat(width) + '│');
 | 
			
		||||
  console.log('└─' + '─'.repeat(width) + '─┘');
 | 
			
		||||
  console.log('');
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print AI recommendations in a nice box
 | 
			
		||||
 */
 | 
			
		||||
export function printRecommendation(recommendation: IRecommendation): void {
 | 
			
		||||
  const lines = [
 | 
			
		||||
    `Suggested Version:  v${recommendation.recommendedNextVersion}`,
 | 
			
		||||
    `Suggested Type:     ${recommendation.recommendedNextVersionLevel}`,
 | 
			
		||||
    `Suggested Scope:    ${recommendation.recommendedNextVersionScope}`,
 | 
			
		||||
    `Suggested Message:  ${recommendation.recommendedNextVersionMessage}`,
 | 
			
		||||
  ];
 | 
			
		||||
 | 
			
		||||
  printSection('📊 AI Recommendations', lines);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print a progress step
 | 
			
		||||
 */
 | 
			
		||||
export function printStep(
 | 
			
		||||
  current: number,
 | 
			
		||||
  total: number,
 | 
			
		||||
  description: string,
 | 
			
		||||
  status: 'in-progress' | 'done' | 'error'
 | 
			
		||||
): void {
 | 
			
		||||
  const statusIcon = status === 'done' ? '✓' : status === 'error' ? '✗' : '⏳';
 | 
			
		||||
  const dots = '.'.repeat(Math.max(0, 40 - description.length));
 | 
			
		||||
 | 
			
		||||
  console.log(`  [${current}/${total}] ${description}${dots} ${statusIcon}`);
 | 
			
		||||
 | 
			
		||||
  // Clear the line on next update if in progress
 | 
			
		||||
  if (status === 'in-progress') {
 | 
			
		||||
    process.stdout.write('\x1b[1A'); // Move cursor up one line
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get emoji for project type
 | 
			
		||||
 */
 | 
			
		||||
function getProjectTypeEmoji(projectType: string): string {
 | 
			
		||||
  switch (projectType) {
 | 
			
		||||
    case 'npm':
 | 
			
		||||
      return '📦 npm';
 | 
			
		||||
    case 'deno':
 | 
			
		||||
      return '🦕 Deno';
 | 
			
		||||
    case 'both':
 | 
			
		||||
      return '🔀 npm + Deno';
 | 
			
		||||
    default:
 | 
			
		||||
      return '❓ Unknown';
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get emoji for commit type
 | 
			
		||||
 */
 | 
			
		||||
function getCommitTypeEmoji(commitType: string): string {
 | 
			
		||||
  switch (commitType) {
 | 
			
		||||
    case 'fix':
 | 
			
		||||
      return '🔧 fix';
 | 
			
		||||
    case 'feat':
 | 
			
		||||
      return '✨ feat';
 | 
			
		||||
    case 'BREAKING CHANGE':
 | 
			
		||||
      return '💥 BREAKING CHANGE';
 | 
			
		||||
    default:
 | 
			
		||||
      return commitType;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print final commit summary
 | 
			
		||||
 */
 | 
			
		||||
export function printSummary(summary: ICommitSummary): void {
 | 
			
		||||
  const lines = [
 | 
			
		||||
    `Project Type:   ${getProjectTypeEmoji(summary.projectType)}`,
 | 
			
		||||
    `Branch:         🌿 ${summary.branch}`,
 | 
			
		||||
    `Commit Type:    ${getCommitTypeEmoji(summary.commitType)}`,
 | 
			
		||||
    `Scope:          📍 ${summary.commitScope}`,
 | 
			
		||||
    `New Version:    🏷️  v${summary.newVersion}`,
 | 
			
		||||
  ];
 | 
			
		||||
 | 
			
		||||
  if (summary.commitSha) {
 | 
			
		||||
    lines.push(`Commit SHA:     📌 ${summary.commitSha}`);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if (summary.pushed) {
 | 
			
		||||
    lines.push(`Remote:         ✓ Pushed successfully`);
 | 
			
		||||
  } else {
 | 
			
		||||
    lines.push(`Remote:         ⊘ Not pushed (local only)`);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if (summary.repoUrl && summary.commitSha) {
 | 
			
		||||
    lines.push('');
 | 
			
		||||
    lines.push(`View at: ${summary.repoUrl}/commit/${summary.commitSha}`);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  printSection('✅ Commit Summary', lines);
 | 
			
		||||
 | 
			
		||||
  if (summary.pushed) {
 | 
			
		||||
    console.log('🎉 All done! Your changes are committed and pushed.\n');
 | 
			
		||||
  } else {
 | 
			
		||||
    console.log('✓ Commit created successfully.\n');
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print an info message with consistent formatting
 | 
			
		||||
 */
 | 
			
		||||
export function printInfo(message: string): void {
 | 
			
		||||
  console.log(`  ℹ️  ${message}`);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print a success message
 | 
			
		||||
 */
 | 
			
		||||
export function printSuccess(message: string): void {
 | 
			
		||||
  console.log(`  ✓ ${message}`);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print a warning message
 | 
			
		||||
 */
 | 
			
		||||
export function printWarning(message: string): void {
 | 
			
		||||
  logger.log('warn', `⚠️  ${message}`);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print an error message
 | 
			
		||||
 */
 | 
			
		||||
export function printError(message: string): void {
 | 
			
		||||
  logger.log('error', `✗ ${message}`);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print commit message being created
 | 
			
		||||
 */
 | 
			
		||||
export function printCommitMessage(commitString: string): void {
 | 
			
		||||
  console.log(`\n  📝 Commit: ${commitString}\n`);
 | 
			
		||||
}
 | 
			
		||||
@@ -53,7 +53,19 @@ export abstract class BaseFormatter {
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  protected async modifyFile(filepath: string, content: string): Promise<void> {
 | 
			
		||||
    await plugins.smartfile.memory.toFs(content, 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> {
 | 
			
		||||
 
 | 
			
		||||
@@ -8,15 +8,40 @@ const gitignorePath = plugins.path.join(paths.cwd, './.gitignore');
 | 
			
		||||
 | 
			
		||||
export const run = async (projectArg: Project) => {
 | 
			
		||||
  const gitignoreExists = await plugins.smartfile.fs.fileExists(gitignorePath);
 | 
			
		||||
  const templateModule = await import('../mod_template/index.js');
 | 
			
		||||
  const ciTemplate = await templateModule.getTemplate('gitignore');
 | 
			
		||||
  let customContent = '';
 | 
			
		||||
 | 
			
		||||
  if (gitignoreExists) {
 | 
			
		||||
    // lets get the existing gitignore file
 | 
			
		||||
    const existingGitIgnoreString =
 | 
			
		||||
      plugins.smartfile.fs.toStringSync(gitignorePath);
 | 
			
		||||
    let customPart = existingGitIgnoreString.split('# custom\n')[1];
 | 
			
		||||
    customPart ? null : (customPart = '');
 | 
			
		||||
 | 
			
		||||
    // Check for different custom section markers
 | 
			
		||||
    const customMarkers = ['#------# custom', '# custom'];
 | 
			
		||||
    for (const marker of customMarkers) {
 | 
			
		||||
      const splitResult = existingGitIgnoreString.split(marker);
 | 
			
		||||
      if (splitResult.length > 1) {
 | 
			
		||||
        // Get everything after the marker (excluding the marker itself)
 | 
			
		||||
        customContent = splitResult[1].trim();
 | 
			
		||||
        break;
 | 
			
		||||
      }
 | 
			
		||||
  ciTemplate.writeToDisk(paths.cwd);
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  // Write the template
 | 
			
		||||
  const templateModule = await import('../mod_template/index.js');
 | 
			
		||||
  const ciTemplate = await templateModule.getTemplate('gitignore');
 | 
			
		||||
  await ciTemplate.writeToDisk(paths.cwd);
 | 
			
		||||
 | 
			
		||||
  // Append the custom content if it exists
 | 
			
		||||
  if (customContent) {
 | 
			
		||||
    const newGitignoreContent =
 | 
			
		||||
      plugins.smartfile.fs.toStringSync(gitignorePath);
 | 
			
		||||
    // The template already ends with "#------# custom", so just append the content
 | 
			
		||||
    const finalContent =
 | 
			
		||||
      newGitignoreContent.trimEnd() + '\n' + customContent + '\n';
 | 
			
		||||
    await plugins.smartfile.fs.toFs(finalContent, gitignorePath);
 | 
			
		||||
    logger.log('info', 'Updated .gitignore while preserving custom section!');
 | 
			
		||||
  } else {
 | 
			
		||||
    logger.log('info', 'Added a .gitignore!');
 | 
			
		||||
  }
 | 
			
		||||
};
 | 
			
		||||
 
 | 
			
		||||
@@ -83,10 +83,10 @@ export const run = async (projectArg: Project) => {
 | 
			
		||||
        type: 'git',
 | 
			
		||||
        url: `https://${gitzoneData.module.githost}/${gitzoneData.module.gitscope}/${gitzoneData.module.gitrepo}.git`,
 | 
			
		||||
      };
 | 
			
		||||
      (packageJson.bugs = {
 | 
			
		||||
      ((packageJson.bugs = {
 | 
			
		||||
        url: `https://${gitzoneData.module.githost}/${gitzoneData.module.gitscope}/${gitzoneData.module.gitrepo}/issues`,
 | 
			
		||||
      }),
 | 
			
		||||
        (packageJson.homepage = `https://${gitzoneData.module.githost}/${gitzoneData.module.gitscope}/${gitzoneData.module.gitrepo}#readme`);
 | 
			
		||||
        (packageJson.homepage = `https://${gitzoneData.module.githost}/${gitzoneData.module.gitscope}/${gitzoneData.module.gitrepo}#readme`));
 | 
			
		||||
 | 
			
		||||
      // Check for module type
 | 
			
		||||
      if (!packageJson.type) {
 | 
			
		||||
 
 | 
			
		||||
@@ -29,8 +29,9 @@ export class PrettierFormatter extends BaseFormatter {
 | 
			
		||||
      'README.md',
 | 
			
		||||
      'changelog.md',
 | 
			
		||||
      'CHANGELOG.md',
 | 
			
		||||
      'license',
 | 
			
		||||
      'LICENSE',
 | 
			
		||||
      // Skip files without extensions as prettier can't infer parser
 | 
			
		||||
      // 'license',
 | 
			
		||||
      // 'LICENSE',
 | 
			
		||||
      '*.md',
 | 
			
		||||
    ];
 | 
			
		||||
 | 
			
		||||
@@ -102,26 +103,15 @@ export class PrettierFormatter extends BaseFormatter {
 | 
			
		||||
    try {
 | 
			
		||||
      await this.preExecute();
 | 
			
		||||
 | 
			
		||||
      // Batch process files
 | 
			
		||||
      const batchSize = 10; // Process 10 files at a time
 | 
			
		||||
      const batches: IPlannedChange[][] = [];
 | 
			
		||||
 | 
			
		||||
      for (let i = 0; i < changes.length; i += batchSize) {
 | 
			
		||||
        batches.push(changes.slice(i, i + batchSize));
 | 
			
		||||
      }
 | 
			
		||||
      logVerbose(`Processing ${changes.length} files sequentially`);
 | 
			
		||||
 | 
			
		||||
      // Process files sequentially to avoid prettier cache/state issues
 | 
			
		||||
      for (let i = 0; i < changes.length; i++) {
 | 
			
		||||
        const change = changes[i];
 | 
			
		||||
        logVerbose(
 | 
			
		||||
        `Processing ${changes.length} files in ${batches.length} batches`,
 | 
			
		||||
          `Processing file ${i + 1}/${changes.length}: ${change.path}`,
 | 
			
		||||
        );
 | 
			
		||||
 | 
			
		||||
      for (let i = 0; i < batches.length; i++) {
 | 
			
		||||
        const batch = batches[i];
 | 
			
		||||
        logVerbose(
 | 
			
		||||
          `Processing batch ${i + 1}/${batches.length} (${batch.length} files)`,
 | 
			
		||||
        );
 | 
			
		||||
 | 
			
		||||
        // Process batch in parallel
 | 
			
		||||
        const promises = batch.map(async (change) => {
 | 
			
		||||
        try {
 | 
			
		||||
          await this.applyChange(change);
 | 
			
		||||
          this.stats.recordFileOperation(this.name, change.type, true);
 | 
			
		||||
@@ -133,9 +123,6 @@ export class PrettierFormatter extends BaseFormatter {
 | 
			
		||||
          );
 | 
			
		||||
          // Don't throw - continue with other files
 | 
			
		||||
        }
 | 
			
		||||
        });
 | 
			
		||||
 | 
			
		||||
        await Promise.all(promises);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      await this.postExecute();
 | 
			
		||||
@@ -151,11 +138,32 @@ export class PrettierFormatter extends BaseFormatter {
 | 
			
		||||
    if (change.type !== 'modify') return;
 | 
			
		||||
 | 
			
		||||
    try {
 | 
			
		||||
      // Validate the path before processing
 | 
			
		||||
      if (!change.path || change.path.trim() === '') {
 | 
			
		||||
        logger.log(
 | 
			
		||||
          'error',
 | 
			
		||||
          `Invalid empty path in change: ${JSON.stringify(change)}`,
 | 
			
		||||
        );
 | 
			
		||||
        throw new Error('Invalid empty path');
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      // Read current content
 | 
			
		||||
      const content = plugins.smartfile.fs.toStringSync(change.path);
 | 
			
		||||
 | 
			
		||||
      // Format with prettier
 | 
			
		||||
      const prettier = await import('prettier');
 | 
			
		||||
 | 
			
		||||
      // Skip files that prettier can't parse without explicit parser
 | 
			
		||||
      const fileExt = plugins.path.extname(change.path).toLowerCase();
 | 
			
		||||
      if (!fileExt || fileExt === '') {
 | 
			
		||||
        // Files without extensions need explicit parser
 | 
			
		||||
        logVerbose(
 | 
			
		||||
          `Skipping ${change.path} - no file extension for parser inference`,
 | 
			
		||||
        );
 | 
			
		||||
        return;
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      try {
 | 
			
		||||
        const formatted = await prettier.format(content, {
 | 
			
		||||
          filepath: change.path,
 | 
			
		||||
          ...(await this.getPrettierConfig()),
 | 
			
		||||
@@ -163,13 +171,38 @@ export class PrettierFormatter extends BaseFormatter {
 | 
			
		||||
 | 
			
		||||
        // Only write if content actually changed
 | 
			
		||||
        if (formatted !== content) {
 | 
			
		||||
          // Debug: log the path being written
 | 
			
		||||
          logVerbose(`Writing formatted content to: ${change.path}`);
 | 
			
		||||
          await this.modifyFile(change.path, formatted);
 | 
			
		||||
          logVerbose(`Formatted ${change.path}`);
 | 
			
		||||
        } else {
 | 
			
		||||
          logVerbose(`No formatting changes for ${change.path}`);
 | 
			
		||||
        }
 | 
			
		||||
      } catch (prettierError) {
 | 
			
		||||
        // Check if it's a parser error
 | 
			
		||||
        if (
 | 
			
		||||
          prettierError.message &&
 | 
			
		||||
          prettierError.message.includes('No parser could be inferred')
 | 
			
		||||
        ) {
 | 
			
		||||
          logVerbose(`Skipping ${change.path} - ${prettierError.message}`);
 | 
			
		||||
          return; // Skip this file silently
 | 
			
		||||
        }
 | 
			
		||||
        throw prettierError;
 | 
			
		||||
      }
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      logger.log('error', `Failed to format ${change.path}: ${error.message}`);
 | 
			
		||||
      // Log the full error stack for debugging mkdir issues
 | 
			
		||||
      if (error.message && error.message.includes('mkdir')) {
 | 
			
		||||
        logger.log(
 | 
			
		||||
          'error',
 | 
			
		||||
          `Failed to format ${change.path}: ${error.message}`,
 | 
			
		||||
        );
 | 
			
		||||
        logger.log('error', `Error stack: ${error.stack}`);
 | 
			
		||||
      } else {
 | 
			
		||||
        logger.log(
 | 
			
		||||
          'error',
 | 
			
		||||
          `Failed to format ${change.path}: ${error.message}`,
 | 
			
		||||
        );
 | 
			
		||||
      }
 | 
			
		||||
      throw error;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 
 | 
			
		||||
@@ -185,5 +185,8 @@ export const handleListBackups = async (): Promise<void> => {
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
export const handleCleanBackups = async (): Promise<void> => {
 | 
			
		||||
  logger.log('info', 'Backup cleaning has been disabled - backup system removed');
 | 
			
		||||
  logger.log(
 | 
			
		||||
    'info',
 | 
			
		||||
    'Backup cleaning has been disabled - backup system removed',
 | 
			
		||||
  );
 | 
			
		||||
};
 | 
			
		||||
 
 | 
			
		||||
							
								
								
									
										261
									
								
								ts/mod_services/classes.dockercontainer.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										261
									
								
								ts/mod_services/classes.dockercontainer.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,261 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as helpers from './helpers.js';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
 | 
			
		||||
export type ContainerStatus = 'running' | 'stopped' | 'not_exists';
 | 
			
		||||
 | 
			
		||||
export interface IDockerRunOptions {
 | 
			
		||||
  name: string;
 | 
			
		||||
  image: string;
 | 
			
		||||
  ports?: { [key: string]: string };
 | 
			
		||||
  volumes?: { [key: string]: string };
 | 
			
		||||
  environment?: { [key: string]: string };
 | 
			
		||||
  restart?: string;
 | 
			
		||||
  command?: string;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
export class DockerContainer {
 | 
			
		||||
  private smartshell: plugins.smartshell.Smartshell;
 | 
			
		||||
  
 | 
			
		||||
  constructor() {
 | 
			
		||||
    this.smartshell = new plugins.smartshell.Smartshell({
 | 
			
		||||
      executor: 'bash',
 | 
			
		||||
    });
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Check if Docker is installed and available
 | 
			
		||||
   */
 | 
			
		||||
  public async checkDocker(): Promise<boolean> {
 | 
			
		||||
    try {
 | 
			
		||||
      const result = await this.smartshell.exec('docker --version');
 | 
			
		||||
      return result.exitCode === 0;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return false;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get container status
 | 
			
		||||
   */
 | 
			
		||||
  public async getStatus(containerName: string): Promise<ContainerStatus> {
 | 
			
		||||
    try {
 | 
			
		||||
      // Check if running
 | 
			
		||||
      const runningResult = await this.smartshell.exec(
 | 
			
		||||
        `docker ps --format '{{.Names}}' | grep -q "^${containerName}$"`
 | 
			
		||||
      );
 | 
			
		||||
      
 | 
			
		||||
      if (runningResult.exitCode === 0) {
 | 
			
		||||
        return 'running';
 | 
			
		||||
      }
 | 
			
		||||
      
 | 
			
		||||
      // Check if exists but stopped
 | 
			
		||||
      const existsResult = await this.smartshell.exec(
 | 
			
		||||
        `docker ps -a --format '{{.Names}}' | grep -q "^${containerName}$"`
 | 
			
		||||
      );
 | 
			
		||||
      
 | 
			
		||||
      if (existsResult.exitCode === 0) {
 | 
			
		||||
        return 'stopped';
 | 
			
		||||
      }
 | 
			
		||||
      
 | 
			
		||||
      return 'not_exists';
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return 'not_exists';
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Start a container
 | 
			
		||||
   */
 | 
			
		||||
  public async start(containerName: string): Promise<boolean> {
 | 
			
		||||
    try {
 | 
			
		||||
      const result = await this.smartshell.exec(`docker start ${containerName}`);
 | 
			
		||||
      return result.exitCode === 0;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return false;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Stop a container
 | 
			
		||||
   */
 | 
			
		||||
  public async stop(containerName: string): Promise<boolean> {
 | 
			
		||||
    try {
 | 
			
		||||
      const result = await this.smartshell.exec(`docker stop ${containerName}`);
 | 
			
		||||
      return result.exitCode === 0;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return false;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Remove a container
 | 
			
		||||
   */
 | 
			
		||||
  public async remove(containerName: string, force: boolean = false): Promise<boolean> {
 | 
			
		||||
    try {
 | 
			
		||||
      const forceFlag = force ? '-f' : '';
 | 
			
		||||
      const result = await this.smartshell.exec(`docker rm ${forceFlag} ${containerName}`);
 | 
			
		||||
      return result.exitCode === 0;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return false;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Run a new container
 | 
			
		||||
   */
 | 
			
		||||
  public async run(options: IDockerRunOptions): Promise<boolean> {
 | 
			
		||||
    let command = 'docker run -d';
 | 
			
		||||
    
 | 
			
		||||
    // Add name
 | 
			
		||||
    command += ` --name ${options.name}`;
 | 
			
		||||
    
 | 
			
		||||
    // Add ports
 | 
			
		||||
    if (options.ports) {
 | 
			
		||||
      for (const [hostPort, containerPort] of Object.entries(options.ports)) {
 | 
			
		||||
        command += ` -p ${hostPort}:${containerPort}`;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Add volumes
 | 
			
		||||
    if (options.volumes) {
 | 
			
		||||
      for (const [hostPath, containerPath] of Object.entries(options.volumes)) {
 | 
			
		||||
        command += ` -v "${hostPath}:${containerPath}"`;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Add environment variables
 | 
			
		||||
    if (options.environment) {
 | 
			
		||||
      for (const [key, value] of Object.entries(options.environment)) {
 | 
			
		||||
        command += ` -e ${key}="${value}"`;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Add restart policy
 | 
			
		||||
    if (options.restart) {
 | 
			
		||||
      command += ` --restart ${options.restart}`;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Add image
 | 
			
		||||
    command += ` ${options.image}`;
 | 
			
		||||
    
 | 
			
		||||
    // Add command if provided
 | 
			
		||||
    if (options.command) {
 | 
			
		||||
      command += ` ${options.command}`;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    try {
 | 
			
		||||
      const result = await this.smartshell.exec(command);
 | 
			
		||||
      return result.exitCode === 0;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      logger.log('error', `Failed to run container: ${error.message}`);
 | 
			
		||||
      return false;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Execute a command in a running container
 | 
			
		||||
   */
 | 
			
		||||
  public async exec(containerName: string, command: string): Promise<string> {
 | 
			
		||||
    try {
 | 
			
		||||
      const result = await this.smartshell.exec(`docker exec ${containerName} ${command}`);
 | 
			
		||||
      if (result.exitCode === 0) {
 | 
			
		||||
        return result.stdout;
 | 
			
		||||
      }
 | 
			
		||||
      return '';
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return '';
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get container logs
 | 
			
		||||
   */
 | 
			
		||||
  public async logs(containerName: string, lines?: number): Promise<string> {
 | 
			
		||||
    try {
 | 
			
		||||
      const tailFlag = lines ? `--tail ${lines}` : '';
 | 
			
		||||
      const result = await this.smartshell.exec(`docker logs ${tailFlag} ${containerName}`);
 | 
			
		||||
      return result.stdout;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return `Error getting logs: ${error.message}`;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Check if a container exists
 | 
			
		||||
   */
 | 
			
		||||
  public async exists(containerName: string): Promise<boolean> {
 | 
			
		||||
    const status = await this.getStatus(containerName);
 | 
			
		||||
    return status !== 'not_exists';
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Check if a container is running
 | 
			
		||||
   */
 | 
			
		||||
  public async isRunning(containerName: string): Promise<boolean> {
 | 
			
		||||
    const status = await this.getStatus(containerName);
 | 
			
		||||
    return status === 'running';
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Wait for a container to be ready
 | 
			
		||||
   */
 | 
			
		||||
  public async waitForReady(containerName: string, maxAttempts: number = 30): Promise<boolean> {
 | 
			
		||||
    for (let i = 0; i < maxAttempts; i++) {
 | 
			
		||||
      if (await this.isRunning(containerName)) {
 | 
			
		||||
        return true;
 | 
			
		||||
      }
 | 
			
		||||
      await plugins.smartdelay.delayFor(1000);
 | 
			
		||||
    }
 | 
			
		||||
    return false;
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get container information
 | 
			
		||||
   */
 | 
			
		||||
  public async inspect(containerName: string): Promise<any> {
 | 
			
		||||
    try {
 | 
			
		||||
      const result = await this.smartshell.execSilent(`docker inspect ${containerName}`);
 | 
			
		||||
      if (result.exitCode === 0) {
 | 
			
		||||
        return JSON.parse(result.stdout);
 | 
			
		||||
      }
 | 
			
		||||
      return null;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      return null;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get port mappings for a container
 | 
			
		||||
   */
 | 
			
		||||
  public async getPortMappings(containerName: string): Promise<{ [key: string]: string } | null> {
 | 
			
		||||
    try {
 | 
			
		||||
      // Use docker inspect without format to get full JSON, then extract PortBindings
 | 
			
		||||
      const result = await this.smartshell.execSilent(`docker inspect ${containerName}`);
 | 
			
		||||
      
 | 
			
		||||
      if (result.exitCode === 0 && result.stdout) {
 | 
			
		||||
        const inspectData = JSON.parse(result.stdout);
 | 
			
		||||
        if (inspectData && inspectData[0] && inspectData[0].HostConfig && inspectData[0].HostConfig.PortBindings) {
 | 
			
		||||
          const portBindings = inspectData[0].HostConfig.PortBindings;
 | 
			
		||||
          const mappings: { [key: string]: string } = {};
 | 
			
		||||
          
 | 
			
		||||
          // Convert Docker's port binding format to simple host:container mapping
 | 
			
		||||
          for (const [containerPort, hostBindings] of Object.entries(portBindings)) {
 | 
			
		||||
            if (Array.isArray(hostBindings) && hostBindings.length > 0) {
 | 
			
		||||
              const hostPort = (hostBindings[0] as any).HostPort;
 | 
			
		||||
              if (hostPort) {
 | 
			
		||||
                mappings[containerPort.replace('/tcp', '').replace('/udp', '')] = hostPort;
 | 
			
		||||
              }
 | 
			
		||||
            }
 | 
			
		||||
          }
 | 
			
		||||
          
 | 
			
		||||
          return mappings;
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
      return null;
 | 
			
		||||
    } catch (error) {
 | 
			
		||||
      // Silently fail - container might not exist
 | 
			
		||||
      return null;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										432
									
								
								ts/mod_services/classes.serviceconfiguration.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										432
									
								
								ts/mod_services/classes.serviceconfiguration.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,432 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as helpers from './helpers.js';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
import { DockerContainer } from './classes.dockercontainer.js';
 | 
			
		||||
 | 
			
		||||
export interface IServiceConfig {
 | 
			
		||||
  PROJECT_NAME: string;
 | 
			
		||||
  MONGODB_HOST: string;
 | 
			
		||||
  MONGODB_NAME: string;
 | 
			
		||||
  MONGODB_PORT: string;
 | 
			
		||||
  MONGODB_USER: string;
 | 
			
		||||
  MONGODB_PASS: string;
 | 
			
		||||
  MONGODB_URL: string;
 | 
			
		||||
  S3_HOST: string;
 | 
			
		||||
  S3_PORT: string;
 | 
			
		||||
  S3_CONSOLE_PORT: string;
 | 
			
		||||
  S3_ACCESSKEY: string;
 | 
			
		||||
  S3_SECRETKEY: string;
 | 
			
		||||
  S3_BUCKET: string;
 | 
			
		||||
  S3_ENDPOINT: string;
 | 
			
		||||
  S3_USESSL: boolean;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
export class ServiceConfiguration {
 | 
			
		||||
  private configPath: string;
 | 
			
		||||
  private config: IServiceConfig;
 | 
			
		||||
  private docker: DockerContainer;
 | 
			
		||||
  
 | 
			
		||||
  constructor() {
 | 
			
		||||
    this.configPath = plugins.path.join(process.cwd(), '.nogit', 'env.json');
 | 
			
		||||
    this.docker = new DockerContainer();
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Load or create the configuration
 | 
			
		||||
   */
 | 
			
		||||
  public async loadOrCreate(): Promise<IServiceConfig> {
 | 
			
		||||
    await this.ensureNogitDirectory();
 | 
			
		||||
    
 | 
			
		||||
    if (await this.configExists()) {
 | 
			
		||||
      await this.loadConfig();
 | 
			
		||||
      await this.updateMissingFields();
 | 
			
		||||
    } else {
 | 
			
		||||
      await this.createDefaultConfig();
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Sync ports from existing Docker containers if they exist
 | 
			
		||||
    await this.syncPortsFromDocker();
 | 
			
		||||
    
 | 
			
		||||
    return this.config;
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get the current configuration
 | 
			
		||||
   */
 | 
			
		||||
  public getConfig(): IServiceConfig {
 | 
			
		||||
    return this.config;
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Save the configuration to file
 | 
			
		||||
   */
 | 
			
		||||
  public async saveConfig(): Promise<void> {
 | 
			
		||||
    await plugins.smartfile.memory.toFs(
 | 
			
		||||
      JSON.stringify(this.config, null, 2),
 | 
			
		||||
      this.configPath
 | 
			
		||||
    );
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Ensure .nogit directory exists
 | 
			
		||||
   */
 | 
			
		||||
  private async ensureNogitDirectory(): Promise<void> {
 | 
			
		||||
    const nogitPath = plugins.path.join(process.cwd(), '.nogit');
 | 
			
		||||
    await plugins.smartfile.fs.ensureDir(nogitPath);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Check if configuration file exists
 | 
			
		||||
   */
 | 
			
		||||
  private async configExists(): Promise<boolean> {
 | 
			
		||||
    return plugins.smartfile.fs.fileExists(this.configPath);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Load configuration from file
 | 
			
		||||
   */
 | 
			
		||||
  private async loadConfig(): Promise<void> {
 | 
			
		||||
    const configContent = plugins.smartfile.fs.toStringSync(this.configPath);
 | 
			
		||||
    this.config = JSON.parse(configContent);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Create default configuration
 | 
			
		||||
   */
 | 
			
		||||
  private async createDefaultConfig(): Promise<void> {
 | 
			
		||||
    const projectName = helpers.getProjectName();
 | 
			
		||||
    const mongoPort = await helpers.getRandomAvailablePort();
 | 
			
		||||
    const s3Port = await helpers.getRandomAvailablePort();
 | 
			
		||||
    let s3ConsolePort = s3Port + 1;
 | 
			
		||||
    
 | 
			
		||||
    // Ensure console port is also available
 | 
			
		||||
    while (!(await helpers.isPortAvailable(s3ConsolePort))) {
 | 
			
		||||
      s3ConsolePort++;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    const mongoUser = 'defaultadmin';
 | 
			
		||||
    const mongoPass = 'defaultpass';
 | 
			
		||||
    const mongoHost = 'localhost';
 | 
			
		||||
    const mongoName = projectName;
 | 
			
		||||
    const mongoPortStr = mongoPort.toString();
 | 
			
		||||
    const s3Host = 'localhost';
 | 
			
		||||
    const s3PortStr = s3Port.toString();
 | 
			
		||||
    
 | 
			
		||||
    this.config = {
 | 
			
		||||
      PROJECT_NAME: projectName,
 | 
			
		||||
      MONGODB_HOST: mongoHost,
 | 
			
		||||
      MONGODB_NAME: mongoName,
 | 
			
		||||
      MONGODB_PORT: mongoPortStr,
 | 
			
		||||
      MONGODB_USER: mongoUser,
 | 
			
		||||
      MONGODB_PASS: mongoPass,
 | 
			
		||||
      MONGODB_URL: `mongodb://${mongoUser}:${mongoPass}@${mongoHost}:${mongoPortStr}/${mongoName}?authSource=admin`,
 | 
			
		||||
      S3_HOST: s3Host,
 | 
			
		||||
      S3_PORT: s3PortStr,
 | 
			
		||||
      S3_CONSOLE_PORT: s3ConsolePort.toString(),
 | 
			
		||||
      S3_ACCESSKEY: 'defaultadmin',
 | 
			
		||||
      S3_SECRETKEY: 'defaultpass',
 | 
			
		||||
      S3_BUCKET: `${projectName}-documents`,
 | 
			
		||||
      S3_ENDPOINT: s3Host,
 | 
			
		||||
      S3_USESSL: false
 | 
			
		||||
    };
 | 
			
		||||
    
 | 
			
		||||
    await this.saveConfig();
 | 
			
		||||
    
 | 
			
		||||
    logger.log('ok', '✅ Created .nogit/env.json with project defaults');
 | 
			
		||||
    logger.log('info', `📍 MongoDB port: ${mongoPort}`);
 | 
			
		||||
    logger.log('info', `📍 S3 API port: ${s3Port}`);
 | 
			
		||||
    logger.log('info', `📍 S3 Console port: ${s3ConsolePort}`);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Update missing fields in existing configuration
 | 
			
		||||
   */
 | 
			
		||||
  private async updateMissingFields(): Promise<void> {
 | 
			
		||||
    const projectName = helpers.getProjectName();
 | 
			
		||||
    let updated = false;
 | 
			
		||||
    const fieldsAdded: string[] = [];
 | 
			
		||||
    
 | 
			
		||||
    // Check and add missing fields
 | 
			
		||||
    if (!this.config.PROJECT_NAME) {
 | 
			
		||||
      this.config.PROJECT_NAME = projectName;
 | 
			
		||||
      fieldsAdded.push('PROJECT_NAME');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.MONGODB_HOST) {
 | 
			
		||||
      this.config.MONGODB_HOST = 'localhost';
 | 
			
		||||
      fieldsAdded.push('MONGODB_HOST');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.MONGODB_NAME) {
 | 
			
		||||
      this.config.MONGODB_NAME = projectName;
 | 
			
		||||
      fieldsAdded.push('MONGODB_NAME');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.MONGODB_PORT) {
 | 
			
		||||
      const port = await helpers.getRandomAvailablePort();
 | 
			
		||||
      this.config.MONGODB_PORT = port.toString();
 | 
			
		||||
      fieldsAdded.push(`MONGODB_PORT(${port})`);
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.MONGODB_USER) {
 | 
			
		||||
      this.config.MONGODB_USER = 'defaultadmin';
 | 
			
		||||
      fieldsAdded.push('MONGODB_USER');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.MONGODB_PASS) {
 | 
			
		||||
      this.config.MONGODB_PASS = 'defaultpass';
 | 
			
		||||
      fieldsAdded.push('MONGODB_PASS');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Always update MONGODB_URL based on current settings
 | 
			
		||||
    const oldUrl = this.config.MONGODB_URL;
 | 
			
		||||
    this.config.MONGODB_URL = `mongodb://${this.config.MONGODB_USER}:${this.config.MONGODB_PASS}@${this.config.MONGODB_HOST}:${this.config.MONGODB_PORT}/${this.config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
    if (oldUrl !== this.config.MONGODB_URL) {
 | 
			
		||||
      fieldsAdded.push('MONGODB_URL');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_HOST) {
 | 
			
		||||
      this.config.S3_HOST = 'localhost';
 | 
			
		||||
      fieldsAdded.push('S3_HOST');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_PORT) {
 | 
			
		||||
      const port = await helpers.getRandomAvailablePort();
 | 
			
		||||
      this.config.S3_PORT = port.toString();
 | 
			
		||||
      fieldsAdded.push(`S3_PORT(${port})`);
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_CONSOLE_PORT) {
 | 
			
		||||
      const s3Port = parseInt(this.config.S3_PORT);
 | 
			
		||||
      let consolePort = s3Port + 1;
 | 
			
		||||
      
 | 
			
		||||
      while (!(await helpers.isPortAvailable(consolePort))) {
 | 
			
		||||
        consolePort++;
 | 
			
		||||
      }
 | 
			
		||||
      
 | 
			
		||||
      this.config.S3_CONSOLE_PORT = consolePort.toString();
 | 
			
		||||
      fieldsAdded.push(`S3_CONSOLE_PORT(${consolePort})`);
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_ACCESSKEY) {
 | 
			
		||||
      this.config.S3_ACCESSKEY = 'defaultadmin';
 | 
			
		||||
      fieldsAdded.push('S3_ACCESSKEY');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_SECRETKEY) {
 | 
			
		||||
      this.config.S3_SECRETKEY = 'defaultpass';
 | 
			
		||||
      fieldsAdded.push('S3_SECRETKEY');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_BUCKET) {
 | 
			
		||||
      this.config.S3_BUCKET = `${projectName}-documents`;
 | 
			
		||||
      fieldsAdded.push('S3_BUCKET');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!this.config.S3_USESSL) {
 | 
			
		||||
      this.config.S3_USESSL = false;
 | 
			
		||||
      fieldsAdded.push('S3_USESSL');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Always update S3_ENDPOINT based on current settings
 | 
			
		||||
    const oldEndpoint = this.config.S3_ENDPOINT;
 | 
			
		||||
    this.config.S3_ENDPOINT = this.config.S3_HOST;
 | 
			
		||||
    if (oldEndpoint !== this.config.S3_ENDPOINT) {
 | 
			
		||||
      fieldsAdded.push('S3_ENDPOINT');
 | 
			
		||||
      updated = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (updated) {
 | 
			
		||||
      await this.saveConfig();
 | 
			
		||||
      logger.log('ok', `✅ Added missing fields: ${fieldsAdded.join(', ')}`);
 | 
			
		||||
    } else {
 | 
			
		||||
      logger.log('ok', '✅ Configuration complete');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get MongoDB connection string
 | 
			
		||||
   */
 | 
			
		||||
  public getMongoConnectionString(useNetworkIp: boolean = false): string {
 | 
			
		||||
    const host = useNetworkIp ? '${networkIp}' : this.config.MONGODB_HOST;
 | 
			
		||||
    return `mongodb://${this.config.MONGODB_USER}:${this.config.MONGODB_PASS}@${host}:${this.config.MONGODB_PORT}/${this.config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get container names
 | 
			
		||||
   */
 | 
			
		||||
  public getContainerNames() {
 | 
			
		||||
    return {
 | 
			
		||||
      mongo: `${this.config.PROJECT_NAME}-mongodb`,
 | 
			
		||||
      minio: `${this.config.PROJECT_NAME}-minio`
 | 
			
		||||
    };
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Get data directories
 | 
			
		||||
   */
 | 
			
		||||
  public getDataDirectories() {
 | 
			
		||||
    return {
 | 
			
		||||
      mongo: plugins.path.join(process.cwd(), '.nogit', 'mongodata'),
 | 
			
		||||
      minio: plugins.path.join(process.cwd(), '.nogit', 'miniodata')
 | 
			
		||||
    };
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Sync port configuration from existing Docker containers
 | 
			
		||||
   */
 | 
			
		||||
  private async syncPortsFromDocker(): Promise<void> {
 | 
			
		||||
    const containers = this.getContainerNames();
 | 
			
		||||
    let updated = false;
 | 
			
		||||
    
 | 
			
		||||
    // Check MongoDB container
 | 
			
		||||
    const mongoStatus = await this.docker.getStatus(containers.mongo);
 | 
			
		||||
    if (mongoStatus !== 'not_exists') {
 | 
			
		||||
      const portMappings = await this.docker.getPortMappings(containers.mongo);
 | 
			
		||||
      if (portMappings && portMappings['27017']) {
 | 
			
		||||
        const dockerPort = portMappings['27017'];
 | 
			
		||||
        if (this.config.MONGODB_PORT !== dockerPort) {
 | 
			
		||||
          logger.log('note', `📍 Syncing MongoDB port from Docker: ${dockerPort}`);
 | 
			
		||||
          this.config.MONGODB_PORT = dockerPort;
 | 
			
		||||
          updated = true;
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Check MinIO container
 | 
			
		||||
    const minioStatus = await this.docker.getStatus(containers.minio);
 | 
			
		||||
    if (minioStatus !== 'not_exists') {
 | 
			
		||||
      const portMappings = await this.docker.getPortMappings(containers.minio);
 | 
			
		||||
      if (portMappings) {
 | 
			
		||||
        if (portMappings['9000']) {
 | 
			
		||||
          const dockerPort = portMappings['9000'];
 | 
			
		||||
          if (this.config.S3_PORT !== dockerPort) {
 | 
			
		||||
            logger.log('note', `📍 Syncing S3 API port from Docker: ${dockerPort}`);
 | 
			
		||||
            this.config.S3_PORT = dockerPort;
 | 
			
		||||
            updated = true;
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
        if (portMappings['9001']) {
 | 
			
		||||
          const dockerPort = portMappings['9001'];
 | 
			
		||||
          if (this.config.S3_CONSOLE_PORT !== dockerPort) {
 | 
			
		||||
            logger.log('note', `📍 Syncing S3 Console port from Docker: ${dockerPort}`);
 | 
			
		||||
            this.config.S3_CONSOLE_PORT = dockerPort;
 | 
			
		||||
            updated = true;
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (updated) {
 | 
			
		||||
      // Update derived fields
 | 
			
		||||
      this.config.MONGODB_URL = `mongodb://${this.config.MONGODB_USER}:${this.config.MONGODB_PASS}@${this.config.MONGODB_HOST}:${this.config.MONGODB_PORT}/${this.config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
      this.config.S3_ENDPOINT = this.config.S3_HOST;
 | 
			
		||||
      
 | 
			
		||||
      await this.saveConfig();
 | 
			
		||||
      logger.log('ok', '✅ Configuration synced with Docker containers');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Validate and update ports if they're not available
 | 
			
		||||
   */
 | 
			
		||||
  public async validateAndUpdatePorts(): Promise<boolean> {
 | 
			
		||||
    let updated = false;
 | 
			
		||||
    const containers = this.getContainerNames();
 | 
			
		||||
    
 | 
			
		||||
    // Check if containers exist - if they do, ports are fine
 | 
			
		||||
    const mongoExists = await this.docker.exists(containers.mongo);
 | 
			
		||||
    const minioExists = await this.docker.exists(containers.minio);
 | 
			
		||||
    
 | 
			
		||||
    // Only check port availability if containers don't exist
 | 
			
		||||
    if (!mongoExists) {
 | 
			
		||||
      const mongoPort = parseInt(this.config.MONGODB_PORT);
 | 
			
		||||
      if (!(await helpers.isPortAvailable(mongoPort))) {
 | 
			
		||||
        logger.log('note', `⚠️  MongoDB port ${mongoPort} is in use, finding new port...`);
 | 
			
		||||
        const newPort = await helpers.getRandomAvailablePort();
 | 
			
		||||
        this.config.MONGODB_PORT = newPort.toString();
 | 
			
		||||
        logger.log('ok', `✅ New MongoDB port: ${newPort}`);
 | 
			
		||||
        updated = true;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!minioExists) {
 | 
			
		||||
      const s3Port = parseInt(this.config.S3_PORT);
 | 
			
		||||
      const s3ConsolePort = parseInt(this.config.S3_CONSOLE_PORT);
 | 
			
		||||
      
 | 
			
		||||
      if (!(await helpers.isPortAvailable(s3Port))) {
 | 
			
		||||
        logger.log('note', `⚠️  S3 API port ${s3Port} is in use, finding new port...`);
 | 
			
		||||
        const newPort = await helpers.getRandomAvailablePort();
 | 
			
		||||
        this.config.S3_PORT = newPort.toString();
 | 
			
		||||
        logger.log('ok', `✅ New S3 API port: ${newPort}`);
 | 
			
		||||
        updated = true;
 | 
			
		||||
      }
 | 
			
		||||
      
 | 
			
		||||
      if (!(await helpers.isPortAvailable(s3ConsolePort))) {
 | 
			
		||||
        logger.log('note', `⚠️  S3 Console port ${s3ConsolePort} is in use, finding new port...`);
 | 
			
		||||
        let newPort = parseInt(this.config.S3_PORT) + 1;
 | 
			
		||||
        while (!(await helpers.isPortAvailable(newPort))) {
 | 
			
		||||
          newPort++;
 | 
			
		||||
        }
 | 
			
		||||
        this.config.S3_CONSOLE_PORT = newPort.toString();
 | 
			
		||||
        logger.log('ok', `✅ New S3 Console port: ${newPort}`);
 | 
			
		||||
        updated = true;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (updated) {
 | 
			
		||||
      // Update derived fields
 | 
			
		||||
      this.config.MONGODB_URL = `mongodb://${this.config.MONGODB_USER}:${this.config.MONGODB_PASS}@${this.config.MONGODB_HOST}:${this.config.MONGODB_PORT}/${this.config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
      this.config.S3_ENDPOINT = this.config.S3_HOST;
 | 
			
		||||
      
 | 
			
		||||
      await this.saveConfig();
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    return updated;
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Force reconfigure all ports with new available ones
 | 
			
		||||
   */
 | 
			
		||||
  public async reconfigurePorts(): Promise<void> {
 | 
			
		||||
    logger.log('note', '🔄 Finding new available ports...');
 | 
			
		||||
    
 | 
			
		||||
    const mongoPort = await helpers.getRandomAvailablePort();
 | 
			
		||||
    const s3Port = await helpers.getRandomAvailablePort();
 | 
			
		||||
    let s3ConsolePort = s3Port + 1;
 | 
			
		||||
    
 | 
			
		||||
    // Ensure console port is also available
 | 
			
		||||
    while (!(await helpers.isPortAvailable(s3ConsolePort))) {
 | 
			
		||||
      s3ConsolePort++;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    this.config.MONGODB_PORT = mongoPort.toString();
 | 
			
		||||
    this.config.S3_PORT = s3Port.toString();
 | 
			
		||||
    this.config.S3_CONSOLE_PORT = s3ConsolePort.toString();
 | 
			
		||||
    
 | 
			
		||||
    // Update derived fields
 | 
			
		||||
    this.config.MONGODB_URL = `mongodb://${this.config.MONGODB_USER}:${this.config.MONGODB_PASS}@${this.config.MONGODB_HOST}:${this.config.MONGODB_PORT}/${this.config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
    this.config.S3_ENDPOINT = this.config.S3_HOST;
 | 
			
		||||
    
 | 
			
		||||
    await this.saveConfig();
 | 
			
		||||
    
 | 
			
		||||
    logger.log('ok', '✅ New port configuration:');
 | 
			
		||||
    logger.log('info', `  📍 MongoDB: ${mongoPort}`);
 | 
			
		||||
    logger.log('info', `  📍 S3 API: ${s3Port}`);
 | 
			
		||||
    logger.log('info', `  📍 S3 Console: ${s3ConsolePort}`);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										583
									
								
								ts/mod_services/classes.servicemanager.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										583
									
								
								ts/mod_services/classes.servicemanager.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,583 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as helpers from './helpers.js';
 | 
			
		||||
import { ServiceConfiguration } from './classes.serviceconfiguration.js';
 | 
			
		||||
import { DockerContainer } from './classes.dockercontainer.js';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
 | 
			
		||||
export class ServiceManager {
 | 
			
		||||
  private config: ServiceConfiguration;
 | 
			
		||||
  private docker: DockerContainer;
 | 
			
		||||
  
 | 
			
		||||
  constructor() {
 | 
			
		||||
    this.config = new ServiceConfiguration();
 | 
			
		||||
    this.docker = new DockerContainer();
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Initialize the service manager
 | 
			
		||||
   */
 | 
			
		||||
  public async init(): Promise<void> {
 | 
			
		||||
    // Check Docker availability
 | 
			
		||||
    if (!(await this.docker.checkDocker())) {
 | 
			
		||||
      logger.log('error', 'Error: Docker is not installed. Please install Docker first.');
 | 
			
		||||
      process.exit(1);
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Load or create configuration
 | 
			
		||||
    await this.config.loadOrCreate();
 | 
			
		||||
    logger.log('info', `📋 Project: ${this.config.getConfig().PROJECT_NAME}`);
 | 
			
		||||
    
 | 
			
		||||
    // Validate and update ports if needed
 | 
			
		||||
    await this.config.validateAndUpdatePorts();
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Start MongoDB service
 | 
			
		||||
   */
 | 
			
		||||
  public async startMongoDB(): Promise<void> {
 | 
			
		||||
    logger.log('note', '📦 MongoDB:');
 | 
			
		||||
    
 | 
			
		||||
    const config = this.config.getConfig();
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    const directories = this.config.getDataDirectories();
 | 
			
		||||
    
 | 
			
		||||
    // Ensure data directory exists
 | 
			
		||||
    await plugins.smartfile.fs.ensureDir(directories.mongo);
 | 
			
		||||
    
 | 
			
		||||
    const status = await this.docker.getStatus(containers.mongo);
 | 
			
		||||
    
 | 
			
		||||
    switch (status) {
 | 
			
		||||
      case 'running':
 | 
			
		||||
        logger.log('ok', '  Already running ✓');
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      case 'stopped':
 | 
			
		||||
        // Check if port mapping matches config
 | 
			
		||||
        const mongoPortMappings = await this.docker.getPortMappings(containers.mongo);
 | 
			
		||||
        if (mongoPortMappings && mongoPortMappings['27017'] !== config.MONGODB_PORT) {
 | 
			
		||||
          logger.log('note', '  Port configuration changed, recreating container...');
 | 
			
		||||
          await this.docker.remove(containers.mongo, true);
 | 
			
		||||
          // Fall through to create new container
 | 
			
		||||
          const success = await this.docker.run({
 | 
			
		||||
            name: containers.mongo,
 | 
			
		||||
            image: 'mongo:7.0',
 | 
			
		||||
            ports: {
 | 
			
		||||
              [`0.0.0.0:${config.MONGODB_PORT}`]: '27017'
 | 
			
		||||
            },
 | 
			
		||||
            volumes: {
 | 
			
		||||
              [directories.mongo]: '/data/db'
 | 
			
		||||
            },
 | 
			
		||||
            environment: {
 | 
			
		||||
              MONGO_INITDB_ROOT_USERNAME: config.MONGODB_USER,
 | 
			
		||||
              MONGO_INITDB_ROOT_PASSWORD: config.MONGODB_PASS,
 | 
			
		||||
              MONGO_INITDB_DATABASE: config.MONGODB_NAME
 | 
			
		||||
            },
 | 
			
		||||
            restart: 'unless-stopped',
 | 
			
		||||
            command: '--bind_ip_all'
 | 
			
		||||
          });
 | 
			
		||||
          
 | 
			
		||||
          if (success) {
 | 
			
		||||
            logger.log('ok', '  Recreated with new port ✓');
 | 
			
		||||
          } else {
 | 
			
		||||
            logger.log('error', '  Failed to recreate container');
 | 
			
		||||
          }
 | 
			
		||||
        } else {
 | 
			
		||||
          // Ports match, just start the container
 | 
			
		||||
          if (await this.docker.start(containers.mongo)) {
 | 
			
		||||
            logger.log('ok', '  Started ✓');
 | 
			
		||||
          } else {
 | 
			
		||||
            logger.log('error', '  Failed to start');
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      case 'not_exists':
 | 
			
		||||
        logger.log('note', '  Creating container...');
 | 
			
		||||
        
 | 
			
		||||
        const success = await this.docker.run({
 | 
			
		||||
          name: containers.mongo,
 | 
			
		||||
          image: 'mongo:7.0',
 | 
			
		||||
          ports: {
 | 
			
		||||
            [`0.0.0.0:${config.MONGODB_PORT}`]: '27017'
 | 
			
		||||
          },
 | 
			
		||||
          volumes: {
 | 
			
		||||
            [directories.mongo]: '/data/db'
 | 
			
		||||
          },
 | 
			
		||||
          environment: {
 | 
			
		||||
            MONGO_INITDB_ROOT_USERNAME: config.MONGODB_USER,
 | 
			
		||||
            MONGO_INITDB_ROOT_PASSWORD: config.MONGODB_PASS,
 | 
			
		||||
            MONGO_INITDB_DATABASE: config.MONGODB_NAME
 | 
			
		||||
          },
 | 
			
		||||
          restart: 'unless-stopped',
 | 
			
		||||
          command: '--bind_ip_all'
 | 
			
		||||
        });
 | 
			
		||||
        
 | 
			
		||||
        if (success) {
 | 
			
		||||
          logger.log('ok', '  Created and started ✓');
 | 
			
		||||
        } else {
 | 
			
		||||
          logger.log('error', '  Failed to create container');
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    logger.log('info', `  Container: ${containers.mongo}`);
 | 
			
		||||
    logger.log('info', `  Port: ${config.MONGODB_PORT}`);
 | 
			
		||||
    logger.log('info', `  Connection: ${this.config.getMongoConnectionString()}`);
 | 
			
		||||
    
 | 
			
		||||
    // Show Compass connection string
 | 
			
		||||
    const networkIp = await helpers.getLocalNetworkIp();
 | 
			
		||||
    const compassString = `mongodb://${config.MONGODB_USER}:${config.MONGODB_PASS}@${networkIp}:${config.MONGODB_PORT}/${config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
    logger.log('ok', `  Compass: ${compassString}`);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Start MinIO service
 | 
			
		||||
   */
 | 
			
		||||
  public async startMinIO(): Promise<void> {
 | 
			
		||||
    logger.log('note', '📦 S3/MinIO:');
 | 
			
		||||
    
 | 
			
		||||
    const config = this.config.getConfig();
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    const directories = this.config.getDataDirectories();
 | 
			
		||||
    
 | 
			
		||||
    // Ensure data directory exists
 | 
			
		||||
    await plugins.smartfile.fs.ensureDir(directories.minio);
 | 
			
		||||
    
 | 
			
		||||
    const status = await this.docker.getStatus(containers.minio);
 | 
			
		||||
    
 | 
			
		||||
    switch (status) {
 | 
			
		||||
      case 'running':
 | 
			
		||||
        logger.log('ok', '  Already running ✓');
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      case 'stopped':
 | 
			
		||||
        // Check if port mapping matches config
 | 
			
		||||
        const minioPortMappings = await this.docker.getPortMappings(containers.minio);
 | 
			
		||||
        if (minioPortMappings && 
 | 
			
		||||
            (minioPortMappings['9000'] !== config.S3_PORT || 
 | 
			
		||||
             minioPortMappings['9001'] !== config.S3_CONSOLE_PORT)) {
 | 
			
		||||
          logger.log('note', '  Port configuration changed, recreating container...');
 | 
			
		||||
          await this.docker.remove(containers.minio, true);
 | 
			
		||||
          // Fall through to create new container
 | 
			
		||||
          const success = await this.docker.run({
 | 
			
		||||
            name: containers.minio,
 | 
			
		||||
            image: 'minio/minio',
 | 
			
		||||
            ports: {
 | 
			
		||||
              [config.S3_PORT]: '9000',
 | 
			
		||||
              [config.S3_CONSOLE_PORT]: '9001'
 | 
			
		||||
            },
 | 
			
		||||
            volumes: {
 | 
			
		||||
              [directories.minio]: '/data'
 | 
			
		||||
            },
 | 
			
		||||
            environment: {
 | 
			
		||||
              MINIO_ROOT_USER: config.S3_ACCESSKEY,
 | 
			
		||||
              MINIO_ROOT_PASSWORD: config.S3_SECRETKEY
 | 
			
		||||
            },
 | 
			
		||||
            restart: 'unless-stopped',
 | 
			
		||||
            command: 'server /data --console-address ":9001"'
 | 
			
		||||
          });
 | 
			
		||||
          
 | 
			
		||||
          if (success) {
 | 
			
		||||
            logger.log('ok', '  Recreated with new ports ✓');
 | 
			
		||||
            
 | 
			
		||||
            // Wait for MinIO to be ready
 | 
			
		||||
            await plugins.smartdelay.delayFor(3000);
 | 
			
		||||
            
 | 
			
		||||
            // Create default bucket
 | 
			
		||||
            await this.docker.exec(
 | 
			
		||||
              containers.minio,
 | 
			
		||||
              `mc alias set local http://localhost:9000 ${config.S3_ACCESSKEY} ${config.S3_SECRETKEY}`
 | 
			
		||||
            );
 | 
			
		||||
            
 | 
			
		||||
            await this.docker.exec(
 | 
			
		||||
              containers.minio,
 | 
			
		||||
              `mc mb local/${config.S3_BUCKET}`
 | 
			
		||||
            );
 | 
			
		||||
            
 | 
			
		||||
            logger.log('ok', `  Bucket '${config.S3_BUCKET}' created ✓`);
 | 
			
		||||
          } else {
 | 
			
		||||
            logger.log('error', '  Failed to recreate container');
 | 
			
		||||
          }
 | 
			
		||||
        } else {
 | 
			
		||||
          // Ports match, just start the container
 | 
			
		||||
          if (await this.docker.start(containers.minio)) {
 | 
			
		||||
            logger.log('ok', '  Started ✓');
 | 
			
		||||
          } else {
 | 
			
		||||
            logger.log('error', '  Failed to start');
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      case 'not_exists':
 | 
			
		||||
        logger.log('note', '  Creating container...');
 | 
			
		||||
        
 | 
			
		||||
        const success = await this.docker.run({
 | 
			
		||||
          name: containers.minio,
 | 
			
		||||
          image: 'minio/minio',
 | 
			
		||||
          ports: {
 | 
			
		||||
            [config.S3_PORT]: '9000',
 | 
			
		||||
            [config.S3_CONSOLE_PORT]: '9001'
 | 
			
		||||
          },
 | 
			
		||||
          volumes: {
 | 
			
		||||
            [directories.minio]: '/data'
 | 
			
		||||
          },
 | 
			
		||||
          environment: {
 | 
			
		||||
            MINIO_ROOT_USER: config.S3_ACCESSKEY,
 | 
			
		||||
            MINIO_ROOT_PASSWORD: config.S3_SECRETKEY
 | 
			
		||||
          },
 | 
			
		||||
          restart: 'unless-stopped',
 | 
			
		||||
          command: 'server /data --console-address ":9001"'
 | 
			
		||||
        });
 | 
			
		||||
        
 | 
			
		||||
        if (success) {
 | 
			
		||||
          logger.log('ok', '  Created and started ✓');
 | 
			
		||||
          
 | 
			
		||||
          // Wait for MinIO to be ready
 | 
			
		||||
          await plugins.smartdelay.delayFor(3000);
 | 
			
		||||
          
 | 
			
		||||
          // Create default bucket
 | 
			
		||||
          await this.docker.exec(
 | 
			
		||||
            containers.minio,
 | 
			
		||||
            `mc alias set local http://localhost:9000 ${config.S3_ACCESSKEY} ${config.S3_SECRETKEY}`
 | 
			
		||||
          );
 | 
			
		||||
          
 | 
			
		||||
          await this.docker.exec(
 | 
			
		||||
            containers.minio,
 | 
			
		||||
            `mc mb local/${config.S3_BUCKET}`
 | 
			
		||||
          );
 | 
			
		||||
          
 | 
			
		||||
          logger.log('ok', `  Bucket '${config.S3_BUCKET}' created ✓`);
 | 
			
		||||
        } else {
 | 
			
		||||
          logger.log('error', '  Failed to create container');
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    logger.log('info', `  Container: ${containers.minio}`);
 | 
			
		||||
    logger.log('info', `  Port: ${config.S3_PORT}`);
 | 
			
		||||
    logger.log('info', `  Bucket: ${config.S3_BUCKET}`);
 | 
			
		||||
    logger.log('info', `  API: http://${config.S3_HOST}:${config.S3_PORT}`);
 | 
			
		||||
    logger.log('info', `  Console: http://${config.S3_HOST}:${config.S3_CONSOLE_PORT} (login: ${config.S3_ACCESSKEY}/***)`);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Stop MongoDB service
 | 
			
		||||
   */
 | 
			
		||||
  public async stopMongoDB(): Promise<void> {
 | 
			
		||||
    logger.log('note', '📦 MongoDB:');
 | 
			
		||||
    
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    const status = await this.docker.getStatus(containers.mongo);
 | 
			
		||||
    
 | 
			
		||||
    if (status === 'running') {
 | 
			
		||||
      if (await this.docker.stop(containers.mongo)) {
 | 
			
		||||
        logger.log('ok', '  Stopped ✓');
 | 
			
		||||
      } else {
 | 
			
		||||
        logger.log('error', '  Failed to stop');
 | 
			
		||||
      }
 | 
			
		||||
    } else {
 | 
			
		||||
      logger.log('note', '  Not running');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Stop MinIO service
 | 
			
		||||
   */
 | 
			
		||||
  public async stopMinIO(): Promise<void> {
 | 
			
		||||
    logger.log('note', '📦 S3/MinIO:');
 | 
			
		||||
    
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    const status = await this.docker.getStatus(containers.minio);
 | 
			
		||||
    
 | 
			
		||||
    if (status === 'running') {
 | 
			
		||||
      if (await this.docker.stop(containers.minio)) {
 | 
			
		||||
        logger.log('ok', '  Stopped ✓');
 | 
			
		||||
      } else {
 | 
			
		||||
        logger.log('error', '  Failed to stop');
 | 
			
		||||
      }
 | 
			
		||||
    } else {
 | 
			
		||||
      logger.log('note', '  Not running');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Show service status
 | 
			
		||||
   */
 | 
			
		||||
  public async showStatus(): Promise<void> {
 | 
			
		||||
    helpers.printHeader('Service Status');
 | 
			
		||||
    
 | 
			
		||||
    const config = this.config.getConfig();
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    
 | 
			
		||||
    logger.log('info', `Project: ${config.PROJECT_NAME}`);
 | 
			
		||||
    console.log();
 | 
			
		||||
    
 | 
			
		||||
    // MongoDB status
 | 
			
		||||
    const mongoStatus = await this.docker.getStatus(containers.mongo);
 | 
			
		||||
    switch (mongoStatus) {
 | 
			
		||||
      case 'running':
 | 
			
		||||
        logger.log('ok', '📦 MongoDB: 🟢 Running');
 | 
			
		||||
        logger.log('info', `   ├─ Container: ${containers.mongo}`);
 | 
			
		||||
        logger.log('info', `   ├─ Port: ${config.MONGODB_PORT}`);
 | 
			
		||||
        logger.log('info', `   ├─ Connection: ${this.config.getMongoConnectionString()}`);
 | 
			
		||||
        
 | 
			
		||||
        // Show Compass connection string
 | 
			
		||||
        const networkIp = await helpers.getLocalNetworkIp();
 | 
			
		||||
        const compassString = `mongodb://${config.MONGODB_USER}:${config.MONGODB_PASS}@${networkIp}:${config.MONGODB_PORT}/${config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
        logger.log('ok', `   └─ Compass: ${compassString}`);
 | 
			
		||||
        break;
 | 
			
		||||
      case 'stopped':
 | 
			
		||||
        logger.log('note', '📦 MongoDB: 🟡 Stopped');
 | 
			
		||||
        logger.log('info', `   ├─ Container: ${containers.mongo}`);
 | 
			
		||||
        logger.log('info', `   └─ Port: ${config.MONGODB_PORT}`);
 | 
			
		||||
        break;
 | 
			
		||||
      case 'not_exists':
 | 
			
		||||
        logger.log('info', '📦 MongoDB: ⚪ Not installed');
 | 
			
		||||
        // Check port availability
 | 
			
		||||
        const mongoPort = parseInt(config.MONGODB_PORT);
 | 
			
		||||
        const mongoAvailable = await helpers.isPortAvailable(mongoPort);
 | 
			
		||||
        if (!mongoAvailable) {
 | 
			
		||||
          logger.log('error', `   └─ ⚠️  Port ${mongoPort} is in use by another process`);
 | 
			
		||||
        } else {
 | 
			
		||||
          logger.log('info', `   └─ Port ${mongoPort} is available`);
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // MinIO status
 | 
			
		||||
    const minioStatus = await this.docker.getStatus(containers.minio);
 | 
			
		||||
    switch (minioStatus) {
 | 
			
		||||
      case 'running':
 | 
			
		||||
        logger.log('ok', '📦 S3/MinIO: 🟢 Running');
 | 
			
		||||
        logger.log('info', `   ├─ Container: ${containers.minio}`);
 | 
			
		||||
        logger.log('info', `   ├─ API: http://${config.S3_HOST}:${config.S3_PORT}`);
 | 
			
		||||
        logger.log('info', `   ├─ Console: http://${config.S3_HOST}:${config.S3_CONSOLE_PORT}`);
 | 
			
		||||
        logger.log('info', `   └─ Bucket: ${config.S3_BUCKET}`);
 | 
			
		||||
        break;
 | 
			
		||||
      case 'stopped':
 | 
			
		||||
        logger.log('note', '📦 S3/MinIO: 🟡 Stopped');
 | 
			
		||||
        logger.log('info', `   ├─ Container: ${containers.minio}`);
 | 
			
		||||
        logger.log('info', `   ├─ API Port: ${config.S3_PORT}`);
 | 
			
		||||
        logger.log('info', `   └─ Console Port: ${config.S3_CONSOLE_PORT}`);
 | 
			
		||||
        break;
 | 
			
		||||
      case 'not_exists':
 | 
			
		||||
        logger.log('info', '📦 S3/MinIO: ⚪ Not installed');
 | 
			
		||||
        // Check port availability
 | 
			
		||||
        const s3Port = parseInt(config.S3_PORT);
 | 
			
		||||
        const s3ConsolePort = parseInt(config.S3_CONSOLE_PORT);
 | 
			
		||||
        const s3Available = await helpers.isPortAvailable(s3Port);
 | 
			
		||||
        const consoleAvailable = await helpers.isPortAvailable(s3ConsolePort);
 | 
			
		||||
        
 | 
			
		||||
        if (!s3Available || !consoleAvailable) {
 | 
			
		||||
          if (!s3Available) {
 | 
			
		||||
            logger.log('error', `   ├─ ⚠️  API Port ${s3Port} is in use`);
 | 
			
		||||
          } else {
 | 
			
		||||
            logger.log('info', `   ├─ API Port ${s3Port} is available`);
 | 
			
		||||
          }
 | 
			
		||||
          if (!consoleAvailable) {
 | 
			
		||||
            logger.log('error', `   └─ ⚠️  Console Port ${s3ConsolePort} is in use`);
 | 
			
		||||
          } else {
 | 
			
		||||
            logger.log('info', `   └─ Console Port ${s3ConsolePort} is available`);
 | 
			
		||||
          }
 | 
			
		||||
        } else {
 | 
			
		||||
          logger.log('info', `   ├─ API Port ${s3Port} is available`);
 | 
			
		||||
          logger.log('info', `   └─ Console Port ${s3ConsolePort} is available`);
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Show configuration
 | 
			
		||||
   */
 | 
			
		||||
  public async showConfig(): Promise<void> {
 | 
			
		||||
    helpers.printHeader('Current Configuration');
 | 
			
		||||
    
 | 
			
		||||
    const config = this.config.getConfig();
 | 
			
		||||
    
 | 
			
		||||
    logger.log('info', `Project: ${config.PROJECT_NAME}`);
 | 
			
		||||
    console.log();
 | 
			
		||||
    
 | 
			
		||||
    logger.log('note', 'MongoDB:');
 | 
			
		||||
    logger.log('info', `  Host: ${config.MONGODB_HOST}:${config.MONGODB_PORT}`);
 | 
			
		||||
    logger.log('info', `  Database: ${config.MONGODB_NAME}`);
 | 
			
		||||
    logger.log('info', `  User: ${config.MONGODB_USER}`);
 | 
			
		||||
    logger.log('info', '  Password: ***');
 | 
			
		||||
    logger.log('info', `  Container: ${this.config.getContainerNames().mongo}`);
 | 
			
		||||
    logger.log('info', `  Data: ${this.config.getDataDirectories().mongo}`);
 | 
			
		||||
    logger.log('info', `  Connection: ${this.config.getMongoConnectionString()}`);
 | 
			
		||||
    
 | 
			
		||||
    console.log();
 | 
			
		||||
    logger.log('note', 'S3/MinIO:');
 | 
			
		||||
    logger.log('info', `  Host: ${config.S3_HOST}`);
 | 
			
		||||
    logger.log('info', `  API Port: ${config.S3_PORT}`);
 | 
			
		||||
    logger.log('info', `  Console Port: ${config.S3_CONSOLE_PORT}`);
 | 
			
		||||
    logger.log('info', `  Access Key: ${config.S3_ACCESSKEY}`);
 | 
			
		||||
    logger.log('info', '  Secret Key: ***');
 | 
			
		||||
    logger.log('info', `  Bucket: ${config.S3_BUCKET}`);
 | 
			
		||||
    logger.log('info', `  Use SSL: ${config.S3_USESSL}`);
 | 
			
		||||
    logger.log('info', `  Container: ${this.config.getContainerNames().minio}`);
 | 
			
		||||
    logger.log('info', `  Data: ${this.config.getDataDirectories().minio}`);
 | 
			
		||||
    logger.log('info', `  Endpoint: ${config.S3_ENDPOINT}`);
 | 
			
		||||
    logger.log('info', `  Console URL: http://${config.S3_HOST}:${config.S3_CONSOLE_PORT}`);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Show MongoDB Compass connection string
 | 
			
		||||
   */
 | 
			
		||||
  public async showCompassConnection(): Promise<void> {
 | 
			
		||||
    helpers.printHeader('MongoDB Compass Connection');
 | 
			
		||||
    
 | 
			
		||||
    const config = this.config.getConfig();
 | 
			
		||||
    const networkIp = await helpers.getLocalNetworkIp();
 | 
			
		||||
    
 | 
			
		||||
    const connectionString = `mongodb://${config.MONGODB_USER}:${config.MONGODB_PASS}@${networkIp}:${config.MONGODB_PORT}/${config.MONGODB_NAME}?authSource=admin`;
 | 
			
		||||
    
 | 
			
		||||
    logger.log('info', 'MongoDB Compass is a GUI tool for MongoDB. To connect:');
 | 
			
		||||
    console.log();
 | 
			
		||||
    logger.log('info', '1. Download MongoDB Compass from:');
 | 
			
		||||
    logger.log('info', '   https://www.mongodb.com/products/compass');
 | 
			
		||||
    console.log();
 | 
			
		||||
    logger.log('info', '2. Open Compass and paste this connection string:');
 | 
			
		||||
    logger.log('ok', `   ${connectionString}`);
 | 
			
		||||
    console.log();
 | 
			
		||||
    logger.log('note', 'Connection Details:');
 | 
			
		||||
    logger.log('info', `  Network IP: ${networkIp}`);
 | 
			
		||||
    logger.log('info', `  Port: ${config.MONGODB_PORT}`);
 | 
			
		||||
    logger.log('info', `  Database: ${config.MONGODB_NAME}`);
 | 
			
		||||
    logger.log('info', `  Username: ${config.MONGODB_USER}`);
 | 
			
		||||
    logger.log('info', `  Auth Source: admin`);
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Show logs for a service
 | 
			
		||||
   */
 | 
			
		||||
  public async showLogs(service: string, lines: number = 20): Promise<void> {
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    
 | 
			
		||||
    switch (service) {
 | 
			
		||||
      case 'mongo':
 | 
			
		||||
      case 'mongodb':
 | 
			
		||||
        if (await this.docker.isRunning(containers.mongo)) {
 | 
			
		||||
          helpers.printHeader(`MongoDB Logs (last ${lines} lines)`);
 | 
			
		||||
          const logs = await this.docker.logs(containers.mongo, lines);
 | 
			
		||||
          console.log(logs);
 | 
			
		||||
        } else {
 | 
			
		||||
          logger.log('note', 'MongoDB container is not running');
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      case 'minio':
 | 
			
		||||
      case 's3':
 | 
			
		||||
        if (await this.docker.isRunning(containers.minio)) {
 | 
			
		||||
          helpers.printHeader(`S3/MinIO Logs (last ${lines} lines)`);
 | 
			
		||||
          const logs = await this.docker.logs(containers.minio, lines);
 | 
			
		||||
          console.log(logs);
 | 
			
		||||
        } else {
 | 
			
		||||
          logger.log('note', 'S3/MinIO container is not running');
 | 
			
		||||
        }
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      case 'all':
 | 
			
		||||
      case '':
 | 
			
		||||
        await this.showLogs('mongo', lines);
 | 
			
		||||
        console.log();
 | 
			
		||||
        await this.showLogs('minio', lines);
 | 
			
		||||
        break;
 | 
			
		||||
        
 | 
			
		||||
      default:
 | 
			
		||||
        logger.log('note', 'Usage: gitzone services logs [mongo|s3|all] [lines]');
 | 
			
		||||
        break;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Remove containers
 | 
			
		||||
   */
 | 
			
		||||
  public async removeContainers(): Promise<void> {
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    let removed = false;
 | 
			
		||||
    
 | 
			
		||||
    if (await this.docker.exists(containers.mongo)) {
 | 
			
		||||
      if (await this.docker.remove(containers.mongo, true)) {
 | 
			
		||||
        logger.log('ok', '  MongoDB container removed ✓');
 | 
			
		||||
        removed = true;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (await this.docker.exists(containers.minio)) {
 | 
			
		||||
      if (await this.docker.remove(containers.minio, true)) {
 | 
			
		||||
        logger.log('ok', '  S3/MinIO container removed ✓');
 | 
			
		||||
        removed = true;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!removed) {
 | 
			
		||||
      logger.log('note', '  No containers to remove');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Clean data directories
 | 
			
		||||
   */
 | 
			
		||||
  public async cleanData(): Promise<void> {
 | 
			
		||||
    const directories = this.config.getDataDirectories();
 | 
			
		||||
    let cleaned = false;
 | 
			
		||||
    
 | 
			
		||||
    if (await plugins.smartfile.fs.fileExists(directories.mongo)) {
 | 
			
		||||
      await plugins.smartfile.fs.remove(directories.mongo);
 | 
			
		||||
      logger.log('ok', '  MongoDB data removed ✓');
 | 
			
		||||
      cleaned = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (await plugins.smartfile.fs.fileExists(directories.minio)) {
 | 
			
		||||
      await plugins.smartfile.fs.remove(directories.minio);
 | 
			
		||||
      logger.log('ok', '  S3/MinIO data removed ✓');
 | 
			
		||||
      cleaned = true;
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (!cleaned) {
 | 
			
		||||
      logger.log('note', '  No data to clean');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  /**
 | 
			
		||||
   * Reconfigure services with new ports
 | 
			
		||||
   */
 | 
			
		||||
  public async reconfigure(): Promise<void> {
 | 
			
		||||
    helpers.printHeader('Reconfiguring Services');
 | 
			
		||||
    
 | 
			
		||||
    const containers = this.config.getContainerNames();
 | 
			
		||||
    
 | 
			
		||||
    // Stop existing containers
 | 
			
		||||
    logger.log('note', '🛑 Stopping existing containers...');
 | 
			
		||||
    
 | 
			
		||||
    if (await this.docker.exists(containers.mongo)) {
 | 
			
		||||
      await this.docker.stop(containers.mongo);
 | 
			
		||||
      logger.log('ok', '  MongoDB stopped ✓');
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    if (await this.docker.exists(containers.minio)) {
 | 
			
		||||
      await this.docker.stop(containers.minio);
 | 
			
		||||
      logger.log('ok', '  S3/MinIO stopped ✓');
 | 
			
		||||
    }
 | 
			
		||||
    
 | 
			
		||||
    // Reconfigure ports
 | 
			
		||||
    await this.config.reconfigurePorts();
 | 
			
		||||
    
 | 
			
		||||
    // Ask if user wants to restart services
 | 
			
		||||
    const smartinteract = new plugins.smartinteract.SmartInteract();
 | 
			
		||||
    const response = await smartinteract.askQuestion({
 | 
			
		||||
      name: 'restart',
 | 
			
		||||
      type: 'confirm',
 | 
			
		||||
      message: 'Do you want to start services with new ports?',
 | 
			
		||||
      default: true
 | 
			
		||||
    });
 | 
			
		||||
    
 | 
			
		||||
    if (response.value) {
 | 
			
		||||
      console.log();
 | 
			
		||||
      await this.startMongoDB();
 | 
			
		||||
      await this.startMinIO();
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										123
									
								
								ts/mod_services/helpers.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										123
									
								
								ts/mod_services/helpers.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,123 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as net from 'net';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Check if a port is available
 | 
			
		||||
 */
 | 
			
		||||
export const isPortAvailable = async (port: number): Promise<boolean> => {
 | 
			
		||||
  return new Promise((resolve) => {
 | 
			
		||||
    const server = net.createServer();
 | 
			
		||||
    
 | 
			
		||||
    server.once('error', () => {
 | 
			
		||||
      resolve(false);
 | 
			
		||||
    });
 | 
			
		||||
    
 | 
			
		||||
    server.once('listening', () => {
 | 
			
		||||
      server.close();
 | 
			
		||||
      resolve(true);
 | 
			
		||||
    });
 | 
			
		||||
    
 | 
			
		||||
    server.listen(port, '0.0.0.0');
 | 
			
		||||
  });
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get a random available port between 20000 and 30000
 | 
			
		||||
 */
 | 
			
		||||
export const getRandomAvailablePort = async (): Promise<number> => {
 | 
			
		||||
  const maxAttempts = 100;
 | 
			
		||||
  
 | 
			
		||||
  for (let i = 0; i < maxAttempts; i++) {
 | 
			
		||||
    const port = Math.floor(Math.random() * 10001) + 20000;
 | 
			
		||||
    if (await isPortAvailable(port)) {
 | 
			
		||||
      return port;
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  // Fallback: let the system assign a port
 | 
			
		||||
  return 0;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the project name from package.json or directory
 | 
			
		||||
 */
 | 
			
		||||
export const getProjectName = (): string => {
 | 
			
		||||
  try {
 | 
			
		||||
    const packageJsonPath = plugins.path.join(process.cwd(), 'package.json');
 | 
			
		||||
    if (plugins.smartfile.fs.fileExistsSync(packageJsonPath)) {
 | 
			
		||||
      const packageJson = plugins.smartfile.fs.toObjectSync(packageJsonPath);
 | 
			
		||||
      if (packageJson.name) {
 | 
			
		||||
        // Sanitize: @fin.cx/skr → fin-cx-skr
 | 
			
		||||
        return packageJson.name.replace(/@/g, '').replace(/[\/\.]/g, '-');
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  } catch (error) {
 | 
			
		||||
    // Ignore errors and fall back to directory name
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  return plugins.path.basename(process.cwd());
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Print a header with decorative lines
 | 
			
		||||
 */
 | 
			
		||||
export const printHeader = (title: string) => {
 | 
			
		||||
  console.log();
 | 
			
		||||
  logger.log('info', '═══════════════════════════════════════════════════════════════');
 | 
			
		||||
  logger.log('info', `  ${title}`);
 | 
			
		||||
  logger.log('info', '═══════════════════════════════════════════════════════════════');
 | 
			
		||||
  console.log();
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Format bytes to human readable string
 | 
			
		||||
 */
 | 
			
		||||
export const formatBytes = (bytes: number): string => {
 | 
			
		||||
  const units = ['B', 'KB', 'MB', 'GB', 'TB'];
 | 
			
		||||
  let size = bytes;
 | 
			
		||||
  let unitIndex = 0;
 | 
			
		||||
  
 | 
			
		||||
  while (size >= 1024 && unitIndex < units.length - 1) {
 | 
			
		||||
    size /= 1024;
 | 
			
		||||
    unitIndex++;
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  return `${size.toFixed(2)} ${units[unitIndex]}`;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the local network IP address
 | 
			
		||||
 */
 | 
			
		||||
export const getLocalNetworkIp = async (): Promise<string> => {
 | 
			
		||||
  const smartnetworkInstance = new plugins.smartnetwork.SmartNetwork();
 | 
			
		||||
  const gateways = await smartnetworkInstance.getGateways();
 | 
			
		||||
  
 | 
			
		||||
  // Find the best local IP from network interfaces
 | 
			
		||||
  for (const interfaceName of Object.keys(gateways)) {
 | 
			
		||||
    const interfaces = gateways[interfaceName];
 | 
			
		||||
    for (const iface of interfaces) {
 | 
			
		||||
      // Skip loopback and internal interfaces
 | 
			
		||||
      if (!iface.internal && iface.family === 'IPv4') {
 | 
			
		||||
        const address = iface.address;
 | 
			
		||||
        // Prefer LAN IPs
 | 
			
		||||
        if (address.startsWith('192.168.') || address.startsWith('10.') || address.startsWith('172.')) {
 | 
			
		||||
          return address;
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  // Fallback: try to get any non-internal IPv4
 | 
			
		||||
  for (const interfaceName of Object.keys(gateways)) {
 | 
			
		||||
    const interfaces = gateways[interfaceName];
 | 
			
		||||
    for (const iface of interfaces) {
 | 
			
		||||
      if (!iface.internal && iface.family === 'IPv4') {
 | 
			
		||||
        return iface.address;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  
 | 
			
		||||
  // Last resort: localhost
 | 
			
		||||
  return 'localhost';
 | 
			
		||||
};
 | 
			
		||||
							
								
								
									
										224
									
								
								ts/mod_services/index.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										224
									
								
								ts/mod_services/index.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,224 @@
 | 
			
		||||
import * as plugins from './mod.plugins.js';
 | 
			
		||||
import * as helpers from './helpers.js';
 | 
			
		||||
import { ServiceManager } from './classes.servicemanager.js';
 | 
			
		||||
import { logger } from '../gitzone.logging.js';
 | 
			
		||||
 | 
			
		||||
export const run = async (argvArg: any) => {
 | 
			
		||||
  const serviceManager = new ServiceManager();
 | 
			
		||||
  await serviceManager.init();
 | 
			
		||||
  
 | 
			
		||||
  const command = argvArg._[1] || 'help';
 | 
			
		||||
  const service = argvArg._[2] || 'all';
 | 
			
		||||
  
 | 
			
		||||
  switch (command) {
 | 
			
		||||
    case 'start':
 | 
			
		||||
      await handleStart(serviceManager, service);
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'stop':
 | 
			
		||||
      await handleStop(serviceManager, service);
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'restart':
 | 
			
		||||
      await handleRestart(serviceManager, service);
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'status':
 | 
			
		||||
      await serviceManager.showStatus();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'config':
 | 
			
		||||
      await serviceManager.showConfig();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'compass':
 | 
			
		||||
      await serviceManager.showCompassConnection();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'logs':
 | 
			
		||||
      const lines = parseInt(argvArg._[3]) || 20;
 | 
			
		||||
      await serviceManager.showLogs(service, lines);
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'remove':
 | 
			
		||||
      await handleRemove(serviceManager);
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'clean':
 | 
			
		||||
      await handleClean(serviceManager);
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'reconfigure':
 | 
			
		||||
      await serviceManager.reconfigure();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'help':
 | 
			
		||||
    default:
 | 
			
		||||
      showHelp();
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
async function handleStart(serviceManager: ServiceManager, service: string) {
 | 
			
		||||
  helpers.printHeader('Starting Services');
 | 
			
		||||
  
 | 
			
		||||
  switch (service) {
 | 
			
		||||
    case 'mongo':
 | 
			
		||||
    case 'mongodb':
 | 
			
		||||
      await serviceManager.startMongoDB();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'minio':
 | 
			
		||||
    case 's3':
 | 
			
		||||
      await serviceManager.startMinIO();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'all':
 | 
			
		||||
    case '':
 | 
			
		||||
      await serviceManager.startMongoDB();
 | 
			
		||||
      console.log();
 | 
			
		||||
      await serviceManager.startMinIO();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    default:
 | 
			
		||||
      logger.log('error', `Unknown service: ${service}`);
 | 
			
		||||
      logger.log('note', 'Use: mongo, s3, or all');
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
async function handleStop(serviceManager: ServiceManager, service: string) {
 | 
			
		||||
  helpers.printHeader('Stopping Services');
 | 
			
		||||
  
 | 
			
		||||
  switch (service) {
 | 
			
		||||
    case 'mongo':
 | 
			
		||||
    case 'mongodb':
 | 
			
		||||
      await serviceManager.stopMongoDB();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'minio':
 | 
			
		||||
    case 's3':
 | 
			
		||||
      await serviceManager.stopMinIO();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'all':
 | 
			
		||||
    case '':
 | 
			
		||||
      await serviceManager.stopMongoDB();
 | 
			
		||||
      console.log();
 | 
			
		||||
      await serviceManager.stopMinIO();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    default:
 | 
			
		||||
      logger.log('error', `Unknown service: ${service}`);
 | 
			
		||||
      logger.log('note', 'Use: mongo, s3, or all');
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
async function handleRestart(serviceManager: ServiceManager, service: string) {
 | 
			
		||||
  helpers.printHeader('Restarting Services');
 | 
			
		||||
  
 | 
			
		||||
  switch (service) {
 | 
			
		||||
    case 'mongo':
 | 
			
		||||
    case 'mongodb':
 | 
			
		||||
      await serviceManager.stopMongoDB();
 | 
			
		||||
      await plugins.smartdelay.delayFor(2000);
 | 
			
		||||
      await serviceManager.startMongoDB();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'minio':
 | 
			
		||||
    case 's3':
 | 
			
		||||
      await serviceManager.stopMinIO();
 | 
			
		||||
      await plugins.smartdelay.delayFor(2000);
 | 
			
		||||
      await serviceManager.startMinIO();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    case 'all':
 | 
			
		||||
    case '':
 | 
			
		||||
      await serviceManager.stopMongoDB();
 | 
			
		||||
      await serviceManager.stopMinIO();
 | 
			
		||||
      await plugins.smartdelay.delayFor(2000);
 | 
			
		||||
      await serviceManager.startMongoDB();
 | 
			
		||||
      console.log();
 | 
			
		||||
      await serviceManager.startMinIO();
 | 
			
		||||
      break;
 | 
			
		||||
      
 | 
			
		||||
    default:
 | 
			
		||||
      logger.log('error', `Unknown service: ${service}`);
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
async function handleRemove(serviceManager: ServiceManager) {
 | 
			
		||||
  helpers.printHeader('Removing Containers');
 | 
			
		||||
  logger.log('note', '⚠️  This will remove containers but preserve data');
 | 
			
		||||
  
 | 
			
		||||
  const shouldContinue = await plugins.smartinteract.SmartInteract.getCliConfirmation('Continue?', false);
 | 
			
		||||
  
 | 
			
		||||
  if (shouldContinue) {
 | 
			
		||||
    await serviceManager.removeContainers();
 | 
			
		||||
  } else {
 | 
			
		||||
    logger.log('note', 'Cancelled');
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
async function handleClean(serviceManager: ServiceManager) {
 | 
			
		||||
  helpers.printHeader('Clean All');
 | 
			
		||||
  logger.log('error', '⚠️  WARNING: This will remove all containers and data!');
 | 
			
		||||
  logger.log('error', 'This action cannot be undone!');
 | 
			
		||||
  
 | 
			
		||||
  const smartinteraction = new plugins.smartinteract.SmartInteract();
 | 
			
		||||
  const confirmAnswer = await smartinteraction.askQuestion({
 | 
			
		||||
    name: 'confirm',
 | 
			
		||||
    type: 'input',
 | 
			
		||||
    message: 'Type "yes" to confirm:',
 | 
			
		||||
    default: 'no'
 | 
			
		||||
  });
 | 
			
		||||
  
 | 
			
		||||
  if (confirmAnswer.value === 'yes') {
 | 
			
		||||
    await serviceManager.removeContainers();
 | 
			
		||||
    console.log();
 | 
			
		||||
    await serviceManager.cleanData();
 | 
			
		||||
    logger.log('ok', 'All cleaned ✓');
 | 
			
		||||
  } else {
 | 
			
		||||
    logger.log('note', 'Cancelled');
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
function showHelp() {
 | 
			
		||||
  helpers.printHeader('GitZone Services Manager');
 | 
			
		||||
  
 | 
			
		||||
  logger.log('ok', 'Usage: gitzone services [command] [options]');
 | 
			
		||||
  console.log();
 | 
			
		||||
  
 | 
			
		||||
  logger.log('note', 'Commands:');
 | 
			
		||||
  logger.log('info', '  start [service]   Start services (mongo|s3|all)');
 | 
			
		||||
  logger.log('info', '  stop [service]    Stop services (mongo|s3|all)');
 | 
			
		||||
  logger.log('info', '  restart [service] Restart services (mongo|s3|all)');
 | 
			
		||||
  logger.log('info', '  status            Show service status');
 | 
			
		||||
  logger.log('info', '  config            Show current configuration');
 | 
			
		||||
  logger.log('info', '  compass           Show MongoDB Compass connection string');
 | 
			
		||||
  logger.log('info', '  logs [service]    Show logs (mongo|s3|all) [lines]');
 | 
			
		||||
  logger.log('info', '  reconfigure       Reassign ports and restart services');
 | 
			
		||||
  logger.log('info', '  remove            Remove all containers');
 | 
			
		||||
  logger.log('info', '  clean             Remove all containers and data ⚠️');
 | 
			
		||||
  logger.log('info', '  help              Show this help message');
 | 
			
		||||
  console.log();
 | 
			
		||||
  
 | 
			
		||||
  logger.log('note', 'Features:');
 | 
			
		||||
  logger.log('info', '  • Auto-creates .nogit/env.json with smart defaults');
 | 
			
		||||
  logger.log('info', '  • Random ports (20000-30000) to avoid conflicts');
 | 
			
		||||
  logger.log('info', '  • Project-specific containers for multi-project support');
 | 
			
		||||
  logger.log('info', '  • Preserves custom configuration values');
 | 
			
		||||
  logger.log('info', '  • MongoDB Compass connection support');
 | 
			
		||||
  console.log();
 | 
			
		||||
  
 | 
			
		||||
  logger.log('note', 'Examples:');
 | 
			
		||||
  logger.log('info', '  gitzone services start          # Start all services');
 | 
			
		||||
  logger.log('info', '  gitzone services start mongo    # Start only MongoDB');
 | 
			
		||||
  logger.log('info', '  gitzone services stop           # Stop all services');
 | 
			
		||||
  logger.log('info', '  gitzone services status         # Check service status');
 | 
			
		||||
  logger.log('info', '  gitzone services config         # Show configuration');
 | 
			
		||||
  logger.log('info', '  gitzone services compass        # Get MongoDB Compass connection');
 | 
			
		||||
  logger.log('info', '  gitzone services logs mongo 50  # Show last 50 lines of MongoDB logs');
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										9
									
								
								ts/mod_services/mod.plugins.ts
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										9
									
								
								ts/mod_services/mod.plugins.ts
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,9 @@
 | 
			
		||||
export * from '../plugins.js';
 | 
			
		||||
 | 
			
		||||
import * as smartshell from '@push.rocks/smartshell';
 | 
			
		||||
import * as smartfile from '@push.rocks/smartfile';
 | 
			
		||||
import * as smartinteract from '@push.rocks/smartinteract';
 | 
			
		||||
import * as smartnetwork from '@push.rocks/smartnetwork';
 | 
			
		||||
import * as smartdelay from '@push.rocks/smartdelay';
 | 
			
		||||
 | 
			
		||||
export { smartshell, smartfile, smartinteract, smartnetwork, smartdelay };
 | 
			
		||||
@@ -7,6 +7,11 @@ import * as smartcli from '@push.rocks/smartcli';
 | 
			
		||||
import * as smartpath from '@push.rocks/smartpath';
 | 
			
		||||
import * as smartpromise from '@push.rocks/smartpromise';
 | 
			
		||||
import * as smartupdate from '@push.rocks/smartupdate';
 | 
			
		||||
import * as smartshell from '@push.rocks/smartshell';
 | 
			
		||||
import * as smartnetwork from '@push.rocks/smartnetwork';
 | 
			
		||||
import * as smartfile from '@push.rocks/smartfile';
 | 
			
		||||
import * as smartinteract from '@push.rocks/smartinteract';
 | 
			
		||||
import * as smartdelay from '@push.rocks/smartdelay';
 | 
			
		||||
 | 
			
		||||
export {
 | 
			
		||||
  smartlog,
 | 
			
		||||
@@ -18,4 +23,9 @@ export {
 | 
			
		||||
  smartpath,
 | 
			
		||||
  smartpromise,
 | 
			
		||||
  smartupdate,
 | 
			
		||||
  smartshell,
 | 
			
		||||
  smartnetwork,
 | 
			
		||||
  smartfile,
 | 
			
		||||
  smartinteract,
 | 
			
		||||
  smartdelay,
 | 
			
		||||
};
 | 
			
		||||
 
 | 
			
		||||
@@ -10,7 +10,5 @@
 | 
			
		||||
    "baseUrl": ".",
 | 
			
		||||
    "paths": {}
 | 
			
		||||
  },
 | 
			
		||||
  "exclude": [
 | 
			
		||||
    "dist_*/**/*.d.ts"
 | 
			
		||||
  ]
 | 
			
		||||
  "exclude": ["dist_*/**/*.d.ts"]
 | 
			
		||||
}
 | 
			
		||||
		Reference in New Issue
	
	Block a user