electron-cli 0.2.6 → 0.3.0-alpha.0

package/Cargo.lock

@@ -0,0 +1,266 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "anstream"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "824a212faf96e9acacdbd09febd34438f8f711fb84e09a8916013cd7815ca28d"
+dependencies = [
+ "anstyle",
+ "anstyle-parse",
+ "anstyle-query",
+ "anstyle-wincon",
+ "colorchoice",
+ "is_terminal_polyfill",
+ "utf8parse",
+]
+
+[[package]]
+name = "anstyle"
+version = "1.0.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "940b3a0ca603d1eade50a4846a2afffd5ef57a9feac2c0e2ec2e14f9ead76000"
+
+[[package]]
+name = "anstyle-parse"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52ce7f38b242319f7cabaa6813055467063ecdc9d355bbb4ce0c68908cd8130e"
+dependencies = [
+ "utf8parse",
+]
+
+[[package]]
+name = "anstyle-query"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40c48f72fd53cd289104fc64099abca73db4166ad86ea0b4341abe65af83dadc"
+dependencies = [
+ "windows-sys",
+]
+
+[[package]]
+name = "anstyle-wincon"
+version = "3.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "291e6a250ff86cd4a820112fb8898808a366d8f9f58ce16d1f538353ad55747d"
+dependencies = [
+ "anstyle",
+ "once_cell_polyfill",
+ "windows-sys",
+]
+
+[[package]]
+name = "anyhow"
+version = "1.0.102"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f202df86484c868dbad7eaa557ef785d5c66295e41b460ef922eca0723b842c"
+
+[[package]]
+name = "camino"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e629a66d692cb9ff1a1c664e41771b3dcaf961985a9774c0eb0bd1b51cf60a48"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "clap"
+version = "4.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ddb117e43bbf7dacf0a4190fef4d345b9bad68dfc649cb349e7d17d28428e51"
+dependencies = [
+ "clap_builder",
+ "clap_derive",
+]
+
+[[package]]
+name = "clap_builder"
+version = "4.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "714a53001bf66416adb0e2ef5ac857140e7dc3a0c48fb28b2f10762fc4b5069f"
+dependencies = [
+ "anstream",
+ "anstyle",
+ "clap_lex",
+ "strsim",
+]
+
+[[package]]
+name = "clap_derive"
+version = "4.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2ce8604710f6733aa641a2b3731eaa1e8b3d9973d5e3565da11800813f997a9"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "clap_lex"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c8d4a3bb8b1e0c1050499d1815f5ab16d04f0959b233085fb31653fbfc9d98f9"
+
+[[package]]
+name = "colorchoice"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1d07550c9036bf2ae0c684c4297d503f838287c83c53686d05370d0e139ae570"
+
+[[package]]
+name = "electron-cli"
+version = "0.3.0-alpha.0"
+dependencies = [
+ "anyhow",
+ "camino",
+ "clap",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "is_terminal_polyfill"
+version = "1.70.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "memchr"
+version = "2.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b947ae49db0d222b1dbc6b113ce7248a3fc3a6ca21b696717bfc000ba4484d8"
+
+[[package]]
+name = "once_cell_polyfill"
+version = "1.70.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "384b8ab6d37215f3c5301a95a4accb5d64aa607f1fcb26a11b5303878451b4fe"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.150"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "strsim"
+version = "0.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "utf8parse"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

package/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "electron-cli"
+version = "0.3.0-alpha.0"
+edition = "2021"
+description = "Experimental Rust CLI for Electron project diagnostics and workflow automation"
+license = "MIT"
+repository = "https://github.com/roderik/electron-cli"
+
+[dependencies]
+anyhow = "1.0"
+camino = { version = "1.1", features = ["serde1"] }
+clap = { version = "4.6", features = ["derive"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"

package/LICENSE

@@ -1,20 +1,21 @@
-The MIT License (MIT)
-Copyright (c) 2016 Samuel Attard
+MIT License
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
+Copyright (c) 2026 Roderik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
-COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-ß
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,80 +1,83 @@
-electron-cli
-==============================================================================
+# electron-cli
 
-[npm-badge]: https://img.shields.io/npm/v/ember-cli.svg
-[npm-badge-url]: https://www.npmjs.com/package/electron-cli
+`electron-cli` is an experimental Rust CLI for Electron project diagnostics and workflow automation.
 
-[![Latest NPM release][npm-badge]][npm-badge-url]
-[![npm version](https://badge.fury.io/js/electron-cli.svg)](https://www.npmjs.com/package/electron-cli)
-[![npm](https://img.shields.io/npm/dt/electron-cli.svg?maxAge=2592000)](https://www.npmjs.com/package/electron-cli)
-[![license](https://img.shields.io/github/license/electron-userland/electron-forge.svg)](https://github.com/Ikana/electron-cli/blob/master/LICENSE)
+This is an independent learning project. It is not affiliated with Electron, Electron Forge, the OpenJS Foundation, or GitHub. The project may wrap existing Electron ecosystem tools while exploring what a Rust-native Electron workflow could feel like.
 
-An [electron](http://electron.atom.io/) command line utility.
+## Status
 
-[Repo](https://github.com/Ikana/electron-cli)
+This repository is intentionally small and public-learning friendly. The first useful surface area is inspection and diagnostics, because those commands are valuable for humans and easy for agents to consume safely.
 
-Features
-------------------------------------------------------------------------------
+Current commands:
 
-* [done] Create new project
-* [done] Get useful electron info such as(version numbers of Chromium, Node.js , and electron-cli)
-* [done] Run the electron app on the current directory either with the locally installed electron or the global one
-* [done] Pack the application for distribution
-* [wip] Build native node modules
+```sh
+electron-cli inspect
+electron-cli doctor
+electron-cli plan
+electron-cli inspect --json
+electron-cli doctor --json
+electron-cli plan --json
+```
 
+Planned commands:
 
-# Getting Started
+```sh
+electron-cli dev
+electron-cli init
+electron-cli package
+electron-cli make
+```
 
-**Note**: Electron Cli requires Node 6 or above, plus git installed.
+The planned workflow commands may start by wrapping Electron Forge or other established tools. Rust-native implementations can replace narrow pieces over time when there is a clear reason.
 
-```bash
-npm install -g electron-cli
-electron-cli init new-app
-cd new-app
-electron-cli start
-```
+## Install
 
-Installation
-------------------------------------------------------------------------------
+During the experimental phase, the npm package runs from Rust source when a prebuilt binary is not available. You need Node.js and Rust installed.
 
-```
+```sh
 npm install -g electron-cli
+electron-cli doctor
 ```
 
-Usage
-------------------------------------------------------------------------------
+For local development:
 
-After installation the `electron` CLI tool will be available to you. It is the
-entrypoint for all the functionality marked as done above.
+```sh
+npm install
+npm run build
+npm test
+npm run dev -- doctor
+```
 
-### Create a new project
+Or use Cargo directly:
 
-```
-electron-cli init my-new-app
+```sh
+cargo run -- doctor
+cargo run -- inspect --json
 ```
 
-This will create a new folder `my-new-app`, initialize a Git project in it and
-adds the basic electron quick start project.
+## Design Goals
 
-### Get Info of current installed electron
+- Learn Rust through a real developer tool.
+- Make Electron project state easy to inspect.
+- Prefer structured output for agentic workflows.
+- Wrap proven ecosystem tools before replacing them.
+- Keep the project clearly independent and experimental.
 
-```
-electron-cli stats
-```
-This will print the versions of the current installed electron instance
+## Non-Goals
 
-### Start electron application
+- This is not an official Electron project.
+- This is not an Electron Forge fork or drop-in replacement today.
+- This will not claim Forge parity until the behavior is tested and documented.
 
-```
-electron-cli start --global
-```
-This will run the electron application on the current directory, if you provide the
-global flag it will run the application with the globally installed electron instance.
+## JSON Output
 
-### Pack electron application
+Both initial commands support `--json` so agents and scripts can consume project state without scraping terminal output.
+`plan` is designed around that workflow: it recommends stable commands and reports missing project conventions as structured data.
 
+```sh
+electron-cli plan --json
 ```
-electron-cli pack
-```
 
-This will pack the application on the current directory with `electron-packager`
+## License
+
+MIT

package/bin/electron-cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const root = path.resolve(__dirname, "..");
+const exe = process.platform === "win32" ? "electron-cli.exe" : "electron-cli";
+const args = process.argv.slice(2);
+
+const candidates = [
+  path.join(root, "target", "release", exe),
+  path.join(root, "target", "debug", exe),
+];
+
+const binary = candidates.find((candidate) => fs.existsSync(candidate));
+
+if (binary) {
+  exitWith(spawnSync(binary, args, { stdio: "inherit" }));
+}
+
+const cargo = process.platform === "win32" ? "cargo.exe" : "cargo";
+const manifest = path.join(root, "Cargo.toml");
+
+if (!fs.existsSync(manifest)) {
+  console.error("electron-cli could not find its Rust sources.");
+  console.error("Reinstall the package or build a release binary before running this command.");
+  process.exit(1);
+}
+
+console.error("electron-cli is experimental and needs Rust to run from npm source packages.");
+console.error("Building/running through cargo; install Rust from https://rustup.rs if this fails.");
+
+exitWith(
+  spawnSync(cargo, ["run", "--quiet", "--manifest-path", manifest, "--", ...args], {
+    stdio: "inherit",
+  }),
+);
+
+function exitWith(result) {
+  if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+  }
+
+  process.exit(result.status ?? 1);
+}

package/package.json

@@ -1,90 +1,45 @@
 {
   "name": "electron-cli",
-  "version": "0.2.6",
-  "description": "Command line tool for developing useful electron apps",
-  "main": "dist/cli.js",
-  "scripts": {
-    "test": "gulp mocha",
-    "start": "./dist/cli.js",
-    "dev": "gulp dev",
-    "lint": "gulp lint",
-    "deploy": "gulp deploy",
-    "coverage": "nyc --reporter=lcov --all --reporter=text-lcov npm test"
+  "version": "0.3.0-alpha.0",
+  "description": "Experimental Rust CLI for Electron project diagnostics and workflow automation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/roderik/electron-cli.git"
+  },
+  "homepage": "https://github.com/roderik/electron-cli#readme",
+  "bugs": {
+    "url": "https://github.com/roderik/electron-cli/issues"
   },
   "bin": {
-    "electron-cli": "dist/cli.js"
+    "electron-cli": "bin/electron-cli.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "git@github.com:Ikana/electron-cli.git"
+  "files": [
+    "bin",
+    "src",
+    "tests",
+    "Cargo.toml",
+    "Cargo.lock",
+    "rust-toolchain.toml",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "cargo build --release",
+    "dev": "cargo run --",
+    "format": "cargo fmt",
+    "lint": "cargo fmt --check && cargo clippy --all-targets -- -D warnings",
+    "test": "cargo test",
+    "prepack": "cargo build --release"
+  },
+  "engines": {
+    "node": ">=18"
   },
-  "homepage": "https://github.com/Ikana/electron-cli",
   "keywords": [
     "electron",
     "cli",
-    "app",
-    "kit"
-  ],
-  "author": "Rodrigo Quezada",
-  "license": "MIT",
-  "dependencies": {
-    "babel-runtime": "^6.18.0",
-    "chalk": "^1.1.3",
-    "cli-table2": "^0.2.0",
-    "configstore": "^2.1.0",
-    "cpy": "^4.0.1",
-    "denodeify": "^1.2.1",
-    "electron-packager": "^8.3.0",
-    "exit": "^0.1.2",
-    "inquirer": "^1.2.1",
-    "jsonfile": "^2.4.0",
-    "leek": "0.0.23",
-    "mkdirp": "^0.5.1",
-    "node-fetch": "^1.6.3",
-    "nopt": "^3.0.6",
-    "ora": "^0.3.0",
-    "resolve": "^1.1.7",
-    "semver": "^5.3.0",
-    "username": "^2.2.2",
-    "validate-npm-package-name": "^2.2.2",
-    "yargs": "^5.0.0"
-  },
-  "devDependencies": {
-    "babel-plugin-istanbul": "^3.0.0",
-    "babel-plugin-syntax-async-functions": "^6.13.0",
-    "babel-plugin-transform-async-to-generator": "^6.16.0",
-    "babel-plugin-transform-object-rest-spread": "^6.19.0",
-    "babel-plugin-transform-runtime": "^6.15.0",
-    "babel-preset-es2015": "^6.18.0",
-    "babel-preset-stage-2": "^6.18.0",
-    "chai": "^3.5.0",
-    "del": "^2.2.2",
-    "eslint": "^3.10.0",
-    "eslint-config-airbnb-base": "^10.0.1",
-    "eslint-config-standard": "^6.2.1",
-    "eslint-plugin-import": "^2.2.0",
-    "eslint-plugin-promise": "^3.3.2",
-    "eslint-plugin-standard": "^2.0.1",
-    "gulp": "^3.9.1",
-    "gulp-babel": "^6.1.2",
-    "gulp-chmod": "^2.0.0",
-    "gulp-eslint": "^3.0.1",
-    "gulp-mocha": "^3.0.1",
-    "gulp-util": "^3.0.7",
-    "mocha": "^3.1.0",
-    "mock-fs": "^3.12.1",
-    "nyc": "^9.0.1",
-    "run-sequence": "^1.2.2",
-    "stream-combiner2": "^1.1.1"
-  },
-  "nyc": {
-    "include": [
-      "src/**/*.js"
-    ],
-    "require": [
-      "babel-register"
-    ],
-    "sourceMap": false,
-    "instrument": false
-  }
+    "rust",
+    "diagnostics",
+    "agentic-engineering"
+  ]
 }

package/rust-toolchain.toml

@@ -0,0 +1,3 @@
+[toolchain]
+channel = "stable"
+components = ["clippy", "rustfmt"]

package/src/cli.rs

@@ -0,0 +1,36 @@
+use std::path::PathBuf;
+
+use clap::{Args, Parser, Subcommand};
+
+#[derive(Debug, Parser)]
+#[command(
+    name = "electron-cli",
+    version,
+    about = "Experimental Rust CLI for Electron project diagnostics and workflow automation",
+    long_about = "electron-cli is an independent learning project for exploring Rust-native Electron tooling. It is not affiliated with Electron or Electron Forge."
+)]
+pub struct Cli {
+    #[command(subcommand)]
+    pub command: Commands,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum Commands {
+    /// Check whether the current project looks ready for Electron development.
+    Doctor(CommandArgs),
+    /// Print a structured snapshot of the current JavaScript/Electron project.
+    Inspect(CommandArgs),
+    /// Recommend next commands and risks from the project snapshot.
+    Plan(CommandArgs),
+}
+
+#[derive(Debug, Clone, Args)]
+pub struct CommandArgs {
+    /// Project directory to inspect.
+    #[arg(long, default_value = ".", value_name = "PATH")]
+    pub cwd: PathBuf,
+
+    /// Emit machine-readable JSON.
+    #[arg(long)]
+    pub json: bool,
+}