dorky 2.4.0 → 3.0.0

package/.github/workflows/publish-extension.yml

@@ -0,0 +1,46 @@
+name: "🧩 Publish VSCode Extension To Marketplace"
+
+on:
+    push:
+        branches:
+            - main
+        paths:
+            - "extension/dorky-extension/**"
+
+jobs:
+    publish:
+        name: 🧩 publish extension
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Setup Node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: "24.x"
+
+            - name: Install dependencies
+              run: npm install
+              working-directory: extension/dorky-extension
+
+            - name: Lint
+              run: npm run lint
+              working-directory: extension/dorky-extension
+
+            - name: Get extension version
+              id: pkg
+              run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+              working-directory: extension/dorky-extension
+
+            - name: Package extension
+              run: npx @vscode/vsce package
+              working-directory: extension/dorky-extension
+
+            - name: Publish to VS Code Marketplace
+              uses: HaaLeo/publish-vscode-extension@v1
+              with:
+                  pat: ${{ secrets.VSCE_PAT }}
+                  registryUrl: https://marketplace.visualstudio.com
+                  extensionFile: extension/dorky-extension/dorky-extension-${{ steps.pkg.outputs.version }}.vsix
+

package/README.md

@@ -10,7 +10,11 @@
 
 [`DevOps Records Keeper`](https://dorky.trishantpahwa.me/)
 
+![Logo](/logo.svg)
+
 [![dorky npm](https://img.shields.io/npm/v/dorky.svg?logo=npm)](https://npmjs.com/package/dorky)
+[![Code coverage](https://img.shields.io/badge/coverage-87.93%25-blue)](https://npmjs.com/package/dorky)
+[![Downloads](https://img.shields.io/npm/dt/dorky.svg?logo=npm)](https://npmjs.com/package/dorky)
 
 ![Made with love in India](https://madewithlove.now.sh/in?heart=true&template=for-the-badge) `&& ` ![javascript](https://img.shields.io/badge/JavaScript-323330?style=for-the-badge&logo=javascript&logoColor=F7DF1E)
 
@@ -125,7 +129,7 @@ dorky --push
 
 ## Usage
 
-### Initialize a Project
+### Initialize a Project (`-i`)
 
 ```bash
 # For AWS S3
@@ -141,7 +145,7 @@ This creates:
 - `.dorkyignore` file for exclusion patterns
 - Updates `.gitignore` to protect credentials
 
-### List Files
+### List Files (`-l`)
 
 ```bash
 # List local files (shows what can be added)
@@ -151,7 +155,7 @@ dorky --list
 dorky --list remote
 ```
 
-### Add Files to Stage
+### Add Files to Stage (`-a`)
 
 ```bash
 # Add single file
@@ -164,7 +168,7 @@ dorky --add .env config.yml secrets.json
 dorky --add .env.production .env.staging
 ```
 
-### Remove Files from Stage
+### Remove Files from Stage (`-r`)
 
 ```bash
 # Remove single file
@@ -174,7 +178,7 @@ dorky --rm .env
 dorky --rm .env config.yml
 ```
 
-### Push Files to Storage
+### Push Files to Storage (`-ph`)
 
 ```bash
 # Push all staged files
@@ -185,9 +189,10 @@ This command:
 
 - Uploads new files
 - Updates modified files (based on hash comparison)
+- Removes files from remote storage that were unstaged using `dorky --rm`
 - Skips unchanged files
 
-### Pull Files from Storage
+### Pull Files from Storage (`-pl`)
 
 ```bash
 # Pull all tracked files
@@ -200,6 +205,19 @@ This command:
 - Creates necessary directories
 - Overwrites local files
 
+### Destroy Project (`-d`)
+
+```bash
+# Destroy project locally and remotely
+dorky --destroy
+```
+
+This command:
+
+- Deletes all tracked files from remote storage
+- Removes local `.dorky/` directory and `.dorkyignore` file
+- **Warning**: This action is irreversible for remote files.
+
 ## Configuration
 
 ### .dorkyignore
@@ -318,6 +336,8 @@ dorky --pull
 - ✅ File hash validation to skip unchanged files
 - ✅ Mime-type detection for file uploads
 - ✅ Recursive folder creation on pull
+- ✅ Destroy project and clean up remote files
+- ✅ Auto-recovery of AWS credentials from environment variables
 
 ## How It Works
 
@@ -385,7 +405,7 @@ ISC License - see [LICENSE](LICENSE) file for details.
 - [x] rm + push should delete file from remote storage (minor release)
 - [x] Uninitialize dorky setup (Bug fix release)
 - [ ] dorky --list remote --update should sync metadata according to remote (Minor release)
-- [ ] Extension for VS Code to list and highlight them like git (Major release)
+- [x] Extension for VS Code to list and highlight them like git (Major release)
 - [ ] MCP server (Minor release)
 - [ ] Encryption of files (Minor release)
 - [ ] Add stages for variables (Major release)

package/extension/dorky-extension/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+	// See https://go.microsoft.com/fwlink/?LinkId=733558
+	// for the documentation about the extensions.json format
+	"recommendations": [
+		"dbaeumer.vscode-eslint",
+		"ms-vscode.extension-test-runner"
+	]
+}

package/extension/dorky-extension/.vscode/launch.json

@@ -0,0 +1,17 @@
+// A launch configuration that launches the extension inside a new window
+// Use IntelliSense to learn about possible attributes.
+// Hover to view descriptions of existing attributes.
+// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+{
+	"version": "0.2.0",
+	"configurations": [
+		{
+			"name": "Run Extension",
+			"type": "extensionHost",
+			"request": "launch",
+			"args": [
+				"--extensionDevelopmentPath=${workspaceFolder}"
+			]
+		}
+	]
+}

package/extension/dorky-extension/.vscode-test.mjs

@@ -0,0 +1,5 @@
+import { defineConfig } from '@vscode/test-cli';
+
+export default defineConfig({
+	files: 'test/**/*.test.js',
+});

package/extension/dorky-extension/.vscodeignore

@@ -0,0 +1,10 @@
+.vscode/**
+.vscode-test/**
+test/**
+.gitignore
+.yarnrc
+vsc-extension-quickstart.md
+**/jsconfig.json
+**/*.map
+**/eslint.config.mjs
+**/.vscode-test.*

package/extension/dorky-extension/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Change Log
+
+All notable changes to the "dorky-extension" extension will be documented in this file.
+
+Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
+
+## [Unreleased]
+
+- Initial release

package/extension/dorky-extension/README.md

@@ -0,0 +1,106 @@
+# dorky-extension
+
+A VS Code extension for [dorky](https://dorky.trishantpahwa.me/) — DevOps Records Keeper. Manage sensitive project files (`.env`, API keys, config files) stored on AWS S3 or Google Drive directly from the VS Code sidebar.
+
+## Features
+
+- **Sidebar panel** showing staged and uploaded files at a glance
+- **Initialize** a dorky project with AWS S3 or Google Drive
+- **Stage files** using a file picker dialog
+- **Unstage files** with a single inline click in the tree
+- **Push** staged files to remote storage
+- **Pull** tracked files from remote storage
+- **List remote** files in the output channel
+- **Destroy** the project (removes remote files and local config)
+- Context-aware toolbar — actions only appear when relevant
+
+## Requirements
+
+- A dorky-compatible storage backend: **AWS S3** or **Google Drive**
+
+### AWS S3
+
+Set up the following environment variables before initializing:
+
+```bash
+export AWS_ACCESS_KEY="your-access-key"
+export AWS_SECRET_KEY="your-secret-key"
+export AWS_REGION="us-east-1"
+export BUCKET_NAME="your-bucket-name"
+```
+
+The extension will prompt you to enter these values during initialization.
+
+### Google Drive
+
+Place your OAuth 2.0 credentials file at the workspace root before initializing:
+
+```
+your-project/
+└── google-drive-credentials.json
+```
+
+A browser window will open for OAuth authentication when you initialize.
+
+## Getting Started
+
+1. Open your project folder in VS Code
+2. Click the **Dorky** icon in the activity bar
+3. Click **Initialize Project** in the welcome view
+4. Select a storage backend (`aws` or `google-drive`) and follow the prompts
+
+## Sidebar
+
+The Dorky panel appears in the activity bar. Once initialized it shows:
+
+```
+DORKY  FILES          [+] [↑] [↓] [≡] [↺] [🗑]
+  aws  storage
+  ▼ Staged  2 file(s)
+      .env                              [−]
+      config.json                       [−]
+  ▼ Uploaded  1 file(s)
+      .env
+```
+
+### Toolbar Actions
+
+| Icon | Command | Description |
+|------|---------|-------------|
+| `+` | Add Files | Open file picker to stage files |
+| `↑` | Push | Upload staged files to remote storage |
+| `↓` | Pull | Download tracked files from remote storage |
+| `≡` | List Remote | Show remote files in the Dorky output channel |
+| `↺` | Refresh | Refresh the sidebar tree |
+| `🗑` | Destroy Project | Delete remote files and local dorky config |
+
+### Inline Actions
+
+- Click `−` next to any staged file to instantly unstage it
+
+## Workflow
+
+```
+Initialize → Add Files → Push → (share project) → Pull
+```
+
+1. **Initialize** — creates `.dorky/` with credentials and metadata, updates `.gitignore`
+2. **Add** — stage files you want to track (file picker, multi-select)
+3. **Push** — uploads new/changed files; removes files that were unstaged
+4. **Pull** — downloads all tracked files on another machine
+
+## Output
+
+All operation logs appear in the **Dorky** output channel (`View → Output → Dorky`).
+
+## Security
+
+- `.dorky/credentials.json` is automatically added to `.gitignore`
+- Credentials are stored locally in the `.dorky/` folder and never committed
+- Google Drive tokens are refreshed automatically; re-authentication is triggered if the token is invalid
+
+## Release Notes
+
+### 0.0.1
+
+Initial release — full sidebar UI with AWS S3 and Google Drive support.

package/extension/dorky-extension/eslint.config.mjs

@@ -0,0 +1,25 @@
+import globals from "globals";
+
+export default [{
+    files: ["**/*.js"],
+    languageOptions: {
+        globals: {
+            ...globals.commonjs,
+            ...globals.node,
+            ...globals.mocha,
+        },
+
+        ecmaVersion: 2022,
+        sourceType: "module",
+    },
+
+    rules: {
+        "no-const-assign": "warn",
+        "no-this-before-super": "warn",
+        "no-undef": "warn",
+        "no-unreachable": "warn",
+        "no-unused-vars": "warn",
+        "constructor-super": "warn",
+        "valid-typeof": "warn",
+    },
+}];