mspec 0.0.7 → 0.0.8

package/README.md

@@ -19,7 +19,7 @@ It is designed to work seamlessly alongside your favorite AI coding agents: Clau
 We recommend running `mspec` directly via `npx` so you always get the freshest, most up-to-date prompts for your AI agents when initializing a new project.
 
 ```bash
-npx mspec init
+npx mspec@latest init
 ```
 
 ---
@@ -31,11 +31,12 @@ The workflow follows a simple three-step loop: **Initialize -> Plan -> Implement
 ### Step 1: Initialize the Project
 Run this command in the root of your project:
 ```bash
-npx mspec init
+npx mspec@latest init
 ```
 - It will prompt you for your preferred AI agent (Claude, Gemini, Cursor, etc.).
 - It will create the `.mspec/specs/` and `.mspec/tasks/` directories.
 - It will automatically inject custom commands into your project (e.g., `.gemini/commands/mspec.plan.toml` or `.cursor/rules/mspec.implement.mdc`) so your AI agent natively understands the framework and provides autocomplete commands like `/mspec.spec`.
+- **Note:** If you already have `.mspec` in your project, running this command will **update** your local AI instructions to the latest version without overwriting your specs or tasks.
 
 *(Note: After running `init`, you may need to restart your AI agent session so it can detect the new slash commands).*
 

package/dist/commands/init.js

@@ -12,27 +12,44 @@ const templates_1 = require("../templates");
 const { prompt } = require('enquirer');
 async function initCommand() {
     const mspecDir = path_1.default.join(process.cwd(), '.mspec');
+    const configPath = path_1.default.join(mspecDir, 'mspec.json');
+    let existingAgent = '';
     if (fs_1.default.existsSync(mspecDir)) {
-        console.log(chalk_1.default.yellow('.mspec directory already exists. Initialization skipped.'));
-        return;
+        console.log(chalk_1.default.blue('Existing .mspec directory found. Updating integration files...'));
+        if (fs_1.default.existsSync(configPath)) {
+            try {
+                const config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
+                if (config && config.agent) {
+                    existingAgent = config.agent;
+                }
+            }
+            catch (e) {
+                // ignore JSON parse errors
+            }
+        }
     }
-    let response;
-    try {
-        response = await prompt({
-            type: 'select',
-            name: 'agent',
-            message: 'Which AI agent are you using?',
-            choices: ['claude', 'gemini', 'cursor', 'opencode', 'zed', 'generic'],
-        });
+    let agent = existingAgent;
+    if (!agent) {
+        let response;
+        try {
+            response = await prompt({
+                type: 'select',
+                name: 'agent',
+                message: 'Which AI agent are you using?',
+                choices: ['claude', 'gemini', 'cursor', 'opencode', 'zed', 'generic'],
+            });
+        }
+        catch (error) {
+            console.log(chalk_1.default.yellow('\nInitialization cancelled.'));
+            return;
+        }
+        agent = response.agent;
     }
-    catch (error) {
-        console.log(chalk_1.default.yellow('\nInitialization cancelled.'));
-        return;
+    // Create directories if they don't exist
+    if (!fs_1.default.existsSync(mspecDir)) {
+        fs_1.default.mkdirSync(path_1.default.join(mspecDir, 'specs'), { recursive: true });
+        fs_1.default.mkdirSync(path_1.default.join(mspecDir, 'tasks'), { recursive: true });
     }
-    const agent = response.agent;
-    // Create directories
-    fs_1.default.mkdirSync(path_1.default.join(mspecDir, 'specs'), { recursive: true });
-    fs_1.default.mkdirSync(path_1.default.join(mspecDir, 'tasks'), { recursive: true });
     // Write mspec.json config
     const mspecConfig = {
         agent,
@@ -41,7 +58,7 @@ async function initCommand() {
             tasks: '.mspec/tasks'
         }
     };
-    fs_1.default.writeFileSync(path_1.default.join(mspecDir, 'mspec.json'), JSON.stringify(mspecConfig, null, 2));
+    fs_1.default.writeFileSync(configPath, JSON.stringify(mspecConfig, null, 2));
     // Write agent integration files
     const agentTemplates = (0, templates_1.getTemplates)(agent);
     if (agentTemplates.length > 0) {
@@ -49,11 +66,11 @@ async function initCommand() {
             const targetDir = path_1.default.join(process.cwd(), template.dir);
             fs_1.default.mkdirSync(targetDir, { recursive: true });
             fs_1.default.writeFileSync(path_1.default.join(targetDir, template.file), template.content);
-            console.log(chalk_1.default.green(`Created integration file for ${agent} at ${path_1.default.join(template.dir, template.file)}`));
+            console.log(chalk_1.default.green(`Updated integration file for ${agent} at ${path_1.default.join(template.dir, template.file)}`));
         }
     }
     else {
         console.log(chalk_1.default.yellow(`No specific integration template found for ${agent}. Setup completed with generic settings.`));
     }
-    console.log(chalk_1.default.green('mspec initialized successfully!'));
+    console.log(chalk_1.default.green('mspec initialized/updated successfully!'));
 }

package/dist/commands/init.test.js

@@ -53,13 +53,26 @@ describe('initCommand', () => {
             }
         });
     });
-    it('should skip initialization if .mspec directory already exists', async () => {
+    it('should update integration files if .mspec directory already exists', async () => {
         const mspecDir = path_1.default.join(tmpDir, '.mspec');
         fs_1.default.mkdirSync(mspecDir);
+        fs_1.default.mkdirSync(path_1.default.join(mspecDir, 'specs'));
+        fs_1.default.mkdirSync(path_1.default.join(mspecDir, 'tasks'));
+        fs_1.default.writeFileSync(path_1.default.join(mspecDir, 'mspec.json'), JSON.stringify({ agent: 'cursor' }));
         const consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+        mockPrompt.mockRejectedValueOnce(new Error('Should not prompt'));
         await (0, init_1.initCommand)();
-        expect(fs_1.default.existsSync(path_1.default.join(mspecDir, 'specs'))).toBe(false);
-        expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Initialization skipped.'));
+        expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Existing .mspec directory found. Updating integration files...'));
+        expect(fs_1.default.existsSync(path_1.default.join(tmpDir, '.cursor/rules/mspec.spec.mdc'))).toBe(true);
+    });
+    it('should prompt if .mspec directory exists but mspec.json is missing or invalid', async () => {
+        const mspecDir = path_1.default.join(tmpDir, '.mspec');
+        fs_1.default.mkdirSync(mspecDir);
+        mockPrompt.mockResolvedValueOnce({ agent: 'gemini' });
+        const consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+        await (0, init_1.initCommand)();
+        expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Existing .mspec directory found. Updating integration files...'));
+        expect(fs_1.default.existsSync(path_1.default.join(tmpDir, '.gemini/commands/mspec.spec.toml'))).toBe(true);
     });
     it('should handle prompt cancellation gracefully', async () => {
         mockPrompt.mockRejectedValueOnce(new Error('User cancelled'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mspec",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "A minimalist Spec-Driven Development (SDD) toolkit for solo developers and AI agents",
   "main": "index.js",
   "scripts": {