chore: prepare for v0.3.0 release

Kinin-Code-Offical · Kinin-Code-Offical · commit 5ee4eab57103 · 2025-12-21T04:45:17.000+03:00
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -18,10 +18,10 @@ jobs:
         node-version: [22.x]
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           cache: 'npm'
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -12,10 +12,10 @@ jobs:
       contents: write
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
       - name: Use Node.js 22.x
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@v4
         with:
           node-version: 22.x
           cache: 'npm'
@@ -35,24 +35,28 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Package
+      - name: Package (SEA)
         run: npm run package
 
-      - name: Generate Checksums
-        run: |
-          Get-FileHash dist\*, installer\Output\* -Algorithm SHA256 | Select-Object Hash, Path | ForEach-Object { "$($_.Hash)  $(Split-Path $_.Path -Leaf)" } | Out-File SHA256SUMS.txt
-
       - name: Install Inno Setup
-        run: choco install innosetup
+        run: choco install innosetup -y --no-progress
 
       - name: Build Installer
         run: npm run installer
 
+      - name: Stage Artifacts
+        run: npm run stage
+
+      - name: Verify Artifacts
+        run: |
+          if (-not (Test-Path artifacts/cloudsqlctl.exe)) { throw "Missing cloudsqlctl.exe" }
+          if (-not (Test-Path artifacts/cloudsqlctl-setup.exe)) { throw "Missing cloudsqlctl-setup.exe" }
+          if (-not (Test-Path artifacts/cloudsqlctl-windows-x64.zip)) { throw "Missing zip bundle" }
+          if (-not (Test-Path artifacts/SHA256SUMS.txt)) { throw "Missing SHA256SUMS.txt" }
+
       - name: Release
         uses: softprops/action-gh-release@v2
         if: startsWith(github.ref, 'refs/tags/')
         with:
-          files: |
-            bin/cloudsqlctl.exe
-            dist/cloudsqlctl-setup.exe
+          files: artifacts/*
           generate_release_notes: true
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,24 @@
+# Changelog
+
+## [0.3.0] - 2025-12-21
+
+### Added
+
+- **Setup Wizard**: New `setup` command for interactive initialization.
+- **Auth Management**: New `auth` command for handling gcloud login, ADC, and Service Accounts.
+- **Paths Command**: New `paths` command to display system paths and configuration sources.
+- **Artifact Staging**: Standardized build artifacts (`artifacts/`) with SHA256 checksums.
+- **Versioning**: Single source of truth for versioning via `package.json`.
+
+### Changed
+
+- **Installer**: Updated Inno Setup script to support dynamic versioning and smarter binary reuse.
+- **CI/CD**: Upgraded GitHub Actions to v4, fixed release workflow, and added artifact verification.
+- **Service Management**: Improved Windows Service handling with argument support and ACL hardening.
+- **Documentation**: Updated README with correct paths and new commands.
+
+### Fixed
+
+- **Build**: Resolved duplicate exports in service module.
+- **Types**: Fixed TypeScript errors in self-heal and service commands.
+- **Linting**: Corrected Markdown formatting issues.
diff --git a/CHANGELOG_DRAFT.md b/CHANGELOG_DRAFT.md
@@ -1,3 +1,5 @@
+<!-- markdownlint-disable MD024 -->
+
 # Changelog
 
 ## [0.3.0] - 2025-12-21
diff --git a/README.md b/README.md
@@ -98,7 +98,24 @@ cloudsqlctl status
 ## Configuration
 
 Configuration and logs are stored in:
-`%LOCALAPPDATA%\CloudSQLCTL`
+
+- **User Scope (Default):** `%LOCALAPPDATA%\CloudSQLCTL`
+- **Machine Scope (Service):** `%ProgramData%\CloudSQLCTL`
+
+You can view the exact paths used by your current environment:
+
+```powershell
+cloudsqlctl paths
+```
+
+## Release
+
+This project uses GitHub Actions for automated releases.
+
+1. Tag a new version: `git tag v0.3.0`
+2. Push the tag: `git push origin v0.3.0`
+3. The workflow will build, test, sign (if configured), and publish artifacts to the [Releases](https://github.com/Kinin-Code-Offical/cloudsqlctl/releases) page.
+   `%LOCALAPPDATA%\CloudSQLCTL`
 
 - `config.json`: User preferences and selected instance.
 - `logs/`: Application and proxy logs.
diff --git a/installer/cloudsqlctl.iss b/installer/cloudsqlctl.iss
@@ -1,5 +1,7 @@
 #define MyAppName "CloudSQLCTL"
-#define MyAppVersion "0.2.0"
+#ifndef MyAppVersion
+#define MyAppVersion "0.0.0"
+#endif
 #define MyAppPublisher "Kinin Code"
 #define MyAppURL "https://github.com/Kinin-Code-Offical/cloudsqlctl"
 #define MyAppExeName "cloudsqlctl.exe"
diff --git a/package.json b/package.json
@@ -14,7 +14,7 @@
     "build": "tsup src/cli.ts --format cjs --minify --out-dir dist --no-splitting",
     "package": "npm run build && powershell -ExecutionPolicy Bypass -File tools/build-sea.ps1",
     "installer": "powershell -ExecutionPolicy Bypass -File tools/build-installer.ps1",
-    "zip": "powershell -Command \"Get-ChildItem -Path . -Force | Where-Object { $_.Name -notin 'node_modules', 'dist', 'bin', 'coverage', '.git', '.vs', '.DS_Store' -and $_.Extension -notin '.zip', '.exe', '.log' } | Compress-Archive -DestinationPath cloudsqlctl.zip -Force\"",
+    "stage": "powershell -ExecutionPolicy Bypass -File tools/stage-artifacts.ps1",
     "lint": "eslint src",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --passWithNoTests",
     "prepare": "husky install"
diff --git a/src/cli.ts b/src/cli.ts
@@ -19,6 +19,7 @@ import { checkCommand } from './commands/check.js';
 import { gcloudCommand } from './commands/gcloud.js';
 import { authCommand } from './commands/auth.js';
 import { setupCommand } from './commands/setup.js';
+import { pathsCommand } from './commands/paths.js';
 import { logger } from './core/logger.js';
 import { createRequire } from 'module';
 
@@ -51,6 +52,7 @@ program.addCommand(checkCommand);
 program.addCommand(gcloudCommand);
 program.addCommand(authCommand);
 program.addCommand(setupCommand);
+program.addCommand(pathsCommand);
 
 program.parseAsync(process.argv).catch(err => {
     logger.error('Unhandled error', err);
diff --git a/src/commands/paths.ts b/src/commands/paths.ts
@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import { PATHS, ENV_VARS } from '../system/paths.js';
+import chalk from 'chalk';
+
+export const pathsCommand = new Command('paths')
+    .description('Show resolved system paths and configuration locations')
+    .action(async () => {
+        console.log(chalk.bold('\nCloudSQLCTL Paths Configuration\n'));
+
+        const rows = [
+            { key: 'Home Dir', value: PATHS.HOME },
+            { key: 'Bin Dir', value: PATHS.BIN },
+            { key: 'Logs Dir', value: PATHS.LOGS },
+            { key: 'Config File', value: PATHS.CONFIG_FILE },
+            { key: 'Proxy Exe', value: PATHS.PROXY_EXE },
+            { key: 'Secrets Dir', value: PATHS.SECRETS },
+        ];
+
+        rows.forEach(row => {
+            console.log(`${chalk.cyan(row.key.padEnd(15))}: ${row.value}`);
+        });
+
+        console.log(chalk.bold('\nResolution Source:'));
+
+        if (process.env[ENV_VARS.PROXY_PATH]) {
+            console.log(`- ${chalk.green('Environment Variable')} (${ENV_VARS.PROXY_PATH}) is set.`);
+        } else if (PATHS.HOME.includes('ProgramData')) {
+            console.log(`- ${chalk.yellow('System Installation')} (ProgramData detected).`);
+        } else {
+            console.log(`- ${chalk.blue('User Installation')} (AppData detected).`);
+        }
+
+        console.log('');
+    });
diff --git a/src/system/paths.ts b/src/system/paths.ts
@@ -50,6 +50,7 @@ function resolvePaths() {
             TEMP: path.join(home, 'temp'),
             GCLOUD_DIR: path.join(home, 'gcloud'),
             PID_FILE: path.join(home, 'proxy.pid'),
+            SECRETS: path.join(home, 'secrets'),
         };
     }
 
diff --git a/tools/build-installer.ps1 b/tools/build-installer.ps1
@@ -1,3 +1,11 @@
+$ErrorActionPreference = "Stop"
+
+# Read version from package.json
+$PackageJson = Get-Content -Path (Join-Path $PSScriptRoot "..\package.json") -Raw | ConvertFrom-Json
+$Version = $PackageJson.version
+
+Write-Host "Building Installer for Version: $Version"
+
 $ISCC = Get-Command "iscc" -ErrorAction SilentlyContinue
 
 if (-not $ISCC) {
@@ -16,7 +24,8 @@ $ScriptPath = [System.IO.Path]::GetFullPath($ScriptPath)
 
 Write-Host "Building installer from $ScriptPath..."
 
-& $ISCC $ScriptPath
+# Pass the version to ISCC
+& $ISCC "/DMyAppVersion=$Version" $ScriptPath
 
 if ($LASTEXITCODE -eq 0) {
     Write-Host "Installer built successfully."
diff --git a/tools/stage-artifacts.ps1 b/tools/stage-artifacts.ps1
@@ -0,0 +1,47 @@
+$ErrorActionPreference = "Stop"
+
+$Root = $PSScriptRoot | Split-Path -Parent
+$ArtifactsDir = Join-Path $Root "artifacts"
+$BinDir = Join-Path $Root "bin"
+$DistDir = Join-Path $Root "dist"
+
+Write-Host "Staging artifacts..."
+
+# 1. Clean and Create Artifacts Directory
+if (Test-Path $ArtifactsDir) {
+    Remove-Item $ArtifactsDir -Recurse -Force
+}
+New-Item -ItemType Directory -Path $ArtifactsDir | Out-Null
+
+# 2. Copy Executables
+$ExeSource = Join-Path $BinDir "cloudsqlctl.exe"
+$SetupSource = Join-Path $DistDir "cloudsqlctl-setup.exe"
+
+if (-not (Test-Path $ExeSource)) { Write-Error "Missing binary: $ExeSource"; exit 1 }
+if (-not (Test-Path $SetupSource)) { Write-Error "Missing installer: $SetupSource"; exit 1 }
+
+Copy-Item $ExeSource -Destination $ArtifactsDir
+Copy-Item $SetupSource -Destination $ArtifactsDir
+
+# 3. Generate SHA256 Checksums
+$ChecksumFile = Join-Path $ArtifactsDir "SHA256SUMS.txt"
+Get-ChildItem $ArtifactsDir -Filter "*.exe" | Get-FileHash -Algorithm SHA256 | ForEach-Object {
+    "$($_.Hash)  $($_.Path | Split-Path -Leaf)"
+} | Out-File -Encoding ASCII $ChecksumFile
+
+# 4. Create Distribution Zip
+$ZipPath = Join-Path $ArtifactsDir "cloudsqlctl-windows-x64.zip"
+$FilesToZip = @(
+    (Join-Path $ArtifactsDir "cloudsqlctl.exe"),
+    (Join-Path $ArtifactsDir "cloudsqlctl-setup.exe"),
+    (Join-Path $Root "README.md"),
+    (Join-Path $Root "LICENSE")
+)
+
+# Filter existing files only
+$FilesToZip = $FilesToZip | Where-Object { Test-Path $_ }
+
+Compress-Archive -Path $FilesToZip -DestinationPath $ZipPath -Force
+
+Write-Host "Artifacts staged successfully in $ArtifactsDir"
+Get-ChildItem $ArtifactsDir | Select-Object Name, Length

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<!-- markdownlint-disable MD024 -->`
	`2`	`+`
`1`	`3`	`# Changelog`
`2`	`4`
`3`	`5`	`## [0.3.0] - 2025-12-21`
Original file line number	Diff line number	Diff line change
`@@ -50,6 +50,7 @@ function resolvePaths() {`
`50`	`50`	`TEMP: path.join(home, 'temp'),`
`51`	`51`	`GCLOUD_DIR: path.join(home, 'gcloud'),`
`52`	`52`	`PID_FILE: path.join(home, 'proxy.pid'),`
	`53`	`+ SECRETS: path.join(home, 'secrets'),`
`53`	`54`	`};`
`54`	`55`	`}`
`55`	`56`