magic-spec 1.3.2 β†’ 1.4.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 (4) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +258 -195
  3. package/installers/node/index.js +9 -2
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.4.1] - 2026-03-01
9
+
10
+ ### Fixed
11
+
12
+ - **Localization**: Translated remaining Russian text in `README.md` Mermaid diagrams to English.
13
+
14
+ ## [1.4.0] - 2026-03-01
15
+
16
+ ### Added
17
+
18
+ - **Smart Sync Optimization (AOP)** in `analyze.md`: Automated detection of manual renames during project re-analysis. If an orphaned specification matches a new uncovered directory (>80% similarity or title match), it triggers a `[RESCUE]` action instead of delete/create cycle.
19
+ - **Manual Rename Rescue** in `spec.md`: Protocol to globally update references (INDEX, PLAN, TASKS) when a specification file is moved/renamed, preserving task progress.
20
+ - **Regression Tests (T48–T51)**: Added coverage for Engine Integrity guards, Analysis Depth Control, and Smart Sync mechanisms.
21
+
22
+ ### Changed
23
+
24
+ - **Test Suite Synchronization**: The `suite.md` version is now synchronized with the core engine version to prevent metadata confusion.
25
+
8
26
  ## [1.3.2] - 2026-02-28
9
27
 
10
28
  ### Added
