@heetmehta18/autodev 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +69 -28
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,50 +1,91 @@
1
- # AutoDev NPM CLI Wrapper
1
+ # AutoDev CLI — The App Store for Developers ⚡
2
2
 
3
- This package provides a lightweight Node.js wrapper around the native Go compiled binaries for AutoDev. It allows developers to run AutoDev seamlessly using standard Node package execution engines like `npx` or `pnpm dlx`, or by installing it globally via npm.
3
+ [![npm version](https://img.shields.io/npm/v/@heetmehta18/autodev.svg)](https://www.npmjs.com/package/@heetmehta18/autodev)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4
5
 
5
- ## Usage
6
+ **AutoDev** is an open-source, cross-platform developer environment bootstrapper. It acts as an **App Store for Developers**, simplifying complex toolchain setups through intelligent, profile-based automation.
6
7
 
7
- ### Run via npx (No Installation Needed)
8
+ ---
8
9
 
10
+ ## 🚀 Key Features
11
+
12
+ * 🔍 **Polyglot Codebase Scanner**: Detects 30+ languages, frameworks, package managers, and DevOps infrastructure.
13
+ * 🛡️ **Supply-Chain Security Audits**: Queries the OSV (Open Source Vulnerabilities) database to find safety risks in your dependencies.
14
+ * ⚙️ **Ballast Installer**: Automatically extracts and links compilers/runtimes (like Node.js, Go, Python, Rust) to your path.
15
+ * 📦 **Monorepo / Multi-project Scanner**: Groups and maps nested modules dynamically within a monorepo structure.
16
+ * 🛰️ **Cloud IDE Scaffolding**: Runs `autodev containerize` to generate `.devcontainer.json` environment setups.
17
+ * 🔄 **Config Migrator**: Seamlessly upgrades legacy profile configurations to standard YAML.
18
+
19
+ ---
20
+
21
+ ## 📦 Installation & Quick Start
22
+
23
+ You can run AutoDev on the fly using Node's package executor, or install it globally.
24
+
25
+ ### 1. Run Instantly (No Installation)
26
+ Scan your workspace and bootstrap dependencies without installing anything permanently:
9
27
  ```bash
10
- npx @heetmehta18/autodev --help
28
+ npx @heetmehta18/autodev setup
11
29
  ```
12
30
 
13
- ### Install Globally
14
-
31
+ ### 2. Install Globally
32
+ Install the package globally for instant local terminal access:
15
33
  ```bash
16
34
  npm install -g @heetmehta18/autodev
35
+ ```
36
+
37
+ ### 3. Usage
38
+ Verify that the CLI is installed and ready:
39
+ ```bash
17
40
  autodev --help
18
41
  ```
19
42
 
20
- ### Run Model Context Protocol (MCP) Server (Continuous Server)
43
+ ---
21
44
 
22
- The wrapper fully supports long-running stream-based commands like the AutoDev MCP server. To start the server and connect your AI coding tools (e.g. Claude Desktop, Cursor) to your local environment:
45
+ ## 🛠️ Main CLI Commands
23
46
 
47
+ ### 🔍 scan
48
+ Analyzes your current working directory for configuration markers, lockfiles, and monorepo folders:
24
49
  ```bash
25
- # Run directly via npx
26
- npx @heetmehta18/autodev mcp start
50
+ autodev scan
51
+ ```
27
52
 
28
- # Run globally (if installed)
29
- autodev mcp start
53
+ ### 📦 setup
54
+ Scans the project and aligns your local development environment by downloading missing runtimes:
55
+ ```bash
56
+ autodev setup
57
+ autodev setup --yes # Skip confirmation prompts
30
58
  ```
31
59
 
32
- ## How It Works
60
+ ### 🩺 doctor
61
+ Inspects your system configuration, checks tool versions against the `.autodev.lock.json` lockfile, and scans for exposed secrets (like AWS keys or GitHub tokens):
62
+ ```bash
63
+ autodev doctor
64
+ autodev doctor --fix # Restore lockfile mismatches automatically
65
+ ```
66
+
67
+ ### 🛡️ audit
68
+ Scans lockfiles and dependencies for known supply-chain vulnerabilities using the OSV database:
69
+ ```bash
70
+ autodev audit
71
+ ```
33
72
 
34
- 1. **Platform Detection:** The JavaScript wrapper reads `process.platform` and `process.arch` to map the user's platform to the target release asset names (e.g. `linux/amd64`, `windows/arm64`, `darwin/arm64`).
35
- 2. **Dynamic Download:** If the native binary is not yet cached locally in this package's `bin/` directory, the wrapper automatically downloads the correct compressed release (`.tar.gz` or `.zip`) directly from the corresponding GitHub Release tag (matching the `package.json` version).
36
- 3. **Execution Delegation:** The wrapper spawns the native binary as a subprocess, forwarding all arguments, stdio streams, and exit codes. Future runs bypass the download step entirely for instant execution.
37
- 4. **Development DX Mode:** During local development, if a compiled binary is found under `packages/cli/bin/autodev`, the wrapper forwards execution directly to the local dev build, bypassing remote GitHub requests.
73
+ ### 💻 containerize
74
+ Generates dev container setup configurations (`.devcontainer.json`) and VSCode plugin recommendations based on the detected stack:
75
+ ```bash
76
+ autodev containerize
77
+ ```
78
+
79
+ ### 🔄 migrate
80
+ Upgrades legacy `.json` profile configs to the standard `.autodev.yaml` schema:
81
+ ```bash
82
+ autodev migrate
83
+ ```
38
84
 
39
- ## Publishing
85
+ ---
40
86
 
41
- To publish updates to the npm registry:
87
+ ## ⚙️ How It Works
42
88
 
43
- 1. Ensure the package version matches the GitHub release tag:
44
- ```bash
45
- pnpm --filter=@heetmehta18/autodev version <new-version>
46
- ```
47
- 2. Publish to npm:
48
- ```bash
49
- pnpm --filter=@heetmehta18/autodev publish
50
- ```
89
+ 1. **Platform Detection**: The wrapper maps your OS and CPU architecture (e.g. `linux/amd64`, `darwin/arm64`) to the corresponding compiled Go binary.
90
+ 2. **Binary Caching**: Downloads the pre-compiled binary directly from the matching GitHub Release tag. Subsequent executions are run instantly from cache.
91
+ 3. **Process Delegation**: Delegated execution forwards all streams, signals, exit codes, and Model Context Protocol (MCP) servers seamlessly.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@heetmehta18/autodev",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "The App Store for Developers. Install languages, frameworks, and databases with a single command.",
5
5
  "main": "bin/index.js",
6
6
  "bin": {