nitor 1.1.0 → 1.2.1

package/CHANGELOG.md

@@ -23,4 +23,10 @@ For a complete list of changes and discussion, see [Issue #1](https://github.com
 
 - Added cleanup command to delete all local branches except master/main.
 
-- [Issue #6](https://github.com/codebynithin/nitor/issues/6)
+## [1.2.1] - 2025-11-19
+
+### New Features
+
+- Added time entry commands.
+
+- [Issue #5](https://github.com/codebynithin/nitor/issues/5)

package/README.md

@@ -24,6 +24,8 @@ A CLI utility toolkit for automating and managing build, deploy, and status oper
 - Backup and restore MongoDB
 - Merge git branches
 - Cleanup local git branches
+- Time entry management with Zoho integration
+- GitLab activity tracking
 
 ## Requirements
 
@@ -40,6 +42,34 @@ A CLI utility toolkit for automating and managing build, deploy, and status oper
   - `AI_MODEL` - AI model
   - `BACKUP_CONFIG` - Backup configuration
   - `RESTORE_CONFIG` - Restore configuration
+  - `ZOHO_COOKIE` - Zoho cookie for authentication
+  - `ZOHO_CUSTOMVIEW_ID` - Zoho custom view ID
+  - `ZOHO_DEFAULt_PROJECT_ID` - Default Zoho project ID
+  - `ZOHO_PORTAL_ID` - Zoho portal ID
+  - `ZOHO_PROJECTS` - Zoho projects configuration
+  - `ZOHO_SESSION_ID` - Zoho session ID
+  - `ZOHO_SOURCE` - Zoho source
+  - `ZOHO_TEAM` - Zoho team ID
+  - `ZOHO_TOKEN` - Zoho CSRF token
+  - `ZOHO_URI` - Zoho API URL
+  - `ZOHO_USERID` - Zoho user ID
+  - `GITLAB_API_URL` - GitLab API URL
+  - `GITLAB_PROJECT_ID` - GitLab project ID
+
+## Installation
+
+After installing the package globally, you can enable autocomplete:
+
+```bash
+nitor completion
+```
+
+This will add autocomplete support to your shell. Restart your terminal or run:
+
+```bash
+source ~/.bashrc  # for bash
+source ~/.zshrc   # for zsh
+```
 
 ## Usage
 
@@ -49,6 +79,14 @@ You can use the CLI via the `nitor` command:
 nitor <command> [options]
 ```
 
+### Autocomplete
+
+Once enabled, you can use Tab to autocomplete:
+
+- Commands (build, deploy, cleanup, etc.)
+- Options (-project, -components, etc.)
+- Values (portal, gateway, dev, qa, etc.)
+
 ### Example Commands
 
 - **Build:**
@@ -91,6 +129,34 @@ nitor <command> [options]
   ```bash
   nitor cleanup
   ```
+- **Time Entry - Initialize:**
+  ```bash
+  nitor time-init
+  ```
+- **Time Entry - Add:**
+  ```bash
+  nitor time-add -project <project name> -sprint <sprint name> -task <task id> -date <YYYY-MM-DD> -work <work description> -duration <minutes> -remarks <remarks>
+  ```
+- **Time Entry - Update:**
+  ```bash
+  nitor time-update -id <entry id> -task <task id> -work <work description> -duration <minutes> -remarks <remarks> -date <YYYY-MM-DD>
+  ```
+- **Time Entry - Delete:**
+  ```bash
+  nitor time-delete -id <entry id> -date <YYYY-MM-DD>
+  ```
+- **Time Entry - View Entries:**
+  ```bash
+  nitor time-entries -from <YYYY-MM-DD> -to <YYYY-MM-DD>
+  ```
+- **Time Entry - View Stats:**
+  ```bash
+  nitor time-stats -from <YYYY-MM-DD> -to <YYYY-MM-DD>
+  ```
+- **Time Entry - Sync to Zoho:**
+  ```bash
+  nitor time-zoho
+  ```
 
 ### Command Reference
 
@@ -107,6 +173,13 @@ nitor <command> [options]
 - `restore` : Restore specified projects
 - `merge` : Merge source branch into target branch
 - `cleanup` : Cleanup local git branches (checkout to master and delete all other branches)
+- `time-init` : Initialize time entry configuration
+- `time-add` : Add time entry with support for multiple tags
+- `time-update` : Update existing time entry
+- `time-delete` : Delete time entry
+- `time-entries` : View time entries by date range
+- `time-stats` : View daily statistics of time entries
+- `time-zoho` : Sync time entries to Zoho
 
 ### Options
 
@@ -122,6 +195,19 @@ nitor <command> [options]
 - `-source` or `-so` : Source branch name
 - `-target` or `-ta` : Target branch name
 
+#### Time Entry Options
+
+- `-project` or `-p` : Project name
+- `-sprint` or `-s` : Sprint name (e.g., "sprint 1")
+- `-task` or `-t` : Task ID
+- `-date` or `-dt` : Date in YYYY-MM-DD format
+- `-work` or `-w` : Work description (supports multiple tags)
+- `-duration` or `-du` : Duration in minutes
+- `-remarks` or `-r` : Additional remarks
+- `-id` or `-i` : Entry ID (for update/delete operations)
+- `-from` or `-f` : Start date for filtering
+- `-to` or `-t` : End date for filtering
+
 ## License
 
 ISC

package/docs/AUTOCOMPLETE.md

@@ -0,0 +1,136 @@
+# Autocomplete Setup Guide
+
+## Overview
+
+Nitor supports shell autocomplete for commands, options, and values using the `omelette` library.
+
+## Setup
+
+### 1. Install Autocomplete
+
+After installing nitor globally, run:
+
+```bash
+nitor completion
+```
+
+### 2. Activate Autocomplete
+
+Restart your terminal or source your shell configuration:
+
+**For Bash:**
+
+```bash
+source ~/.bashrc
+```
+
+**For Zsh:**
+
+```bash
+source ~/.zshrc
+```
+
+**For Fish:**
+
+```bash
+source ~/.config/fish/config.fish
+```
+
+## Usage
+
+Once autocomplete is enabled, press `Tab` to see suggestions:
+
+### Command Completion
+
+```bash
+nitor <Tab>
+# Shows: build, deploy, build-deploy, create-branch, review, refactor, backup, merge, cleanup,
+#        time-init, time-switch, time-add, time-update, time-delete, time-stats, time-entries,
+#        time-zoho, time-gitlab, time-merge, version, help
+```
+
+### Option Completion
+
+```bash
+nitor build -<Tab>
+# Shows: -project, -p, -components, -c, -instance, -i, -help, --h
+```
+
+### Value Completion
+
+```bash
+nitor build -project <Tab>
+# Shows: portal, gateway, phr, configService, healthRecords, centralAuth, mpi, phrAdminBackend, phrAdminClient, terminologyService
+
+nitor build -instance <Tab>
+# Shows: dev, qa, pilot
+
+nitor create-branch -type <Tab>
+# Shows: feat, fix
+```
+
+## Supported Completions
+
+### Commands
+
+- `build`, `deploy`, `build-deploy`
+- `create-branch`, `review`, `refactor`
+- `backup`, `merge`, `cleanup`
+- `time-init`, `time-switch`, `time-add`, `time-update`, `time-delete`
+- `time-stats`, `time-entries`, `time-zoho`, `time-gitlab`, `time-merge`
+- `version`, `help`, `completion`
+
+### Options
+
+- Project names: `portal`, `gateway`, `phr`, etc.
+- Components: `client`, `administration`, `provider`, `rest-api`
+- Instances: `dev`, `qa`, `pilot`
+- Branch types: `feat`, `fix`
+- Repository names: `portalClient`, `portalBackend`, etc.
+
+## Troubleshooting
+
+### Autocomplete Not Working
+
+1. **Verify installation:**
+
+   ```bash
+   nitor completion
+   ```
+
+2. **Check shell configuration:**
+
+   - Bash: `~/.bashrc`
+   - Zsh: `~/.zshrc`
+   - Fish: `~/.config/fish/config.fish`
+
+3. **Reload shell:**
+   ```bash
+   exec $SHELL
+   ```
+
+### Manual Setup
+
+If automatic setup doesn't work, add this to your shell configuration:
+
+**Bash (~/.bashrc):**
+
+```bash
+# nitor autocomplete
+if type nitor > /dev/null 2>&1; then
+  eval "$(nitor --completion)"
+fi
+```
+
+**Zsh (~/.zshrc):**
+
+```bash
+# nitor autocomplete
+if type nitor > /dev/null 2>&1; then
+  eval "$(nitor --completion)"
+fi
+```
+
+## Uninstall Autocomplete
+
+To remove autocomplete, edit your shell configuration file and remove the nitor completion lines, then reload your shell.

package/docs/BACKUP.md

@@ -0,0 +1,343 @@
+# Backup Command Guide
+
+## Overview
+
+The `backup` command creates MongoDB database backups for specified projects and components, ensuring data safety and recovery options.
+
+## Usage
+
+### Basic Syntax
+
+```bash
+nitor backup -project <project name> -components <component name>
+```
+
+### Short Form
+
+```bash
+nitor backup -p <project name> -c <component name>
+```
+
+## Options
+
+| Option         | Short   | Description    | Required |
+| -------------- | ------- | -------------- | -------- |
+| `--project`    | `-p`    | Project name   | Yes      |
+| `--components` | `-c`    | Component name | Optional |
+| `--help`       | `-help` | Show help      | -        |
+
+## Examples
+
+### Backup Config Service
+
+```bash
+nitor backup -p configService
+```
+
+### Backup Medica Central Auth
+
+```bash
+nitor backup -project medicaCentralAuth
+```
+
+### Backup Medica Portal
+
+```bash
+nitor backup -p medicaPortal
+```
+
+### Backup PHR System
+
+```bash
+nitor backup -project phr
+```
+
+## Supported Projects
+
+- **configService** - Configuration service database
+- **medicaCentralAuth** - Medica central authentication database
+- **medicaPortal** - Medica portal database
+- **phr** - Personal Health Records database
+
+## Backup Process
+
+The backup command will:
+
+1. **Connect to MongoDB**
+
+   - Establishes connection to database server
+   - Authenticates with credentials
+
+2. **Identify Databases**
+
+   - Determines which databases to backup
+   - Based on project and component parameters
+
+3. **Create Backup**
+
+   - Exports database collections
+   - Preserves data structure and relationships
+
+4. **Store Backup**
+
+   - Saves backup to designated location
+   - Includes timestamp in filename
+
+5. **Verify Backup**
+   - Confirms backup completion
+   - Reports backup status
+
+## Backup Location
+
+Backups are typically stored in:
+
+- Project-specific backup directory
+- Timestamped folders for version control
+- Compressed format for space efficiency
+
+## Backup Naming Convention
+
+Backups follow this pattern:
+
+```
+<project>_<component>_<timestamp>.backup
+```
+
+**Examples:**
+
+- `configService_20241115_171030.backup`
+- `medicaPortal_20241115_171030.backup`
+- `phr_20241115_171030.backup`
+
+## When to Backup
+
+### Regular Backups
+
+- **Daily** - For production databases
+- **Before Deployments** - Prior to major changes
+- **Before Migrations** - Before schema updates
+- **Weekly** - For development databases
+
+### Critical Moments
+
+- Before major feature releases
+- Before data migrations
+- Before system upgrades
+- After significant data changes
+
+## Best Practices
+
+### Backup Strategy
+
+1. **Schedule Regular Backups**
+
+   - Automate daily backups
+   - Use cron jobs or schedulers
+
+2. **Test Backups**
+
+   - Regularly verify backup integrity
+   - Practice restoration procedures
+
+3. **Multiple Locations**
+
+   - Store backups in multiple locations
+   - Use cloud storage for redundancy
+
+4. **Retention Policy**
+   - Keep daily backups for 7 days
+   - Keep weekly backups for 1 month
+   - Keep monthly backups for 1 year
+
+### Security
+
+1. **Encrypt Backups**
+
+   - Use encryption for sensitive data
+   - Secure backup storage locations
+
+2. **Access Control**
+
+   - Limit backup access to authorized users
+   - Use strong authentication
+
+3. **Audit Trail**
+   - Log backup operations
+   - Track who created backups
+
+## Restoration
+
+To restore from a backup:
+
+1. **Locate Backup File**
+
+   ```bash
+   ls -la /path/to/backups/
+   ```
+
+2. **Verify Backup Integrity**
+
+   - Check file size
+   - Verify timestamp
+
+3. **Restore Database**
+
+   ```bash
+   mongorestore --archive=<backup-file>
+   ```
+
+4. **Verify Restoration**
+   - Check data integrity
+   - Test application functionality
+
+## Troubleshooting
+
+### Backup Fails to Start
+
+1. **Check MongoDB Connection:**
+
+   - Verify MongoDB is running
+   - Test connection credentials
+   - Check network connectivity
+
+2. **Verify Permissions:**
+
+   - Ensure user has backup privileges
+   - Check file system permissions
+
+3. **Check Disk Space:**
+   ```bash
+   df -h
+   ```
+   - Ensure sufficient space for backup
+
+### Incomplete Backup
+
+If backup completes but seems incomplete:
+
+1. **Check Logs:**
+
+   - Review backup logs for errors
+   - Look for timeout issues
+
+2. **Verify Collections:**
+
+   - List all collections
+   - Compare with backup contents
+
+3. **Retry Backup:**
+   - Run backup again
+   - Use verbose mode for details
+
+### Connection Errors
+
+If you encounter connection errors:
+
+1. **Verify MongoDB Status:**
+
+   ```bash
+   systemctl status mongod
+   ```
+
+2. **Check Credentials:**
+
+   - Verify username and password
+   - Ensure user has proper roles
+
+3. **Test Connection:**
+   ```bash
+   mongo --host <host> --port <port>
+   ```
+
+## Configuration
+
+The backup command requires:
+
+1. **MongoDB Connection Details:**
+
+   - Host and port
+   - Database name
+   - Authentication credentials
+
+2. **Backup Storage:**
+
+   - Backup directory path
+   - Sufficient disk space
+   - Write permissions
+
+3. **Environment Variables:**
+   - MongoDB connection string
+   - Backup configuration
+
+## Automation
+
+### Cron Job Example
+
+```bash
+# Daily backup at 2 AM
+0 2 * * * nitor backup -p configService
+
+# Weekly backup on Sunday at 3 AM
+0 3 * * 0 nitor backup -p medicaPortal
+
+# Monthly backup on 1st at 4 AM
+0 4 1 * * nitor backup -p phr
+```
+
+### Backup Script
+
+```bash
+#!/bin/bash
+# Backup all projects
+
+projects=("configService" "medicaCentralAuth" "medicaPortal" "phr")
+
+for project in "${projects[@]}"; do
+    echo "Backing up $project..."
+    nitor backup -p "$project"
+done
+
+echo "All backups completed!"
+```
+
+## Monitoring
+
+### Backup Verification
+
+1. **Check Backup Size:**
+
+   ```bash
+   ls -lh /path/to/backups/
+   ```
+
+2. **Verify Timestamp:**
+
+   - Ensure backup is recent
+   - Check for stale backups
+
+3. **Test Restoration:**
+   - Periodically test restore process
+   - Verify data integrity
+
+### Alerts
+
+Set up alerts for:
+
+- Backup failures
+- Disk space issues
+- Connection problems
+- Unusual backup sizes
+
+## Getting Help
+
+To see all available options:
+
+```bash
+nitor backup -help
+```
+
+## Related Commands
+
+- `nitor build` - Build before backing up
+- `nitor deploy` - Deploy after backup verification
+- MongoDB tools for manual backup/restore