package/README.md CHANGED
@@ -1,195 +1,258 @@
1
- # πŸͺ„ Magic Spec
2
-
3
- [![NPM version](https://img.shields.io/npm/v/magic-spec?color=green&label=npm)](https://www.npmjs.com/package/magic-spec)
4
- [![PyPI version](https://img.shields.io/pypi/v/magic-spec?color=blue&label=pypi)](https://pypi.org/project/magic-spec/)
5
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
6
-
7
- ## πŸ“– Description
8
-
9
- **The Specification-Driven Development (SDD) Operating System for AI Coding Agents.**
10
-
11
- Stop your AI from writing fragile code before it fully understands the problem. `magic-spec` installs a high-performance, structured pipeline β€” *Thought β†’ Spec β†’ Task β†’ Run β†’ Code* β€” directly into any project, regardless of the tech stack.
12
-
13
- Whether you are a **coding novice** building your first application or a **senior engineer** architecting enterprise systems, Magic Spec brings **maximum automation** and professional rigor to your development process. It enforces a deterministic workflow that ensures your AI agent perfectly aligns with your vision before writing a single line of code.
14
-
15
- ### The Core Concept
16
-
17
- `magic-spec` is a set of **markdown-based workflow instructions** specifically designed for AI coding agents like Cursor, Windsurf, Claude, and Gemini. It acts as a project-level operating system that orchestrates agentic development.
18
-
19
- Instead of chaotic prompt-engineering, Magic Spec provides a rigorous pipeline:
20
-
21
- ```plaintext
22
- πŸ’‘ Idea β†’ πŸ“‹ Specification β†’ πŸ—ΊοΈ Task & Plan β†’ ⚑ Run β†’ πŸš€ Code
23
- ```
24
-
25
- Once initialized, your AI agent will automatically:
26
-
27
- - Formulate a strong conceptual and technical specification.
28
- - Build a phased implementation plan with hierarchical dependencies.
29
- - Decompose the plan into prioritized, atomic, trackable tasks.
30
- - Facilitate safe architectural brainstorming via **Explore Mode**.
31
- - Analyze its own workflow and suggest improvements via Auto-Retrospectives.
32
-
33
- ### What Gets Installed
34
-
35
- After running the installer, your project directory will be augmented with the following structure:
36
-
37
- ```plaintext
38
- root-project/
39
- β”œβ”€β”€ .agent/workflows/ # Slash commands wrapper (e.g., magic.spec, magic.task)
40
- β”œβ”€β”€ .magic/ # The SDD Engine (workflow logic and scripts - read-only)
41
- └── .design/ # Your Project Design Workspace (INDEX.md, RULES.md, PLAN.md)
42
- ```
43
-
44
- 1. **`.magic/`**: Deploys the core SDD engine.
45
- 2. **`.agent/`**: Sets up workflows for your AI.
46
- 3. **`.design/`**: Initializes your project's workspace for Specifications, Rules, and Plans.
47
- 4. **Onboarding**: An interactive tutorial (`magic.onboard`) helps you and your AI get started smoothly.
48
-
49
- ## πŸ–ΌοΈ Visuals
50
-
51
- The engine operates on a smart, self-correcting feedback loop:
52
-
53
- ```mermaid
54
- graph TD
55
- IDEA["πŸ’‘ Idea"] --> INIT{"πŸ—οΈ Auto-Init"}
56
- INIT -->|.design/ exists| SPEC
57
- INIT -->|.design/ missing| CREATE["Create .design/ structure"] --> SPEC
58
- SPEC["πŸ“‹ Specification"] <--> RULE["πŸ“œ Rule"]
59
- SPEC --> TASK["πŸ—ΊοΈ Task & Plan"]
60
- TASK --> RUN["⚑ Run"]
61
- RUN --> CODE["πŸš€ Code"]
62
- RUN -.->|"auto: phase done"| RETRO["πŸ” Retrospective"]
63
- RETRO -.->|Feedback loop| SPEC
64
- ```
65
-
66
- ## βš™οΈ Requirements
67
-
68
- Before installing Magic Spec, ensure you have one of the following available on your system:
69
-
70
- | Requirement | Details |
71
- | :--- | :--- |
72
- | **Node.js** | Version `16.x` or higher (for `npx` method) |
73
- | **Python** | Version `3.8` or higher (for `uvx` or `pipx` methods) |
74
- | **Git** | Required for installing edge versions directly from GitHub |
75
- | **Terminal** | `tar` utility (pre-installed on Windows/Linux/macOS) |
76
-
77
- ## πŸ“¦ Installation
78
-
79
- Works perfectly with **any project** β€” Rust, Go, Python, JavaScript, C++, or anything else. No runtime lock-in.
80
-
81
- ### Option A: Node.js (`npx`)
82
-
83
- **Stable Release:**
84
-
85
- ```bash
86
- npx magic-spec@latest
87
- ```
88
-
89
- **Edge Version (GitHub):**
90
-
91
- ```bash
92
- npx --yes github:teratron/magic-spec
93
- ```
94
-
95
- ### Option B: Python (`uvx`)
96
-
97
- **Stable Release:**
98
-
99
- ```bash
100
- uvx magic-spec
101
- ```
102
-
103
- **Edge Version (GitHub):**
104
-
105
- ```bash
106
- uvx --from git+https://github.com/teratron/magic-spec.git magic-spec
107
- ```
108
-
109
- ### Option C: Python (`pipx`)
110
-
111
- ```bash
112
- pipx run magic-spec
113
- ```
114
-
115
- ### Option D: Manual Installation
116
-
117
- If automated installers do not fit your environment:
118
-
119
- 1. **Engine**: Download the `.magic/` folder from the [GitHub repository](https://github.com/teratron/magic-spec).
120
- 2. **Workflows**: Download command wrappers from [`.agent/workflows/`](https://github.com/teratron/magic-spec/tree/main/.agent/workflows).
121
- 3. **Deploy**: Place files into your AI agent's instruction directory (e.g., `.cursor/commands`).
122
-
123
- ## πŸš€ Usage
124
-
125
- Just talk to your AI agent naturally in your prompt interface. No complex commands to learn:
126
-
127
- - *"Dispatch this thought into specs..."* β†’ Triggers **Specification** workflow.
128
- - *"Create an implementation plan"* β†’ Triggers **Task & Plan** workflow.
129
- - *"Execute the next task"* β†’ Triggers **Run** workflow.
130
- - *"Add a rule: always use Inter font"* β†’ Triggers **Rule** workflow.
131
-
132
- ### 🀝 Compatibility
133
-
134
- Magic Spec is heavily optimized and provides native workflow generation for the world's most powerful AI development environments:
135
-
136
- | AI Agent / IDE | Installation Flag |
137
- | :--- | :--- |
138
- | [**Cursor**](https://cursor.com) (Agent Mode) | `--cursor` |
139
- | [**Windsurf**](https://codeium.com/windsurf) (Cascade) | `--windsurf` |
140
- | [**Claude Code**](https://claude.ai/code) | `--claude` |
141
- | [**Gemini CLI**](https://gemini.google.com) | `--gemini` |
142
- | [**GitHub Copilot**](https://github.com/features/copilot) | `--copilot` |
143
- | **Roo Code** | `--roo` |
144
- | **Amp** | `--amp` |
145
- | **Amazon Q Developer** | `--q` |
146
- | **Kilo Code** | `--kilocode` |
147
- | **Qwen Code** | `--qwen` |
148
- | **OpenCode** | `--opencode` |
149
- | **SHAI (OVHcloud)** | `--shai` |
150
- | **IBM Bob** | `--bob` |
151
- | **CodeBuddy** | `--codebuddy` |
152
- | **Qoder IDE** | `--qoder` |
153
- | **Codex CLI** | `--codex` |
154
- | **Auggie CLI** | `--augment` |
155
- | **Antigravity IDE** | `--antigravity` |
156
- | **Lingma IDE** | `--lingma` |
157
-
158
- ## πŸ“š Documentation
159
-
160
- - [**Main Documentation**](./docs/README.md) β€” Detailed guide on workflows, architecture, and advanced features.
161
- - [**Installers Guide**](./installers/README.md) β€” Advanced CLI options and platform specifics.
162
- - [**Contributing**](./docs/contributing.md) β€” How to develop, test, and extend the engine.
163
-
164
- ## πŸ›Ÿ Support
165
-
166
- If you encounter issues or have questions:
167
-
168
- - Open an [Issue](https://github.com/teratron/magic-spec/issues) on GitHub.
169
- - Run `magic.onboard` in your agent to restart the interactive tutorial.
170
-
171
- ## πŸ—ΊοΈ Roadmap
172
-
173
- - [x] Multi-agent adapter system.
174
- - [x] Phased implementation planning.
175
- - [ ] Extended support for local-first LLM agents.
176
- - [ ] Advanced visual dashboard for project health.
177
- - [ ] Integration with CI/CD for automated spec validation.
178
-
179
- ## 🀝 Contributing
180
-
181
- We welcome contributions! Whether it's a bug fix, a new adapter, or an improvement to the workflow logic.
182
- Please see [**Contributing Guide**](./docs/contributing.md) for details.
183
-
184
- ## πŸ‘₯ Authors and Acknowledgments
185
-
186
- - **Oleg Alexandrov** β€” Creator and Lead Maintainer.
187
- - Special thanks to the AI agent community for inspiration and testing.
188
-
189
- ## πŸ“„ License
190
-
191
- Distributed under the [MIT License](./LICENSE).
192
-
193
- ## πŸ“Š Project Status
194
-
195
- **Active Development** (v1.x). We are constantly refining the SDD engine based on real-world usage.
1
+ # πŸͺ„ Magic Spec
2
+
3
+ [![NPM version](https://img.shields.io/npm/v/magic-spec?color=green&label=npm)](https://www.npmjs.com/package/magic-spec)
4
+ [![PyPI version](https://img.shields.io/pypi/v/magic-spec?color=blue&label=pypi)](https://pypi.org/project/magic-spec/)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
6
+
7
+ ## πŸ“– Description
8
+
9
+ **The Specification-Driven Development (SDD) Operating System for AI Coding Agents.**
10
+
11
+ Stop your AI from writing fragile code before it fully understands the problem. `magic-spec` installs a high-performance, structured pipeline β€” *Thought β†’ Spec β†’ Task β†’ Run β†’ Code* β€” directly into any project, regardless of the tech stack.
12
+
13
+ Whether you are a **coding novice** building your first application or a **senior engineer** architecting enterprise systems, Magic Spec brings **maximum automation** and professional rigor to your development process. It enforces a deterministic workflow that ensures your AI agent perfectly aligns with your vision before writing a single line of code.
14
+
15
+ ### The Core Concept
16
+
17
+ `magic-spec` is a set of **markdown-based workflow instructions** specifically designed for AI coding agents like Cursor, Windsurf, Claude, and Gemini. It acts as a project-level operating system that orchestrates agentic development.
18
+
19
+ Instead of chaotic prompt-engineering, Magic Spec provides a rigorous pipeline:
20
+
21
+ ```plaintext
22
+ πŸ’‘ Idea β†’ πŸ“‹ Specification β†’ πŸ—ΊοΈ Task & Plan β†’ ⚑ Run β†’ πŸš€ Code
23
+ ```
24
+
25
+ Once initialized, your AI agent will automatically:
26
+
27
+ - Formulate a strong conceptual and technical specification.
28
+ - Build a phased implementation plan with hierarchical dependencies.
29
+ - Decompose the plan into prioritized, atomic, trackable tasks.
30
+ - Facilitate safe architectural brainstorming via **Explore Mode**.
31
+ - Analyze its own workflow and suggest improvements via Auto-Retrospectives.
32
+
33
+ ### What Gets Installed
34
+
35
+ After running the installer, your project directory will be augmented with the following structure:
36
+
37
+ ```plaintext
38
+ root-project/
39
+ β”œβ”€β”€ .agent/workflows/ # Slash commands wrapper (e.g., magic.spec, magic.task)
40
+ β”œβ”€β”€ .magic/ # The SDD Engine (workflow logic and scripts - read-only)
41
+ └── .design/ # Your Project Design Workspace (INDEX.md, RULES.md, PLAN.md)
42
+ ```
43
+
44
+ 1. **`.magic/`**: Deploys the core SDD engine.
45
+ 2. **`.agent/`**: Sets up workflows for your AI.
46
+ 3. **`.design/`**: Initializes your project's workspace for Specifications, Rules, and Plans.
47
+ 4. **Onboarding**: An interactive tutorial (`magic.onboard`) helps you and your AI get started smoothly.
48
+
49
+ > [!TIP]
50
+ > **Magic Workspaces**: Magic Spec supports multiple, isolated design environments within a single repository (e.g., `.design/engine/`, `.design/installers/`). This allows you to manage fundamentally different project domains without specification overlap, while sharing a single core engine. See [workspaces.md](./workspaces.md) for details.
51
+
52
+ ## πŸ–ΌοΈ Visuals
53
+
54
+ The engine enforces a rigorous, unskippable pipeline: **Idea β†’ Specification β†’ Task & Plan β†’ Code**. AI agents are prevented from jumping straight to coding. They must first formally specify the solution, then break it down into a concrete plan and tasks, and only then proceed to execution.
55
+
56
+ ```mermaid
57
+ flowchart TB
58
+ IDEA(["πŸ’‘ Idea"])
59
+
60
+ subgraph BOX ["Magic Spec"]
61
+ direction TB
62
+
63
+ SPEC["πŸ“‹ Spec"]
64
+
65
+ subgraph TASK ["πŸ—ΊοΈ Task"]
66
+ direction TB
67
+ PLAN["πŸ“ Plan"]
68
+ TASKS["πŸ“Œ Tasks"]
69
+ PLAN --> TASKS
70
+ end
71
+
72
+ RUN["⚑ Run"]
73
+
74
+ SPEC --> PLAN
75
+ TASKS --> RUN
76
+ end
77
+
78
+ CODE(["πŸš€ Code"])
79
+
80
+ IDEA --> SPEC
81
+ RUN --> CODE
82
+
83
+ style IDEA fill:#1e1e2e,stroke:#89b4fa,color:#cdd6f4
84
+ style CODE fill:#1e1e2e,stroke:#a6e3a1,color:#cdd6f4
85
+
86
+ style BOX fill:#181825,stroke:#fab387,stroke-width:3px,color:#fab387
87
+
88
+ style SPEC fill:#1e1e2e,stroke:#89b4fa,color:#cdd6f4
89
+ style RUN fill:#1e1e2e,stroke:#89b4fa,color:#cdd6f4
90
+
91
+ style TASK fill:#11111b,stroke:#89b4fa,stroke-dasharray:5 5,color:#89b4fa
92
+ style PLAN fill:#1e1e2e,stroke:#45475a,stroke-dasharray:4 4,color:#cdd6f4
93
+ style TASKS fill:#1e1e2e,stroke:#45475a,stroke-dasharray:4 4,color:#cdd6f4
94
+ ```
95
+
96
+ ## βš™οΈ Requirements
97
+
98
+ Before installing Magic Spec, ensure you have one of the following available on your system:
99
+
100
+ | Requirement | Details |
101
+ | :--- | :--- |
102
+ | **Node.js** | Version `16.x` or higher (for `npx` method) |
103
+ | **Python** | Version `3.8` or higher (for `uvx` or `pipx` methods) |
104
+ | **Git** | Required for installing edge versions directly from GitHub |
105
+ | **Terminal** | `tar` utility (pre-installed on Windows/Linux/macOS) |
106
+
107
+ ## πŸ“¦ Installation
108
+
109
+ Works perfectly with **any project** β€” Rust, Go, Python, JavaScript, C++, or anything else. No runtime lock-in.
110
+
111
+ ### Option A: Node.js (`npx`)
112
+
113
+ **Stable Release:**
114
+
115
+ ```bash
116
+ # Basic installation (defaults to .agent/ folder)
117
+ npx magic-spec@latest
118
+
119
+ # Targeted installation for Cursor
120
+ npx magic-spec@latest --cursor
121
+ ```
122
+
123
+ **Edge Version (GitHub):**
124
+
125
+ ```bash
126
+ npx --yes github:teratron/magic-spec
127
+ ```
128
+
129
+ ### Option B: Python (`uvx`)
130
+
131
+ **Stable Release:**
132
+
133
+ ```bash
134
+ # Basic installation
135
+ uvx magic-spec
136
+
137
+ # Targeted installation for Windsurf
138
+ uvx magic-spec --windsurf
139
+ ```
140
+
141
+ **Edge Version (GitHub):**
142
+
143
+ ```bash
144
+ uvx --from git+https://github.com/teratron/magic-spec.git magic-spec
145
+ ```
146
+
147
+ ### Option C: Python (`pipx`)
148
+
149
+ ```bash
150
+ pipx run magic-spec
151
+ ```
152
+
153
+ ### Option D: Multi-Adapter Installation
154
+
155
+ You can install support for multiple adapters at once:
156
+
157
+ ```bash
158
+ npx magic-spec@latest --cursor --copilot --windsurf
159
+ ```
160
+
161
+ ### Option E: Manual Installation
162
+
163
+ If automated installers do not fit your environment:
164
+
165
+ 1. **Engine**: Download the `.magic/` folder from the [GitHub repository](https://github.com/teratron/magic-spec).
166
+ 2. **Workflows**: Download command wrappers from [`.agent/workflows/`](https://github.com/teratron/magic-spec/tree/main/.agent/workflows).
167
+ 3. **Deploy**: Place files into your AI agent's instruction directory (e.g., `.cursor/commands`).
168
+
169
+ ## πŸ”„ Updating
170
+
171
+ Keep your SDD engine up to date with the latest logic and features:
172
+
173
+ ```bash
174
+ # Check if update is available
175
+ npx magic-spec@latest --check
176
+
177
+ # Perform the update
178
+ npx magic-spec@latest --update
179
+ ```
180
+
181
+ > [!TIP]
182
+ > The update process preserves your `.design/` workspace and automatically creates backups of `.magic/` and `.agent/` folders. If you have modified core engine files, the installer will detect conflicts and ask for your preference (overwrite, skip, or abort).
183
+
184
+ ## πŸ’¬ Usage
185
+
186
+ Just talk to your AI agent naturally in your prompt interface. No complex commands to learn:
187
+
188
+ - *"Dispatch this thought into specs..."* β†’ Triggers **Specification** workflow.
189
+ - *"Create an implementation plan"* β†’ Triggers **Task & Plan** workflow.
190
+ - *"Execute the next task"* β†’ Triggers **Run** workflow.
191
+ - *"Add a rule: always use Inter font"* β†’ Triggers **Rule** workflow.
192
+
193
+ ### 🀝 Compatibility
194
+
195
+ Magic Spec is heavily optimized and provides native workflow generation for the world's most powerful AI development environments.
196
+
197
+ You can install support for a specific adapter using the shortcut flag (e.g., `--cursor`) or the environment flag (e.g., `--env cursor`).
198
+
199
+ | AI Agent / IDE | Shortcut Flag | Env Flag |
200
+ | :--- | :--- | :--- |
201
+ | [**Cursor**](https://cursor.com) (Agent Mode) | `--cursor` | `--env cursor` |
202
+ | [**Windsurf**](https://codeium.com/windsurf) (Cascade) | `--windsurf` | `--env windsurf` |
203
+ | [**Claude Code**](https://claude.ai/code) | `--claude` | `--env claude` |
204
+ | [**Gemini CLI**](https://gemini.google.com) | `--gemini` | `--env gemini` |
205
+ | [**GitHub Copilot**](https://github.com/features/copilot) | `--copilot` | `--env copilot` |
206
+ | **Roo Code** | `--roo` | `--env roo` |
207
+ | **Amp** | `--amp` | `--env amp` |
208
+ | **Amazon Q Developer** | `--q` | `--env q` |
209
+ | **Kilo Code** | `--kilocode` | `--env kilocode` |
210
+ | **Qwen Code** | `--qwen` | `--env qwen` |
211
+ | **OpenCode** | `--opencode` | `--env opencode` |
212
+ | **SHAI (OVHcloud)** | `--shai` | `--env shai` |
213
+ | **IBM Bob** | `--bob` | `--env bob` |
214
+ | **CodeBuddy** | `--codebuddy` | `--env codebuddy` |
215
+ | **Qoder IDE** | `--qoder` | `--env qoder` |
216
+ | **Codex CLI** | `--codex` | `--env codex` |
217
+ | **Auggie CLI** | `--augment` | `--env augment` |
218
+ | **Antigravity IDE** | `--antigravity` | `--env antigravity` |
219
+ | **Lingma IDE** | `--lingma` | `--env lingma` |
220
+
221
+ ## πŸ“š Documentation
222
+
223
+ - [**Main Documentation**](./docs/README.md) β€” Detailed guide on workflows, architecture, and advanced features.
224
+ - [**Installers Guide**](./installers/README.md) β€” Advanced CLI options and platform specifics.
225
+ - [**Contributing**](./docs/contributing.md) β€” How to develop, test, and extend the engine.
226
+
227
+ ## πŸ›Ÿ Support
228
+
229
+ If you encounter issues or have questions:
230
+
231
+ - Open an [Issue](https://github.com/teratron/magic-spec/issues) on GitHub.
232
+ - Run `magic.onboard` in your agent to restart the interactive tutorial.
233
+
234
+ ## πŸ—ΊοΈ Roadmap
235
+
236
+ - [x] Multi-agent adapter system.
237
+ - [x] Phased implementation planning.
238
+ - [ ] Extended support for local-first LLM agents.
239
+ - [ ] Advanced visual dashboard for project health.
240
+ - [ ] Integration with CI/CD for automated spec validation.
241
+
242
+ ## πŸ—οΈ Contributing
243
+
244
+ We welcome contributions! Whether it's a bug fix, a new adapter, or an improvement to the workflow logic.
245
+ Please see [**Contributing Guide**](./docs/contributing.md) for details.
246
+
247
+ ## πŸ‘₯ Authors and Acknowledgments
248
+
249
+ - **Oleg Alexandrov** β€” Creator and Lead Maintainer.
250
+ - Special thanks to the AI agent community for inspiration and testing.
251
+
252
+ ## πŸ“„ License
253
+
254
+ Distributed under the [MIT License](./LICENSE).
255
+
256
+ ## πŸ“Š Project Status
257
+
258
+ **Active Development** (v1.x). We are constantly refining the SDD engine based on real-world usage.
package/installers/node/index.js CHANGED
@@ -135,7 +135,7 @@ function collectEnvValues(argv) {
135
135
  return [...new Set(parsed)];
136
136
  }
137
137
 
138
- const envValues = collectEnvValues(args);
138
+ let envValues = collectEnvValues(args);
139
139
  let selectedEnv = envValues.length > 0 ? envValues[0] : null;
140
140
 
141
141
  function runListEnvs(adapters) {
@@ -155,7 +155,7 @@ function runListEnvs(adapters) {
155
155
  const dest = `${adapter.dest}/`.padEnd(28);
156
156
  console.log(` ${name}${padding}${dest}${adapter.description || ''}`);
157
157
  }
158
- console.log('\nUsage: npx magic-spec@latest --env <name>');
158
+ console.log('\nUsage: npx magic-spec@latest --env <name> OR --<name> (e.g. --cursor)');
159
159
  }
160
160
 
161
161
  function askQuestion(query) {
@@ -660,6 +660,7 @@ async function main() {
660
660
  console.log(" --eject Remove magic-spec from project");
661
661
  console.log("\nOptions:");
662
662
  console.log(" --env <adapter> Specify environment adapter");
663
+ console.log(" --<adapter> Shortcut for --env <adapter> (e.g. --cursor)");
663
664
  console.log(" --update Update engine files only");
664
665
  console.log(" --fallback-main Pull payload from main branch");
665
666
  console.log(" --yes, -y Auto-accept prompts");
@@ -699,6 +700,12 @@ async function main() {
699
700
  }
700
701
 
701
702
  // Determine environment
703
+ for (const env in ADAPTERS) {
704
+ if (args.includes(`--${env}`)) {
705
+ if (!envValues.includes(env)) envValues.push(env);
706
+ }
707
+ }
708
+
702
709
  let selectedEnvResolved = null;
703
710
  if (envValues.length > 0) {
704
711
  selectedEnvResolved = envValues[0];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "magic-spec",
3
- "version": "1.3.2",
3
+ "version": "1.4.1",
4
4
  "description": "Magic Specification-Driven Development (SDD) Workflow",
5
5
  "author": "Oleg Alexandrov <alexandrovoleg.ru@gmail.com>",
6
6
  "license": "MIT",